macOS 開発環境のセットアップ

OpenClaw macOS アプリケーションをソースからビルドして実行します。

前提条件

• Xcode 26.2 以降（Swift 6.2 ツールチェーン）。Software Update で入手できる最新の macOS 上で使用してください。
• Gateway、CLI、パッケージングスクリプト用の Node.js 24 と pnpm。Node 22.19 以降も動作します。

1. 依存関係をインストールする

pnpm install

2. アプリをビルドしてパッケージ化する

./scripts/package-mac-app.sh

dist/OpenClaw.app が出力されます。Apple Developer ID 証明書がない場合、スクリプトはアドホック署名にフォールバックします。

開発実行モード、署名フラグ、Team ID のトラブルシューティングについては、apps/macos/README.mdを参照してください。 リポジトリルートからの高速な開発ループには scripts/restart-mac.sh を使用します（アドホック署名には --no-sign を追加します。ただし、--no-sign を使用すると TCC 権限は保持されません）。

3. CLI と Gateway をインストールする

パッケージ化されたアプリには、正式な scripts/install-cli.sh インストーラーが組み込まれています。新しいプロファイルでは、オンボーディング中に This Mac を選択してください。アプリは Gateway ウィザードを開始する前に、対応するユーザー領域の CLI とランタイムをインストールします。

開発中に手動で復旧する場合は、対応する CLI を自分でインストールします。

npm install -g openclaw@<version>

pnpm add -g openclaw@<version> と bun add -g openclaw@<version> も使用できます。Gateway 自体の推奨ランタイムは引き続き Node です。

トラブルシューティング

ビルドに失敗する：ツールチェーンまたは SDK の不一致

macOS アプリのビルドには、最新の macOS SDK と Swift 6.2 ツールチェーン（Xcode 26.2 以降）が必要です。

xcodebuild -versionxcrun swift --version

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

権限の付与時にアプリがクラッシュする

Speech Recognition または Microphone へのアクセスを許可しようとしたときにアプリがクラッシュする場合、TCC キャッシュの破損または署名の不一致が原因である可能性があります。

1. デバッグ用バンドル ID の TCC 権限をリセットします。

   tccutil reset All ai.openclaw.mac.debug

2. 失敗する場合は、macOS 上でクリーンな状態を強制するために、scripts/package-mac-app.shの BUNDLE_ID を一時的に変更します。

Gateway が「Starting...」のまま進まない

ゾンビプロセスがポートを保持していないか確認します。

openclaw gateway statusopenclaw gateway stop # LaunchAgent を使用していない場合（開発モード／手動実行）、リスナーを探します。lsof -nP -iTCP:18789 -sTCP:LISTEN

手動実行したプロセスがポートを保持している場合は、そのプロセスを停止（Ctrl+C）するか、最後の手段として上記で見つかった PID を強制終了します。

関連項目

• macOS アプリ
• インストールの概要