OpenClaw macOS版ビルドガイド：ソースから5分で構築

新しいプロジェクトを自分のマシンで動かそうとするとき、環境構築でつまずくのは本当にストレスですよね。特に Swift と Node.js が混在するプロジェクトでは、ツールのバージョン合わせに苦労することも少なくありません。

この記事では、OpenClaw の macOS アプリケーションをソースからビルドして実行するための手順を分かりやすく解説します。スムーズに開発を始められるよう、最適な方法をまとめました。

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

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

前提条件

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

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

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

Note: Ad-hoc 署名されたアプリは、セキュリティの警告が表示されることがあります。アプリが起動直後に “Abort trap 6” でクラッシュする場合は、トラブルシューティングセクションを確認してください。

3. CLI のインストール

macOS アプリは、バックグラウンドタスクを管理するために openclaw CLI がグローバルにインストールされていることを前提としています。

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

OpenClaw アプリを開きます。
General 設定タブに移動します。
“Install CLI” をクリックします。

または、手動でインストールすることも可能です。

npm install -g openclaw@<version>

トラブルシューティング

ビルドの失敗: Toolchain または SDK の不一致

macOS アプリのビルドには、最新の macOS SDK と Swift 6.2 toolchain が必要です。

システム要件（必須）:

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

確認コマンド:

xcodebuild -version
xcrun swift --version

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

権限許可時のアプリクラッシュ

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

解決策:

TCC 権限をリセットします。
Terminal window
```
tccutil reset All ai.openclaw.mac.debug
```
それでも解決しない場合は、scripts/package-mac-app.sh 内の BUNDLE_ID を一時的に変更し、macOS に新しいアプリとして認識させてください。

Gateway が “Starting…” のまま進まない

Gateway のステータスが “Starting…” から変わらない場合は、ゾンビプロセスがポートを占有していないか確認してください。

openclaw gateway status
openclaw 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 を終了させます。

次のステップ

セットアップ中に困ったことがあれば、AI Setup Assistant に聞いてみてくださいね。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。