macOS開発者セットアップ

OpenClaw macOSアプリケーションをソースからビルドして実行するために必要な手順を説明します。

前提条件

アプリをビルドする前に、以下がインストールされていることを確認してください：

Xcode 26.2以上：Swift開発に必要。
Node.js 24 & pnpm：Gateway、CLI、パッケージングスクリプトに推奨。互換性のためNode 22 LTS（現在22.16+）も引き続きサポート。

プロジェクト全体の依存関係をインストールします：

pnpm install

macOSアプリをビルドしてdist/OpenClaw.appにパッケージ化するには：

./scripts/package-mac-app.sh

Apple Developer ID証明書がない場合、スクリプトは自動的にアドホック署名（-）を使用します。

開発実行モード、署名フラグ、Team IDのトラブルシューティングについては、macOSアプリのREADMEを参照してください： https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

注意： アドホック署名されたアプリはセキュリティプロンプトが表示されることがあります。「Abort trap 6」で即座にクラッシュする場合は、トラブルシューティングセクションを参照してください。

macOSアプリはバックグラウンドタスクの管理にグローバルなopenclaw CLIインストールを必要とします。

インストール方法（推奨）：

手動でインストールする場合：

npm install -g openclaw@<version>

macOSアプリのビルドには最新のmacOS SDKとSwift 6.2ツールチェーンが必要です。

システム依存関係（必須）：

確認：

xcodebuild -version
xcrun swift --version

バージョンが一致しない場合は、macOS/Xcodeを更新してビルドを再実行してください。

音声認識やマイクのアクセスを許可しようとした際にアプリがクラッシュする場合、TCCキャッシュの破損や署名の不一致が原因の可能性があります。

修正方法：

TCCパーミッションをリセット：
```
tccutil reset All ai.openclaw.mac.debug
```
それでもダメな場合は、scripts/package-mac-app.sh内のBUNDLE_IDを一時的に変更して、macOSに「クリーンな状態」を強制してください。

Gatewayのステータスが「Starting…」のままの場合、ゾンビプロセスがポートを占有していないか確認してください：

openclaw gateway status
openclaw gateway stop

# LaunchAgentを使用していない場合（devモード/手動実行）、リスナーを確認：
lsof -nP -iTCP:18789 -sTCP:LISTEN

手動実行がポートを占有している場合は、そのプロセスを停止してください（Ctrl+C）。最終手段として、上記で見つかったPIDをkillしてください。