macOSでOpenClaw Gatewayを構築：launchd設定とCLI導入ガイド

開発ツールをバックグラウンドで安定して動かし続けるのは、意外と面倒な作業ですよね。macOSでプロセスが勝手に終了してしまったり、手動で何度も起動し直したりするのは、開発のリズムを崩す原因になります。

OpenClaw.app では、Node/Bun や Gateway ランタイムをアプリ本体に同梱しなくなりました。現在の macOS アプリは、外部にインストールされた openclaw CLI を使用します。Gateway を子プロセスとして直接起動するのではなく、ユーザーごとの launchd サービスを管理することで、Gateway の常時稼働を実現しています（既にローカルで Gateway が動作している場合は、そちらに接続します）。

CLIのインストール（ローカルモードに必須）

Mac では Node 24 がデフォルトのランタイムですが、互換性のために Node 22 LTS（現在は 22.14+）も引き続き利用可能です。まず、以下のコマンドで openclaw をグローバルにインストールしてください。

npm install -g openclaw@<version>

macOS アプリ内にある Install CLI ボタンからも、npm や pnpm を経由して同じフローを実行できます（Gateway のランタイムとして bun は推奨されません）。

Launchd (LaunchAgentとしてのGateway)

Gateway の管理には以下の設定が使用されます。

ラベル:

ai.openclaw.gateway （または ai.openclaw.<profile>。古い形式の com.openclaw.* が残っている場合もあります）

Plist の保存場所（ユーザー単位）:

~/Library/LaunchAgents/ai.openclaw.gateway.plist
~/Library/LaunchAgents/ai.openclaw.<profile>.plist

管理方法:

ローカルモードでは、macOS アプリが LaunchAgent のインストールや更新を管理します。
CLI からもインストール可能です： openclaw gateway install

動作の仕組み:

「OpenClaw Active」の設定によって LaunchAgent の有効・無効が切り替わります。
アプリを終了しても Gateway は停止しません（launchd がプロセスを維持します）。
設定されたポートで既に Gateway が動作している場合、アプリは新しいプロセスを起動せずに既存の Gateway へ接続します。

ログの出力先:

launchd stdout/err: /tmp/openclaw/openclaw-gateway.log

バージョンの互換性

macOS アプリは、Gateway のバージョンと自身のバージョンが一致しているかチェックします。もし互換性がないというメッセージが表示された場合は、グローバルにインストールされている CLI をアプリのバージョンに合わせて更新してください。

動作確認（Smoke check）

正しく設定できているか、以下のコマンドで確認してみましょう。

openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback

次に、別のターミナルで以下のコマンドを実行して応答を確認します。

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

AI Setup Assistant

次のステップ

OpenClaw Expert

まだ解決しませんか？

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