OpenClawSkills
GitHub
プラットフォーム • 5分で読める

Gateway on macOS

Gateway runtime on macOS (external launchd service)

OpenClaw.app は Node/Bun または Gateway ランタイムをバンドルしなくなりました。macOS アプリは

''外部''の ''openclaw'' CLI インストールを期待し、子プロセスとして

Gateway を起動せず、Gateway を維持するためにユーザーごとの launchd サービスを管理します

(既に実行中のローカル Gateway がある場合は、それにアタッチします)。

Tutorial.step

CLI のインストール(ローカルモードに必要)

Mac に Node 22+ が必要で、''openclaw'' をグローバルにインストールします:

Bash
npm install -g openclaw@'<version>'

macOS アプリのCLI をインストールボタンは、npm/pnpm 経由で同じフローを実行します(bun は Gateway ランタイムとして推奨されません)。

Tutorial.step

Launchd(Gateway を LaunchAgent として)

ラベル:

- ''bot.molt.gateway'' (or ''bot.molt.<profile>''; legacy ''com.openclaw.*'' may remain)

Plist の場所(ユーザーごと):

- ''~/Library/LaunchAgents/bot.molt.gateway.plist''

(or ''~/Library/LaunchAgents/bot.molt.<profile>.plist'')

マネージャー:

- macOS アプリはローカルモードで LaunchAgent のインストール/更新を所有します。

- CLI もインストールできます:''openclaw gateway install''。

Behavior:

- "OpenClaw Active" は LaunchAgent を有効化/無効化します。

- アプリの終了は gateway を停止しません(launchd が実行を維持します)。

- Gateway が既に設定されたポートで実行されている場合、アプリは新しいものを

起動する代わりにそれにアタッチします。

ログ:

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

Tutorial.step

バージョンの互換性

macOS アプリは独自のバージョンに対して gateway バージョンをチェックします。それらが

互換性がない場合、アプリバージョンに一致するようにグローバル CLI を更新してください。

Tutorial.step

スモークテスト

Bash
openclaw --version

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

その後:

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