CLIリファレンス

このページでは現在のCLIの動作を説明します。コマンドが変更された場合、このドキュメントを更新してください。

コマンドページ

setup
onboard
configure
config
completion
doctor
dashboard
backup
reset
uninstall
update
message
agent
agents
acp
status
health
sessions
gateway
logs
system
models
memory
directory
nodes
devices
node
approvals
sandbox
tui
browser
cron
dns
docs
hooks
webhooks
pairing
qr
plugins（プラグインコマンド）
channels
security
secrets
skills
daemon（Gatewayサービスコマンドのレガシーエイリアス）
clawbot（レガシーエイリアス名前空間）
voicecall（プラグイン。インストール済みの場合）

グローバルフラグ

--dev: 状態を~/.openclaw-devに分離し、デフォルトポートをシフト。
--profile <name>: 状態を~/.openclaw-<name>に分離。
--no-color: ANSIカラーを無効化。
--update: openclaw updateのショートハンド（ソースインストールのみ）。
-V, --version, -v: バージョンを表示して終了。

出力スタイリング

ANSIカラーとプログレスインジケーターはTTYセッションでのみ描画されます。
OSC-8ハイパーリンクは対応ターミナルでクリック可能なリンクとして描画され、非対応の場合はプレーンURLにフォールバックします。
--json（および対応している場合--plain）はスタイリングを無効化してクリーンな出力を提供します。
--no-colorはANSIスタイリングを無効化。NO_COLOR=1も尊重されます。
長時間実行コマンドはプログレスインジケーター（対応時はOSC 9;4）を表示します。

カラーパレット

OpenClawはCLI出力にロブスターパレットを使用します。

