​

Gateway CLI

• /gateway/bonjour
• /gateway/discovery
• /gateway/configuration

​

Gateway を実行する

openclaw gateway

openclaw gateway run

• 既定では、gateway.mode=local が ~/.openclaw/openclaw.json に設定されていない限り、Gateway は起動を拒否します。アドホック／開発用途の実行には --allow-unconfigured を使用してください。 ad-hoc/dev runs には --allow-unconfigured を使用してください。 ad-hoc/dev runs には --allow-unconfigured を使用してください。
• 認証なしで loopback を超えてバインドすることはブロックされます（安全ガードレール）。
• SIGUSR1 は、認可されている場合にインプロセスの再起動をトリガーします（commands.restart を有効にするか、gateway ツール／config の apply/update を使用してください）。
• SIGINT/SIGTERM ハンドラーはゲートウェイプロセスを停止しますが、カスタムのターミナル状態は復元しません。TUI や raw モード入力で CLI をラップしている場合は、終了前にターミナルを復元してください。 CLI を TUI または raw-mode 入力でラップする場合は、ターミナルを終了する前に復元します。

​

オプション

• --port <port>: WebSocket ポート（既定値は config/env から取得。通常は 18789）。
• --bind <loopback|lan|tailnet|auto|custom>: リスナーのバインドモード。
• --auth <token|password>: 認証モードの上書き。
• --token <token>: トークンの上書き（プロセス用に OPENCLAW_GATEWAY_TOKEN も設定します）。
• --password <password>: パスワードの上書き（プロセス用に OPENCLAW_GATEWAY_PASSWORD も設定します）。
• --tailscale <off|serve|funnel>: Tailscale 経由で Gateway を公開します。
• --tailscale-reset-on-exit: シャットダウン時に Tailscale の serve/funnel 設定をリセットします。
• --allow-unconfigured: config に gateway.mode=local がなくても Gateway の起動を許可します。
• --dev: 不足している場合に dev 設定 + ワークスペースを作成します（BOOTSTRAP.md をスキップ）。
• --reset: dev 設定 + 資格情報 + セッション + ワークスペースをリセットします（--dev が必要）。
• --force: 起動前に選択したポートで既存のリスナーを終了します。
• --verbose: 詳細ログ。
• --claude-cli-logs: コンソールには claude-cli のログのみを表示します（stdout/stderr を有効化）。
• --ws-log <auto|full|compact>: websocket ログのスタイル（既定は auto）。
• --compact: --ws-log compact のエイリアス。
• --raw-stream: 生のモデルストリームイベントを jsonl に記録します。
• --raw-stream-path <path>: 生ストリーム jsonl のパス。

​

実行中の Gateway をクエリする

• 既定: 人間可読（TTY では色付き）。
• --json: 機械可読 JSON（スタイリング／スピナーなし）。
• --no-color（または NO_COLOR=1）: 人間向けレイアウトを維持したまま ANSI を無効化。

• --url <url>: Gateway の WebSocket URL。
• --token <token>: Gateway トークン。
• --password <password>: Gateway パスワード。
• --timeout <ms>: タイムアウト／バジェット（コマンドごとに異なります）。
• --expect-final: 「final」レスポンスを待機します（エージェント呼び出し）。

​

gateway health

openclaw gateway health --url ws://127.0.0.1:18789

​

gateway status

openclaw gateway status
openclaw gateway status --json

• --url <url>: プローブ URL を上書きします。
• --token <token>: プローブ用のトークン認証。
• --password <password>: プローブ用のパスワード認証。
• --timeout <ms>: プローブのタイムアウト（既定は 10000）。
• --no-probe: RPC プローブをスキップします（サービスのみ表示）。
• --deep: システムレベルのサービスもスキャンします。

​

gateway probe

• 設定されているリモートゲートウェイ（設定されている場合）、および
• localhost（loopback）。リモートが設定されていても実行されます。

openclaw gateway probe
openclaw gateway probe --json

​

SSH 経由のリモート接続（Mac アプリとの同等性）

openclaw gateway probe --ssh user@gateway-host

• --ssh <target>: user@host または user@host:port（ポートの既定は 22）。
• --ssh-identity <path>: identity ファイル。
• --ssh-auto: 検出された最初の Gateway ホストを SSH の接続先として選択します（LAN/WAB のみ）。

• gateway.remote.sshTarget
• gateway.remote.sshIdentity

​

gateway call <method>

openclaw gateway call status
openclaw gateway call logs.tail --params '{"sinceMs": 60000}'

​

Gateway サービスを管理する

openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway uninstall

• gateway install は --port、--runtime、--token、--force、--json をサポートします。
• ライフサイクルコマンドは、スクリプト向けに --json を受け付けます。

​

ゲートウェイを検出する（Bonjour）

• マルチキャスト DNS-SD: local.
• ユニキャスト DNS-SD（Wide-Area Bonjour）: ドメインを選択（例: openclaw.internal.）し、スプリット DNS + DNS サーバーを設定してください。/gateway/bonjour を参照してください。

• role（ゲートウェイの役割ヒント）
• transport（トランスポートのヒント。例: gateway）
• gatewayPort（WebSocket ポート。通常は 18789）
• sshPort（SSH ポート。未指定の場合の既定は 22）
• tailnetDns（利用可能な場合の MagicDNS ホスト名）
• gatewayTls / gatewayTlsSha256（TLS 有効化 + 証明書フィンガープリント）
• cliPath（リモートインストール向けの任意ヒント）

​

gateway discover

openclaw gateway discover

• --timeout <ms>: コマンドごとのタイムアウト（browse/resolve）。既定は 2000。
• --json: 機械可読な出力（スタイリング／スピナーも無効化）。

openclaw gateway discover --timeout 4000
openclaw gateway discover --json | jq '.beacons[].wsUrl'