macOS Dev Setup

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

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

1. Xcode 26.2+：Swift 開発に必要です。

2. Node.js 22+ & pnpm：Gateway、CLI、およびパッケージ化スクリプトに必要です。

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

pnpm install

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

./scripts/package-mac-app.sh

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

開発実行モード、署名フラグ、およびチーム ID のトラブルシューティングについては、macOS アプリケーションの README を参照してください：

https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md

macOS アプリケーションは、バックグラウンドタスクを管理するためにグローバル ''openclaw'' CLI のインストールを期待しています。

インストールするには（推奨）：

1. OpenClaw アプリケーションを開きます。

2. 全般設定タブに移動します。

3. "CLI をインストール"をクリックします。

または、手動でインストールします：

npm install -g openclaw@'<version>'

#

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

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

- ソフトウェアアップデートで利用可能な最新の macOS バージョン（Xcode 26.2 SDK で必要）

- Xcode 26.2（Swift 6.2 ツールチェーン）

チェック：

xcodebuild -version
xcrun swift --version

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

#

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

Fix:

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

bash
tccutil reset All bot.molt.mac.debug
bash

2. それが失敗する場合は、''''scripts/package-mac-app.sh'''' で ''scripts/package-mac-app.sh'' を一時的に変更して、macOS からクリーンな状態を強制します。

#

Gateway のステータスが "起動中..." のままの場合、ゾンビプロセスがポートを保持しているかどうかを確認します：

openclaw gateway status
openclaw gateway stop

lsof -nP -iTCP:18789 -sTCP:LISTEN

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