accent (#FF5A2D): 見出し、ラベル、主要ハイライト。
accentBright (#FF7A3D): コマンド名、強調。
accentDim (#D14A22): 二次ハイライトテキスト。
info (#FF8A5B): 情報値。
success (#2FBF71): 成功状態。
warn (#FFB020): 警告、フォールバック、注意。
error (#E23D2D): エラー、失敗。
muted (#8B7F77): 控えめな表示、メタデータ。

パレットの情報源: src/terminal/palette.ts（通称「lobster seam」）。

コマンドツリー

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    migrate
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  directory
  skills
    list
    info
    check
  plugins
    list
    info
    install
    enable
    disable
    doctor
  memory
    status
    index
    search
  message
  agent
  agents
    list
    add
    delete
  acp
  status
  health
  sessions
  gateway
    call
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
  devices
  node
    run
    status
    install
    uninstall
    start
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    status
    start
    stop
    reset-profile
    tabs
    open
    focus
    close
    profiles
    create-profile
    delete-profile
    screenshot
    snapshot
    navigate
    resize
    click
    type
    press
    hover
    drag
    select
    upload
    fill
    dialog
    wait
    evaluate
    console
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

補足：プラグインは追加のトップレベルコマンドを追加できます（例：openclaw voicecall）。

セキュリティ

openclaw security audit — 設定 + ローカル状態に対するよくあるセキュリティ上の問題を監査。
openclaw security audit --deep — ベストエフォートのライブGatewayプローブ。
openclaw security audit --fix — 安全なデフォルトを強化し、状態/設定のchmodを実行。

シークレット

openclaw secrets reload — 参照を再解決し、ランタイムスナップショットをアトミックにスワップ。
openclaw secrets audit — 平文の残留、未解決の参照、優先順位のドリフトをスキャン。
openclaw secrets configure — プロバイダーセットアップ + SecretRefマッピング + プリフライト/適用の対話型ヘルパー。
openclaw secrets apply --from <plan.json> — 事前に生成されたプランを適用（--dry-run対応）。

プラグイン

拡張機能とその設定を管理：

openclaw plugins list — プラグインを検出（機械出力には--jsonを使用）。
openclaw plugins info <id> — プラグインの詳細を表示。
openclaw plugins install <path|.tgz|npm-spec> — プラグインをインストール（またはプラグインパスをplugins.load.pathsに追加）。
openclaw plugins enable <id> / disable <id> — plugins.entries.<id>.enabledを切り替え。
openclaw plugins doctor — プラグインのロードエラーを報告。

ほとんどのプラグイン変更にはGatewayの再起動が必要です。/pluginを参照。

メモリ

MEMORY.md + memory/*.mdに対するベクトル検索：

openclaw memory status — インデックス統計を表示。
openclaw memory index — メモリファイルを再インデックス。
openclaw memory search "<query>"（または--query "<query>"） — メモリに対するセマンティック検索。

チャットスラッシュコマンド

チャットメッセージは/...コマンド（テキストおよびネイティブ）をサポートします。/tools/slash-commandsを参照。

主なコマンド：

/status で簡易診断。
/config で永続化される設定変更。
/debug でランタイムのみの設定オーバーライド（メモリ上のみ、ディスクには書き込まず。commands.debug: trueが必要）。

セットアップ + オンボーディング

`setup`

設定 + ワークスペースを初期化します。

オプション：

--workspace <dir>: エージェントワークスペースパス（デフォルト~/.openclaw/workspace）。
--wizard: オンボーディングウィザードを実行。
--non-interactive: プロンプトなしでウィザードを実行。
--mode <local|remote>: ウィザードモード。
--remote-url <url>: リモートGateway URL。
--remote-token <token>: リモートGatewayトークン。

ウィザードフラグ（--non-interactive、--mode、--remote-url、--remote-token）がある場合、ウィザードは自動実行されます。

`onboard`

Gateway、ワークスペース、スキルをセットアップする対話型ウィザードです。

オプション：

--workspace <dir>
--reset（ウィザード前に設定 + 認証情報 + セッションをリセット）
--reset-scope <config|config+creds+sessions|full>（デフォルトconfig+creds+sessions。ワークスペースも削除するにはfullを使用）
--non-interactive
--mode <local|remote>
--flow <quickstart|advanced|manual>（manualはadvancedのエイリアス）
--auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ollama|ai-gateway-api-key|moonshot-api-key|moonshot-api-key-cn|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|mistral-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|opencode-go|custom-api-key|skip>
--token-provider <id>（非対話型。--auth-choice tokenと併用）
--token <token>（非対話型。--auth-choice tokenと併用）
--token-profile-id <id>（非対話型。デフォルト: <provider>:manual）
--token-expires-in <duration>（非対話型。例：365d、12h）
--secret-input-mode <plaintext|ref>（デフォルトplaintext。平文キーの代わりにプロバイダーデフォルトのenv refを保存するにはrefを使用）
--anthropic-api-key <key>
--openai-api-key <key>
--mistral-api-key <key>
--openrouter-api-key <key>
--ai-gateway-api-key <key>
--moonshot-api-key <key>
--kimi-code-api-key <key>
--gemini-api-key <key>
--zai-api-key <key>
--minimax-api-key <key>
--opencode-zen-api-key <key>
--opencode-go-api-key <key>
--custom-base-url <url>（非対話型。--auth-choice custom-api-keyまたは--auth-choice ollamaと併用）
--custom-model-id <id>（非対話型。--auth-choice custom-api-keyまたは--auth-choice ollamaと併用）
--custom-api-key <key>（非対話型。オプション。--auth-choice custom-api-keyと併用。省略時はCUSTOM_API_KEYにフォールバック）
--custom-provider-id <id>（非対話型。オプションのカスタムプロバイダーID）
--custom-compatibility <openai|anthropic>（非対話型。オプション。デフォルトopenai）
--gateway-port <port>
--gateway-bind <loopback|lan|tailnet|auto|custom>
--gateway-auth <token|password>
--gateway-token <token>
--gateway-token-ref-env <name>（非対話型。gateway.auth.tokenをenv SecretRefとして保存。その環境変数が設定されている必要あり。--gateway-tokenとは併用不可）
--gateway-password <password>
--remote-url <url>
--remote-token <token>
--tailscale <off|serve|funnel>
--tailscale-reset-on-exit
--install-daemon
--no-install-daemon（エイリアス: --skip-daemon）
--daemon-runtime <node|bun>
--skip-channels
--skip-skills
--skip-health
--skip-ui
--node-manager <npm|pnpm|bun>（pnpm推奨。bunはGatewayランタイムには非推奨）
--json

`configure`

対話型設定ウィザード（モデル、チャネル、スキル、Gateway）。

`config`

非対話型設定ヘルパー（get/set/unset/file/validate）。openclaw configをサブコマンドなしで実行するとウィザードが起動します。

サブコマンド：

config get <path>: 設定値を表示（ドット/ブラケットパス）。
config set <path> <value>: 値を設定（JSON5または生文字列）。
config unset <path>: 値を削除。
config file: アクティブな設定ファイルパスを表示。
config validate: Gatewayを起動せずにスキーマに対して現在の設定を検証。
config validate --json: 機械可読なJSON出力。

`doctor`

ヘルスチェック + クイックフィックス（設定 + Gateway + レガシーサービス）。

オプション：

--no-workspace-suggestions: ワークスペースメモリのヒントを無効化。
--yes: プロンプトなしでデフォルトを受け入れ（ヘッドレス）。
--non-interactive: プロンプトをスキップ。安全な移行のみ適用。
--deep: システムサービスをスキャンして追加のGatewayインストールを検出。

チャネルヘルパー

`channels`

チャットチャネルアカウント（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost（プラグイン）/Signal/iMessage/MS Teams）を管理します。

サブコマンド：

channels list: 設定済みチャネルと認証プロファイルを表示。
channels status: Gatewayの到達可能性とチャネルヘルスを確認（--probeで追加チェック。Gatewayヘルスプローブにはopenclaw healthまたはopenclaw status --deepを使用）。
ヒント：channels statusはよくある設定ミスを検出できる場合に修正候補付きの警告を出力します（その後openclaw doctorを案内）。
channels logs: Gatewayログファイルから最近のチャネルログを表示。
channels add: フラグなしの場合はウィザード形式のセットアップ。フラグを指定すると非対話モード。
- シングルアカウントのトップレベル設定をまだ使用しているチャネルにデフォルト以外のアカウントを追加する場合、OpenClawはアカウントスコープの値をchannels.<channel>.accounts.defaultに移動してから新しいアカウントを書き込みます。
- 非対話型のchannels addはバインディングを自動作成/アップグレードしません。チャネルのみのバインディングは引き続きデフォルトアカウントにマッチします。
channels remove: デフォルトで無効化。プロンプトなしで設定エントリを削除するには--deleteを渡します。
channels login: 対話型チャネルログイン（WhatsApp Webのみ）。
channels logout: チャネルセッションからログアウト（サポートされている場合）。

共通オプション：

--channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
--account <id>: チャネルアカウントID（デフォルトdefault）
--name <label>: アカウントの表示名

channels loginオプション：

--channel <channel>（デフォルトwhatsapp。whatsapp/webをサポート）
--account <id>
--verbose

channels logoutオプション：

--channel <channel>（デフォルトwhatsapp）
--account <id>

channels listオプション：

--no-usage: モデルプロバイダーの使用量/クォータスナップショットをスキップ（OAuth/APIベースのみ）。
--json: JSON出力（--no-usageが設定されていない限り使用量を含む）。

channels logsオプション：

--channel <name|all>（デフォルトall）
--lines <n>（デフォルト200）
--json

詳細: /concepts/oauth

例：

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep

`skills`

利用可能なスキルと準備状態情報を一覧・検査します。

サブコマンド：

skills list: スキルの一覧（サブコマンドなしの場合のデフォルト）。
skills info <name>: 1つのスキルの詳細を表示。
skills check: 準備完了 vs 不足要件の概要。

オプション：

--eligible: 準備完了のスキルのみ表示。
--json: JSON出力（スタイリングなし）。
-v, --verbose: 不足要件の詳細を含む。

ヒント：npx clawhubでスキルの検索、インストール、同期ができます。

`pairing`

チャネル間のDMペアリングリクエストを承認します。

サブコマンド：

pairing list [channel] [--channel <channel>] [--account <id>] [--json]
pairing approve <channel> <code> [--account <id>] [--notify]
pairing approve --channel <channel> [--account <id>] <code> [--notify]

`devices`

Gatewayデバイスペアリングエントリとロール別デバイストークンを管理します。

サブコマンド：

devices list [--json]
devices approve [requestId] [--latest]
devices reject <requestId>
devices remove <deviceId>
devices clear --yes [--pending]
devices rotate --device <id> --role <role> [--scope <scope...>]
devices revoke --device <id> --role <role>

`webhooks gmail`

Gmail Pub/Subフックのセットアップ + ランナー。/automation/gmail-pubsubを参照。

サブコマンド：

webhooks gmail setup（--account <email>が必須。--project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --jsonをサポート）
webhooks gmail run（同じフラグのランタイムオーバーライド）

`dns setup`

広域ディスカバリーDNSヘルパー（CoreDNS + Tailscale）。/gateway/discoveryを参照。

オプション：

--apply: CoreDNS設定をインストール/更新（sudo必須。macOSのみ）。

メッセージング + エージェント

`message`

統合送信メッセージ + チャネルアクション。

参照：/cli/message

サブコマンド：

message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
message thread <create|list|reply>
message emoji <list|upload>
message sticker <send|upload>
message role <info|add|remove>
message channel <info|list>
message member info
message voice status
message event <list|create>

例：

openclaw message send --target +15555550123 --message "Hi"
openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

`agent`

Gateway経由で1回のエージェントターンを実行（または--localで組み込み）。

必須：

--message <text>

オプション：

--to <dest>（セッションキーおよびオプションの配信用）
--session-id <id>
--thinking <off|minimal|low|medium|high|xhigh>（GPT-5.2 + Codexモデルのみ）
--verbose <on|full|off>
--channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
--local
--deliver
--json
--timeout <seconds>

`agents`

分離されたエージェント（ワークスペース + 認証 + ルーティング）を管理します。

`agents list`

設定済みエージェントの一覧。

オプション：

--json
--bindings

`agents add [name]`

新しい分離エージェントを追加。フラグ（または--non-interactive）が渡されない限りガイドウィザードを実行。非対話モードでは--workspaceが必須。

オプション：

--workspace <dir>
--model <id>
--agent-dir <dir>
--bind <channel[:accountId]>（繰り返し可）
--non-interactive
--json

バインディング仕様はchannel[:accountId]形式です。accountIdを省略すると、OpenClawはチャネルデフォルト/プラグインフック経由でアカウントスコープを解決する場合があります。省略された場合は明示的なアカウントスコープなしのチャネルバインディングになります。

`agents bindings`

ルーティングバインディングの一覧。

オプション：

--agent <id>
--json

`agents bind`

エージェントにルーティングバインディングを追加。

オプション：

--agent <id>
--bind <channel[:accountId]>（繰り返し可）
--json

`agents unbind`

エージェントからルーティングバインディングを削除。

オプション：

--agent <id>
--bind <channel[:accountId]>（繰り返し可）
--all
--json

`agents delete <id>`

エージェントを削除し、ワークスペース + 状態をプルーニング。

オプション：

--force
--json

`acp`

IDEをGatewayに接続するACPブリッジを実行。

全オプションと例はacpを参照。

`status`

リンクされたセッションのヘルスと最近の受信者を表示。

オプション：

--json
--all（完全な診断。読み取り専用、貼り付け可能）
--deep（チャネルをプローブ）
--usage（モデルプロバイダーの使用量/クォータを表示）
--timeout <ms>
--verbose
--debug（--verboseのエイリアス）

補足：

概要にはGateway + Nodeホストサービスのステータスが利用可能な場合に含まれます。

使用量トラッキング

OAuth/API認証情報が利用可能な場合、OpenClawはプロバイダーの使用量/クォータを表示できます。

表示先：

/status（利用可能な場合にプロバイダー使用量の短い行を追加）
openclaw status --usage（完全なプロバイダー内訳を表示）
macOSメニューバー（Context下のUsageセクション）

補足：

データはプロバイダーの使用量エンドポイントから直接取得（推定値ではありません）。
プロバイダー：Anthropic、GitHub Copilot、OpenAI Codex OAuth、およびGemini CLI/Antigravity（それらのプロバイダープラグインが有効な場合）。
一致する認証情報がない場合、使用量は非表示。
詳細：Usage trackingを参照。

`health`

実行中のGatewayからヘルスを取得。

オプション：

--json
--timeout <ms>
--verbose

`sessions`

保存済みの会話セッションを一覧表示。

オプション：

--json
--verbose
--store <path>
--active <minutes>

リセット / アンインストール

`reset`

ローカル設定/状態をリセット（CLIはインストールされたまま）。

オプション：

--scope <config|config+creds+sessions|full>
--yes
--non-interactive
--dry-run

補足：

--non-interactiveには--scopeと--yesが必要。

`uninstall`

Gatewayサービス + ローカルデータをアンインストール（CLIは残る）。

オプション：

--service
--state
--workspace
--app
--all
--yes
--non-interactive
--dry-run

補足：

--non-interactiveには--yesと明示的なスコープ（または--all）が必要。

Gateway

`gateway`

WebSocket Gatewayを実行。

オプション：

--port <port>
--bind <loopback|tailnet|lan|auto|custom>
--token <token>
--auth <token|password>
--password <password>
--password-file <path>
--tailscale <off|serve|funnel>
--tailscale-reset-on-exit
--allow-unconfigured
--dev
--reset（dev設定 + 認証情報 + セッション + ワークスペースをリセット）
--force（ポートの既存リスナーを強制終了）
--verbose
--claude-cli-logs
--ws-log <auto|full|compact>
--compact（--ws-log compactのエイリアス）
--raw-stream
--raw-stream-path <path>

`gateway service`

Gatewayサービス（launchd/systemd/schtasks）を管理。

サブコマンド：

gateway status（デフォルトでGateway RPCをプローブ）
gateway install（サービスインストール）
gateway uninstall
gateway start
gateway stop
gateway restart

補足：

gateway statusはデフォルトでサービスの解決済みポート/設定を使用してGateway RPCをプローブ（--url/--token/--passwordでオーバーライド）。
gateway statusはスクリプティング用に--no-probe、--deep、--jsonをサポート。
gateway statusはレガシーまたは追加のGatewayサービスを検出できる場合に表示（--deepでシステムレベルスキャンを追加）。プロファイル名付きのOpenClawサービスはファーストクラスとして扱われ、「extra」としてフラグ付けされません。
gateway statusはCLIが使用する設定パスとサービスが使用する可能性の高い設定（サービスenv）、および解決済みのプローブターゲットURLを表示。
Linuxのsystemdインストールでは、statusのトークンドリフトチェックがユニットからEnvironment=とEnvironmentFile=の値を読み取ります（%h、引用符付きパス、複数ファイル、オプションの-ファイルを含む）。
gateway install|uninstall|start|stop|restartはスクリプティング用に--jsonをサポート（デフォルト出力は人間可読のまま）。
gateway installはデフォルトでNodeランタイム。bunは非推奨（WhatsApp/Telegramのバグ）。
gateway installオプション: --port, --runtime, --token, --force, --json。

`logs`

RPC経由でGatewayファイルログをテール。

補足：

TTYセッションではカラー付きの構造化ビューを描画。非TTYではプレーンテキストにフォールバック。
--jsonは行区切りJSON（1行につき1ログイベント）を出力。

例：

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

`gateway <subcommand>`

Gateway CLIヘルパー（RPCサブコマンドには--url, --token, --password, --timeout, --expect-finalを使用）。 --urlを渡すと、CLIは設定や環境の認証情報を自動適用しません。 --tokenまたは--passwordを明示的に含めてください。明示的な認証情報がない場合はエラーになります。

サブコマンド：

gateway call <method> [--params <json>]
gateway health
gateway status
gateway probe
gateway discover
gateway install|uninstall|start|stop|restart
gateway run

よく使うRPC：

config.apply（設定の検証 + 書き込み + 再起動 + ウェイク）
config.patch（部分更新のマージ + 再起動 + ウェイク）
update.run（更新実行 + 再起動 + ウェイク）

ヒント：config.set/config.apply/config.patchを直接呼び出す場合、設定が既に存在するならconfig.getからbaseHashを渡してください。

モデル

フォールバック動作とスキャン戦略は/concepts/modelsを参照。

Anthropic setup-token（サポート）：

claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models status

ポリシーに関する補足：これは技術的な互換性です。AnthropicはClaude Code以外でのサブスクリプション使用をブロックした実績があります。本番環境でsetup-tokenに依存する前に、現在のAnthropicの利用規約を確認してください。

`models`（ルート）

openclaw modelsはmodels statusのエイリアスです。

ルートオプション：

--status-json（models status --jsonのエイリアス）
--status-plain（models status --plainのエイリアス）

`models list`

オプション：

--all
--local
--provider <name>
--json
--plain

`models status`

オプション：

--json
--plain
--check（終了コード 1=期限切れ/不足、2=期限切れ間近）
--probe（設定済み認証プロファイルのライブプローブ）
--probe-provider <name>
--probe-profile <id>（繰り返しまたはカンマ区切り）
--probe-timeout <ms>
--probe-concurrency <n>
--probe-max-tokens <n>

認証ストアのプロファイルの認証概要とOAuth有効期限ステータスを常に含みます。 --probeはライブリクエストを実行します（トークンを消費し、レート制限をトリガーする場合があります）。

`models set <model>`

agents.defaults.model.primaryを設定。

`models set-image <model>`

agents.defaults.imageModel.primaryを設定。

`models aliases list|add|remove`

オプション：

list: --json, --plain
add <alias> <model>
remove <alias>

`models fallbacks list|add|remove|clear`

オプション：

list: --json, --plain
add <model>
remove <model>
clear

`models image-fallbacks list|add|remove|clear`

オプション：

list: --json, --plain
add <model>
remove <model>
clear

`models scan`

オプション：

--min-params <b>
--max-age-days <days>
--provider <name>
--max-candidates <n>
--timeout <ms>
--concurrency <n>
--no-probe
--yes
--no-input
--set-default
--set-image
--json

`models auth add|setup-token|paste-token`

オプション：

add: 対話型認証ヘルパー
setup-token: --provider <name>（デフォルトanthropic）、--yes
paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

`models auth order get|set|clear`

オプション：

get: --provider <name>, --agent <id>, --json
set: --provider <name>, --agent <id>, <profileIds...>
clear: --provider <name>, --agent <id>

システム

`system event`

システムイベントをキューに入れ、オプションでハートビートをトリガー（Gateway RPC）。

必須：

--text <text>

オプション：

--mode <now|next-heartbeat>
--json
--url, --token, --timeout, --expect-final

`system heartbeat last|enable|disable`

ハートビート制御（Gateway RPC）。

オプション：

--json
--url, --token, --timeout, --expect-final

`system presence`

システムプレゼンスエントリの一覧（Gateway RPC）。

オプション：

--json
--url, --token, --timeout, --expect-final

Cron

スケジュールジョブの管理（Gateway RPC）。/automation/cron-jobsを参照。

サブコマンド：

cron status [--json]
cron list [--all] [--json]（デフォルトはテーブル出力。生データには--jsonを使用）
cron add（エイリアス: create。--nameと--at | --every | --cronのいずれか1つ、および--system-event | --messageのいずれか1つのペイロードが必須）
cron edit <id>（フィールドのパッチ）
cron rm <id>（エイリアス: remove, delete）
cron enable <id>
cron disable <id>
cron runs --id <id> [--limit <n>]
cron run <id> [--force]

すべてのcronコマンドは--url, --token, --timeout, --expect-finalを受け付けます。

Nodeホスト

nodeはヘッドレスNodeホストを実行するか、バックグラウンドサービスとして管理します。 openclaw nodeを参照。

サブコマンド：

node run --host <gateway-host> --port 18789
node status
node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
node uninstall
node stop
node restart

認証に関する補足：

nodeはenv/設定からGateway認証を解決（--token/--passwordフラグなし）：OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD、次にgateway.auth.*。ローカルモードでは、Nodeホストは意図的にgateway.remote.*を無視。gateway.mode=remoteでは、gateway.remote.*がリモート優先順位ルールに従って参加。
レガシーのCLAWDBOT_GATEWAY_*環境変数はNodeホストの認証解決では意図的に無視。

Nodes

nodesはGatewayと通信し、ペアリング済みのNodeをターゲットにします。/nodesを参照。

共通オプション：

--url, --token, --timeout, --json

サブコマンド：

nodes status [--connected] [--last-connected <duration>]
nodes describe --node <id|name|ip>
nodes list [--connected] [--last-connected <duration>]
nodes pending
nodes approve <requestId>
nodes reject <requestId>
nodes rename --node <id|name|ip> --name <displayName>
nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...>（macノードまたはヘッドレスNodeホスト）
nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>]（macのみ）

カメラ：

nodes camera list --node <id|name|ip>
nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]

Canvas + screen：

nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]

ロケーション：

nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

ブラウザ

ブラウザ制御CLI（専用Chrome/Brave/Edge/Chromium）。openclaw browserとBrowser toolを参照。

共通オプション：

--url, --token, --timeout, --json
--browser-profile <name>

管理：

browser status
browser start
browser stop
browser reset-profile
browser tabs
browser open <url>
browser focus <targetId>
browser close [targetId]
browser profiles
browser create-profile --name <name> [--color <hex>] [--cdp-url <url>]
browser delete-profile --name <name>

検査：

browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]

アクション：

browser navigate <url> [--target-id <id>]
browser resize <width> <height> [--target-id <id>]
browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
browser press <key> [--target-id <id>]
browser hover <ref> [--target-id <id>]
browser drag <startRef> <endRef> [--target-id <id>]
browser select <ref> <values...> [--target-id <id>]
browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
browser console [--level <error|warn|info>] [--target-id <id>]
browser pdf [--target-id <id>]

ドキュメント検索

`docs [query...]`

ライブドキュメントインデックスを検索。

TUI

`tui`

Gatewayに接続されたターミナルUIを開きます。

オプション：

--url <url>
--token <token>
--password <password>
--session <key>
--deliver
--thinking <level>
--message <text>
--timeout-ms <ms>（デフォルトはagents.defaults.timeoutSeconds）
--history-limit <n>

CLIリファレンス

コマンドページ

グローバルフラグ

出力スタイリング

カラーパレット

コマンドツリー

セキュリティ

シークレット

プラグイン

メモリ

チャットスラッシュコマンド

セットアップ + オンボーディング

setup

onboard

configure

config

doctor

チャネルヘルパー

channels

skills

pairing

devices

webhooks gmail

dns setup

メッセージング + エージェント

message

agent

agents

agents list

agents add [name]

agents bindings

agents bind

agents unbind

agents delete <id>

acp

status

使用量トラッキング

health

sessions

リセット / アンインストール

reset

uninstall

Gateway

gateway

gateway service

logs

gateway <subcommand>

モデル

models（ルート）

models list

models status

models set <model>

models set-image <model>

models aliases list|add|remove

models fallbacks list|add|remove|clear

models image-fallbacks list|add|remove|clear

models scan

models auth add|setup-token|paste-token

models auth order get|set|clear

システム

system event

system heartbeat last|enable|disable

system presence

Cron

Nodeホスト

Nodes

ブラウザ

ドキュメント検索

docs [query...]

TUI

tui

`setup`

`onboard`

`configure`

`config`

`doctor`

`channels`

`skills`

`pairing`

`devices`

`webhooks gmail`

`dns setup`

`message`

`agent`

`agents`

`agents list`

`agents add [name]`

`agents bindings`

`agents bind`

`agents unbind`

`agents delete <id>`

`acp`

`status`

`health`

`sessions`

`reset`

`uninstall`

`gateway`

`gateway service`

`logs`

`gateway <subcommand>`

`models`（ルート）

`models list`

`models status`

`models set <model>`

`models set-image <model>`

`models aliases list|add|remove`

`models fallbacks list|add|remove|clear`

`models image-fallbacks list|add|remove|clear`

`models scan`

`models auth add|setup-token|paste-token`

`models auth order get|set|clear`

`system event`

`system heartbeat last|enable|disable`

`system presence`

`docs [query...]`

`tui`