macOS 開発者セットアップ

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

前提条件

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

1. Xcode 26.2+: Swift 開発に必要です。
2. Node.js 24 & pnpm: Gateway、CLI、パッケージングスクリプトに推奨されます。Node 22 LTS（現在は 22.19+）も互換性のため引き続きサポートされます。

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

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

pnpm install

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

macOS アプリをビルドし、dist/OpenClaw.app にパッケージ化するには、次を実行します。

./scripts/package-mac-app.sh

Apple Developer ID 証明書がない場合、スクリプトは自動的に ad-hoc signing（-）を使用します。

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

注記: ad-hoc 署名されたアプリでは、セキュリティプロンプトが表示されることがあります。アプリがすぐに "Abort trap 6" でクラッシュする場合は、トラブルシューティング セクションを参照してください。

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 ツールチェーンが想定されています。

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

• Software Update で利用可能な最新の macOS バージョン（Xcode 26.2 SDK に必要）
• Xcode 26.2（Swift 6.2 ツールチェーン）

確認:

xcodebuild -versionxcrun swift --version

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

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

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

修正:

1. TCC 権限をリセットします。

   tccutil reset All ai.openclaw.mac.debug

2. それでも失敗する場合は、macOS から「クリーンスレート」を強制するために、scripts/package-mac-app.sh の BUNDLE_ID を一時的に変更します。

Gateway が "Starting..." のままになる

Gateway のステータスが "Starting..." のままの場合は、ゾンビプロセスがポートを保持していないか確認してください。

openclaw gateway statusopenclaw gateway stop # If you're not using a LaunchAgent (dev mode / manual runs), find the listener:lsof -nP -iTCP:18789 -sTCP:LISTEN

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

関連

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