OpenClaw CLIリファレンス：全コマンドと設定オプションを網羅

コマンドページ

各コマンドの詳細については、以下のページを参照してください。

• setup
• onboard
• configure
• config
• completion
• doctor
• dashboard
• backup
• reset
• uninstall
• update
• message
• agent
• agents
• acp
• mcp
• status
• health
• sessions
• gateway
• logs
• system
• models
• infer
• memory
• wiki
• directory
• nodes
• devices
• node
• approvals
• sandbox
• tui
• browser
• cron
• tasks
• flows
• dns
• docs
• hooks
• webhooks
• pairing
• qr
• plugins (plugin commands)
• channels
• security
• secrets
• skills
• daemon (gateway サービスのコマンド用レガシーエイリアス)
• clawbot (レガシーエイリアス名前空間)
• voicecall (インストールされている場合の plugin)

グローバルフラグ

以下のフラグは、すべてのコマンドで使用できます。

• --dev: 状態を ~/.openclaw-dev 以下に分離し、デフォルトのポートを変更します。
• --profile <name>: 状態を ~/.openclaw-<name> 以下に分離します。
• --container <name>: 実行対象とするコンテナ名を指定します。
• --no-color: ANSI カラーを無効にします。
• --update: openclaw update の短縮形です（ソースからインストールした場合のみ）。
• -V, --version, -v: バージョン情報を表示して終了します。

出力のスタイリング

CLI の表示に関する仕様は以下の通りです。

• ANSI カラーとプログレスインジケーターは、TTY セッションでのみ表示されます。
• OSC-8 ハイパーリンクは、対応しているターミナルではクリック可能なリンクとして表示されます。未対応の場合は通常の URL が表示されます。
• --json（および対応している場所での --plain）を使用すると、スタイリングが無効になり、クリーンなデータが出力されます。
• --no-color を指定すると ANSI スタイリングが無効になります。環境変数 NO_COLOR=1 も同様に適用されます。
• 実行に時間がかかるコマンドでは、プログレスインジケーターが表示されます（対応している場合は OSC 9;4 を使用）。

カラーパレット

OpenClaw の CLI 出力には「lobster（ロブスター）」パレットが使用されています。

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

パレットの定義ファイル（Source of truth）: src/terminal/palette.ts

コマンドツリー

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
    file
    schema
    validate
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    audit
    configure
    apply
  reset
  uninstall
  update
    wizard
    status
  channels
    list
    status
    capabilities
    resolve
    logs
    add
    remove
    login
    logout
  directory
    self
    peers list
    groups list|members
  skills
    search
    install
    update
    list
    info
    check
  plugins
    list
    inspect
    install
    uninstall
    update
    enable
    disable
    doctor
    marketplace list
  memory
    status
    index
    search
  wiki
    status
    doctor
    init
    ingest
    compile
    lint
    search
    get
    apply
    bridge import
    unsafe-local import
    obsidian status|search|open|command|daily
  message
    send
    broadcast
    poll
    react
    reactions
    read
    edit
    delete
    pin
    unpin
    pins
    permissions
    search
    thread create|list|reply
    emoji list|upload
    sticker send|upload
    role info|add|remove
    channel info|list
    member info
    voice status
    event list|create
    timeout
    kick
    ban
  agent
  agents
    list
    add
    delete
    bindings
    bind
    unbind
    set-identity
  acp
  mcp
    serve
    list
    show
    set
    unset
  status
  health
  sessions
    cleanup
  tasks
    list
    audit
    maintenance
    show
    notify
    cancel
    flow list|show|cancel
  gateway
    call
    usage-cost
    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
  infer (alias: capability)
    list
    inspect
    model run|list|inspect|providers|auth login|logout|status
    image generate|edit|describe|describe-many|providers
    audio transcribe|providers
    tts convert|voices|providers|status|enable|disable|set-provider
    video generate|describe|providers
    web search|fetch|providers
    embedding create|providers
    auth add|login|login-github-copilot|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
    status
    describe
    list
    pending
    approve
    reject
    rename
    invoke
    notify
    push
    canvas snapshot|present|hide|navigate|eval
    canvas a2ui push|reset
    camera list|snap|clip
    screen record
    location get
  devices
    list
    remove
    clear
    approve
    reject
    rotate
    revoke
  node
    run
    status
    install
    uninstall
    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

注：plugins によって、トップレベルのコマンド（例：openclaw voicecall）を追加することも可能です。

セキュリティ

• openclaw security audit — 設定とローカルの状態をスキャンし、一般的なセキュリティ上の不備を確認します。
• openclaw security audit --deep — Gateway に対して実行可能な範囲でライブプロブ（診断）を行います。
• openclaw security audit --fix — 安全なデフォルト設定を適用し、状態や設定ファイルのパーミッションを厳格化します。

シークレット

secrets

SecretRefs と、それに関連するランタイムや設定のクリーンな状態を管理します。

サブコマンド：

• secrets reload
• secrets audit
• secrets configure
• secrets apply --from <path>

secrets reload のオプション：

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

secrets audit のオプション：

• --check
• --allow-exec
• --json

secrets configure のオプション：

• --apply
• --yes
• --providers-only
• --skip-provider-setup
• --agent <id>
• --allow-exec
• --plan-out <path>
• --json

secrets apply --from <path> のオプション：

• --dry-run
• --allow-exec
• --json

注意点：

• reload は Gateway RPC であり、解決に失敗した場合は最後に正常に動作していたランタイムのスナップショットを保持します。
• audit --check は問題が見つかった場合に 0 以外の値を返します。未解決の参照がある場合は、より優先度の高い 0 以外の終了コードを使用します。
• デフォルトでは dry-run の実行チェックはスキップされます。実行したい場合は --allow-exec を使用して明示的に許可してください。

プラグイン

拡張機能とその設定を管理します。

• openclaw plugins list — プラグインを検索します（マシン読み取り可能な出力には --json を使用してください）。
• openclaw plugins inspect <id> — プラグインの詳細を表示します（info はエイリアスです）。
• openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace> — プラグインをインストールします（または plugins.load.paths にプラグインのパスを追加します。既存のインストール先を上書きするには --force を使用してください）。
• openclaw plugins marketplace list <marketplace> — インストール前にマーケットプレイスのエントリを表示します。
• openclaw plugins enable <id> / disable <id> — plugins.entries.<id>.enabled の有効・無効を切り替えます。
• openclaw plugins doctor — プラグインのロードエラーを報告します。

ほとんどのプラグインの変更を反映するには、Gateway の再起動が必要です。詳細は /plugin を参照してください。

メモリ

MEMORY.md および memory/*.md を対象とした Vector search（ベクトル検索）機能です。

• openclaw memory status — インデックスの統計を表示します。Vector と Embedding の準備状況を確認するには --deep を、古くなった recall や promotion のアーティファクトを修復するには --fix を使用してください。
• openclaw memory index — メモリファイルのインデックスを再作成します。
• openclaw memory search "<query>" (または --query "<query>") — メモリに対してセマンティック検索を実行します。
• openclaw memory promote — 短期的な recall をランク付けし、オプションで上位のエントリを MEMORY.md に追記します。

サンドボックス

エージェントを隔離された環境で実行するための Sandbox 実行環境を管理します。詳細は /cli/sandbox を参照してください。

サブコマンド:

• sandbox list [--browser] [--json]
• sandbox recreate [--all] [--session <key>] [--agent <id>] [--browser] [--force]
• sandbox explain [--session <key>] [--agent <id>] [--json]

注意点:

• sandbox recreate は既存の実行環境を削除します。次に使用する際に、現在の設定で再度シードされます。
• ssh および OpenShell の remote バックエンドの場合、recreate を実行すると、選択したスコープの正規のリモートワークスペースが削除されます。

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

チャットメッセージでは、テキストおよびネイティブの /... コマンドをサポートしています。詳細は /tools/slash-commands を参照してください。

主なコマンド:

• /status: 素早い診断を実行します。
• /config: 永続的な設定変更を行います。
• /debug: 実行時のみの設定オーバーライドを行います（ディスクではなくメモリ上のみ。commands.debug: true が必要です）。

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

completion

シェル補完スクリプトを生成し、オプションでシェルのプロファイルにインストールします。

オプション:

• -s, --shell <zsh|bash|powershell|fish>
• -i, --install
• --write-state
• -y, --yes

注意点:

• --install または --write-state を指定しない場合、completion はスクリプトを標準出力（stdout）に表示します。
• --install は、シェルのプロファイルに OpenClaw Completion ブロックを書き込み、OpenClaw のステートディレクトリ下にあるキャッシュされたスクリプトを参照するように設定します。

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 <choice>。<choice> は以下のいずれかです: chutes, deepseek-api-key, openai-codex, openai-api-key, openrouter-api-key, kilocode-api-key, litellm-api-key, ai-gateway-api-key, cloudflare-ai-gateway-api-key, moonshot-api-key, moonshot-api-key-cn, kimi-code-api-key, synthetic-api-key, venice-api-key, together-api-key, huggingface-api-key, apiKey, gemini-api-key, google-gemini-cli, zai-api-key, zai-coding-global, zai-coding-cn, zai-global, zai-cn, xiaomi-api-key, minimax-global-oauth, minimax-global-api, minimax-cn-oauth, minimax-cn-api, opencode-zen, opencode-go, github-copilot, copilot-proxy, xai-api-key, mistral-api-key, volcengine-api-key, byteplus-api-key, qianfan-api-key, qwen-standard-api-key-cn, qwen-standard-api-key, qwen-api-key-cn, qwen-api-key, modelstudio-standard-api-key-cn, modelstudio-standard-api-key, modelstudio-api-key-cn, modelstudio-api-key, custom-api-key, skip
• Qwen に関する注意: qwen-* が正規の auth-choice ファミリーです。modelstudio-* の ID は、レガシーな互換性のためのエイリアスとしてのみ受け入れられます。
• --secret-input-mode <plaintext|ref> (デフォルトは plaintext。プレーンテキストのキーの代わりにプロバイダーのデフォルト環境変数参照を保存するには 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 と併用)
• --custom-model-id <id> (非対話型。--auth-choice custom-api-key と併用)
• --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 を環境変数の 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-search
• --skip-health
• --skip-ui
• --cloudflare-ai-gateway-account-id <id>
• --cloudflare-ai-gateway-gateway-id <id>
• --node-manager <npm|pnpm|bun> (スキル用のセットアップ/オンボーディング Node マネージャー。pnpm を推奨しますが、bun もサポートされています)
• --json

configure

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

オプション:

• --section <section> (複数指定可能。ウィザードを特定のセクションに限定します)

config

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

サブコマンド:

• config get <path>: 設定値を表示します（ドット/ブラケットパス形式）。
• config set: 4 つの割り当てモードをサポートしています:
  • 値モード: config set <path> <value> (JSON5 または文字列としてパース)
  • SecretRef ビルダーモード: config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id>
  • プロバイダービルダーモード: config set secrets.providers.<alias> --provider-source <env|file|exec> ...
  • バッチモード: config set --batch-json '<json>' または config set --batch-file <path>
• config set --dry-run: openclaw.json への書き込みを行わずに割り当てを検証します（exec SecretRef のチェックはデフォルトでスキップされます）。
• config set --allow-exec --dry-run: exec SecretRef の dry-run チェックを有効にします（プロバイダーのコマンドが実行される場合があります）。
• config set --dry-run --json: マシン読み取り可能な dry-run 出力を生成します（チェック項目、完了シグナル、操作内容、チェック/スキップされた参照、エラー）。
• config set --strict-json: パス/値の入力に JSON5 パースを必須とします。dry-run 出力モード以外では、--json は厳密なパースのためのレガシーなエイリアスとして機能します。
• config unset <path>: 値を削除します。
• config file: アクティブな設定ファイルのパスを表示します。
• config schema: openclaw.json 用に生成された JSON スキーマを表示します。これには、ネストされたオブジェクト、ワイルドカード、配列アイテム、合成ブランチにわたって伝播されたフィールドの title / description メタデータ、およびベストエフォートでのプラグイン/チャネルのスキーマメタデータが含まれます。
• config validate: Gateway を起動せずに、現在の設定をスキーマに対して検証します。
• config validate --json: マシン読み取り可能な JSON 出力を生成します。

doctor

ヘルスチェックとクイックフィックス（設定、Gateway、レガシーサービス）を行います。

オプション:

• --no-workspace-suggestions: ワークスペースメモリのヒントを無効にします。
• --yes: プロンプトを表示せずにデフォルト値を承認します（ヘッドレスモード）。
• --non-interactive: プロンプトをスキップし、安全なマイグレーションのみを適用します。
• --deep: システムサービスをスキャンして、追加の Gateway インストールを確認します。
• --repair (エイリアス: --fix): 検出された問題の自動修復を試みます。
• --force: 厳密に必要でない場合でも修復を強制します。
• --generate-gateway-token: 新しい Gateway 認証トークンを生成します。

dashboard

現在のトークンを使用して Control UI を開きます。

オプション:

• --no-open: URL を表示しますが、ブラウザは起動しません。

注意点:

• SecretRef で管理されている Gateway トークンの場合、dashboard はターミナル出力やブラウザの起動引数にシークレットを露出させないよう、トークン化されていない URL を表示または開きます。

update

インストールされている CLI を更新します。

ルートオプション:

• --json
• --no-restart
• --dry-run
• --channel <stable|beta|dev>
• --tag <dist-tag|version|spec>
• --timeout <seconds>
• --yes

サブコマンド:

• update status
• update wizard

update status オプション:

• --json
• --timeout <seconds>

update wizard オプション:

• --timeout <seconds>

注意点:

• openclaw --update は openclaw update に書き換えられます。

backup

OpenClaw のステート（状態）のローカルバックアップアーカイブを作成し、検証します。

サブコマンド:

• backup create
• backup verify <archive>

backup create オプション:

• --output <path>
• --json
• --dry-run
• --verify
• --only-config
• --no-include-workspace

backup verify <archive> オプション:

• --json

チャンネルヘルパー

channels

チャットチャンネルのアカウント（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Microsoft Teams）を管理します。

サブコマンド:

• channels list: 設定済みのチャンネルと認証プロファイルを表示します。
• channels status: Gateway の到達可能性とチャンネルのヘルス状態を確認します（--probe を使用すると、Gateway に到達可能な場合にアカウントごとのライブプローブ/監査チェックを実行します。到達できない場合は、設定のみのチャンネルサマリーを表示します。より広範な Gateway のヘルスプローブには openclaw health または openclaw status --deep を使用してください）。
• ヒント: channels status は、一般的な設定ミスを検出した際に修正案を含む警告を表示します（その後、openclaw doctor を案内します）。
• channels logs: Gateway ログファイルから最近のチャンネルログを表示します。
• channels add: フラグが渡されない場合はウィザード形式のセットアップを開始し、フラグがある場合は非対話モードに切り替わります。
  • 単一アカウントのトップレベル設定を使用しているチャンネルに、デフォルト以外のアカウントを追加する場合、OpenClaw は新しいアカウントを書き込む前に、アカウントスコープの値をチャンネルアカウントマップに昇格させます。ほとんどのチャンネルは accounts.default を使用しますが、Matrix は既存の一致する名前付き/デフォルトのターゲットを保持できます。
  • 非対話型の 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 status オプション:

• --probe
• --timeout <ms>
• --json

channels capabilities オプション:

• --channel <name>
• --account <id>（--channel 指定時のみ）
• --target <dest>
• --timeout <ms>
• --json

channels resolve オプション:

• <entries...>
• --channel <name>
• --account <id>
• --kind <auto|user|group>
• --json

channels logs オプション:

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

注意事項:

• channels login は --verbose をサポートしています。
• channels capabilities --account は --channel が設定されている場合にのみ適用されます。
• channels status --probe は、チャンネルのサポート状況に応じて、トランスポート状態に加えて works、probe failed、audit ok、audit failed などのプローブ/監査結果を表示できます。

詳細: /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

directory

ディレクトリ機能を提供するチャンネルの自分自身、ピア、およびグループ ID を検索します。詳細は openclaw directory を参照してください。

共通オプション:

• --channel <name>
• --account <id>
• --json

サブコマンド:

• directory self
• directory peers list [--query <text>] [--limit <n>]
• directory groups list [--query <text>] [--limit <n>]
• directory groups members --group-id <id> [--limit <n>]

skills

利用可能なスキルのリスト表示、検査、および準備状況の情報を確認します。

サブコマンド:

• skills search [query...]: ClawHub スキルを検索します。
• skills search --limit <n> --json: 検索結果を制限するか、マシン読み取り可能な形式で出力します。
• skills install <slug>: アクティブなワークスペースに ClawHub からスキルをインストールします。
• skills install <slug> --version <version>: 特定の ClawHub バージョンをインストールします。
• skills install <slug> --force: 既存のワークスペーススキルフォルダを上書きします。
• skills update <slug|--all>: 追跡されている ClawHub スキルを更新します。
• skills list: スキルを一覧表示します（サブコマンドがない場合のデフォルト）。
• skills list --json: マシン読み取り可能なスキルインベントリを標準出力に書き出します。
• skills list --verbose: テーブルに不足している要件を含めます。
• skills info <name>: 1つのスキルの詳細を表示します。
• skills info <name> --json: マシン読み取り可能な詳細を標準出力に書き出します。
• skills check: 準備完了の要件と不足している要件のサマリーを表示します。
• skills check --json: マシン読み取り可能な準備状況を標準出力に書き出します。

オプション:

• --eligible: 準備ができているスキルのみを表示します。
• --json: JSON を出力します（スタイリングなし）。
• -v, --verbose: 不足している要件の詳細を含めます。

ヒント: ClawHub 連携のスキルには openclaw skills search、openclaw skills install、openclaw skills update を使用してください。

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]

注意事項:

• ペアリング可能なチャンネルが1つだけ設定されている場合は、pairing approve <code> も可能です。
• list と approve はどちらも、マルチアカウントチャンネル用に --account <id> をサポートしています。

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>

注意事項:

• devices list と devices approve は、直接ペアリングスコープが利用できない場合、ローカルループバック上のローカルペアリングファイルにフォールバックできます。
• devices approve は、トークンを発行する前に明示的なリクエスト ID を必要とします。requestId を省略するか --latest を渡すと、最新の保留中のリクエストをプレビューするだけになります。
• 保存されたトークンによる再接続では、トークンのキャッシュされた承認済みスコープが再利用されます。明示的な devices rotate --scope ... は、将来のキャッシュトークン再接続のために、その保存されたスコープセットを更新します。
• devices rotate と devices revoke は JSON ペイロードを返します。

qr

現在の Gateway 設定から、モバイルペアリング用の QR コードとセットアップコードを生成します。詳細は openclaw qr を参照してください。

オプション:

• --remote
• --url <url>
• --public-url <url>
• --token <token>
• --password <password>
• --setup-code-only
• --no-ascii
• --json

注意事項:

• --token と --password は排他的です。
• セットアップコードには短期間のブートストラップトークンが含まれており、共有 Gateway トークン/パスワードそのものではありません。
• 組み込みのブートストラップハンドオフでは、プライマリノードトークンを scopes: [] に保ちます。
• 渡されたオペレーターブートストラップトークンは、operator.approvals, operator.read, operator.talk.secrets, operator.write に制限されます。
• ブートストラップスコープのチェックはロールプレフィックスが付いているため、オペレーターの許可リストはオペレーターのリクエストのみを満たします。オペレーター以外のロールには、引き続き独自のロールプレフィックスの下にスコープが必要です。
• --remote は gateway.remote.url またはアクティブな Tailscale Serve/Funnel URL を使用できます。
• スキャン後、openclaw devices list / openclaw devices approve <requestId> でリクエストを承認してください。

clawbot

レガシーなエイリアス名前空間です。現在は openclaw clawbot qr をサポートしており、これは openclaw qr にマップされます。

hooks

内部エージェントフックを管理します。

サブコマンド:

• hooks list
• hooks info <name>
• hooks check
• hooks enable <name>
• hooks disable <name>
• hooks install <path-or-spec>（openclaw plugins install の非推奨エイリアス）
• hooks update [id]（openclaw plugins update の非推奨エイリアス）

共通オプション:

• --json
• --eligible
• -v, --verbose

注意事項:

• プラグインで管理されているフックは、openclaw hooks を通じて有効化または無効化することはできません。所有しているプラグインを有効化または無効化してください。
• hooks install と hooks update は互換性のためのエイリアスとして引き続き機能しますが、非推奨の警告を表示し、プラグインコマンドに転送されます。

webhooks

Webhook ヘルパーです。現在の組み込み機能は Gmail Pub/Sub のセットアップとランナーです：

• webhooks gmail setup
• webhooks gmail run

webhooks gmail

Gmail Pub/Sub フックのセットアップとランナーです。詳細は Gmail Pub/Sub を参照してください。

サブコマンド:

• 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（同じフラグのランタイムオーバーライド）

注意事項:

• setup は Gmail のウォッチ設定と、OpenClaw 側のプッシュパスを設定します。
• run は、オプションのランタイムオーバーライドを使用して、ローカルの Gmail ウォッチャー/更新ループを開始します。

dns

広域ディスカバリ DNS ヘルパー（CoreDNS + Tailscale）です。現在の組み込み機能：

• dns setup [--domain <domain>] [--apply]

dns setup

広域ディスカバリ DNS ヘルパー（CoreDNS + Tailscale）です。詳細は /gateway/discovery を参照してください。

オプション:

• --domain <domain>
• --apply: CoreDNS 設定をインストール/更新します（sudo が必要です。macOS のみ）。

注意事項:

• --apply なしの場合、これは推奨される OpenClaw + Tailscale DNS 設定を表示するプランニングヘルパーとして機能します。
• --apply は現在、Homebrew CoreDNS を使用した 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（または --local による組み込み）を介してエージェントのターンを1回実行します。

少なくとも1つのセッションセレクター（--to, --session-id, または --agent）を渡してください。

必須:

• -m, --message <text>

オプション:

• -t, --to <dest>（セッションキーおよびオプションの配信先）
• --session-id <id>
• --agent <id>（エージェント ID。ルーティングバインディングを上書きします）
• --thinking <off|minimal|low|medium|high|xhigh>（プロバイダーのサポート状況により異なります。CLI レベルではモデルによる制限はありません）
• --verbose <on|off>
• --channel <channel>（配信チャンネル。省略した場合はメインセッションチャンネルが使用されます）
• --reply-to <target>（配信ターゲットの上書き。セッションルーティングとは別個です）
• --reply-channel <channel>（配信チャンネルの上書き）
• --reply-account <id>（配信アカウント ID の上書き）
• --local（組み込み実行。プラグインレジストリは最初にプリロードされます）
• --deliver
• --json
• --timeout <seconds>

注意事項:

• Gateway モードは、Gateway リクエストが失敗した際に組み込みエージェントにフォールバックします。
• --local でもプラグインレジストリをプリロードするため、プラグインが提供するプロバイダー、ツール、チャンネルは組み込み実行中も利用可能です。
• --channel, --reply-channel, --reply-account は返信の配信に影響し、ルーティングには影響しません。

agents

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

サブコマンドなしで openclaw agents を実行すると、openclaw agents list と同等になります。

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 はチャンネルのデフォルトやプラグインフックを介してアカウントスコープを解決することがあります。それ以外の場合は、明示的なアカウントスコープを持たないチャンネルバインディングとなります。 明示的な追加フラグを渡すと、コマンドは非対話パスに切り替わります。main は予約されており、新しいエージェント ID として使用することはできません。

agents bindings

ルーティングバインディングを一覧表示します。

オプション:

• --agent <id>
• --json

agents bind

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

オプション:

• --agent <id>（デフォルトは現在のデフォルトエージェント）
• --bind <channel[:accountId]>（繰り返し可能）
• --json

agents unbind

エージェントのルーティングバインディングを削除します。

オプション:

• --agent <id>（デフォルトは現在のデフォルトエージェント）
• --bind <channel[:accountId]>（繰り返し可能）
• --all
• --json

--all または --bind のいずれかを使用してください。両方は使用できません。

agents delete <id>

エージェントを削除し、そのワークスペースと状態を破棄します。

オプション:

• --force
• --json

注意事項:

• main は削除できません。
• --force がない場合、対話型の確認が必要です。

agents set-identity

エージェントのアイデンティティ（名前/テーマ/絵文字/アバター）を更新します。

オプション:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

注意事項:

• ターゲットエージェントの選択には --agent または --workspace を使用できます。
• 明示的なアイデンティティフィールドが指定されていない場合、コマンドは IDENTITY.md を読み取ります。

acp

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

ルートオプション:

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --session <key>
• --session-label <label>
• --require-existing
• --reset-session
• --no-prefix-cwd
• --provenance <off|meta|meta+receipt>
• --verbose

acp client

ブリッジのデバッグ用の対話型 ACP クライアントです。

オプション:

• --cwd <dir>
• --server <command>
• --server-args <args...>
• --server-verbose
• --verbose

詳細な動作、セキュリティ上の注意、および例については acp を参照してください。

mcp

保存された MCP サーバー定義を管理し、OpenClaw チャンネルを MCP stdio 経由で公開します。

mcp serve

ルーティングされた OpenClaw チャンネルの会話を MCP stdio 経由で公開します。

オプション:

• --url <url>
• --token <token>
• --token-file <path>
• --password <password>
• --password-file <path>
• --claude-channel-mode <auto|on|off>
• --verbose

mcp list

保存された MCP サーバー定義を一覧表示します。

オプション:

• --json

mcp show [name]

保存された特定の MCP サーバー定義、または保存された MCP サーバーオブジェクト全体を表示します。

オプション:

• --json

mcp set <name> <value>

JSON オブジェクトから1つの MCP サーバー定義を保存します。

mcp unset <name>

保存された MCP サーバー定義を1つ削除します。

approvals

実行承認を管理します。エイリアス: exec-approvals。

approvals get

実行承認のスナップショットと有効なポリシーを取得します。

オプション:

• --node <node>
• --gateway
• --json
• openclaw nodes と共通のノード RPC オプション

approvals set

ファイルまたは標準入力からの JSON で実行承認を置き換えます。

オプション:

• --node <node>
• --gateway
• --file <path>
• --stdin
• --json
• openclaw nodes と共通のノード RPC オプション

approvals allowlist add|remove

エージェントごとの実行許可リストを編集します。

オプション:

• --node <node>
• --gateway
• --agent <id>（デフォルトは *）
• --json
• openclaw nodes と共通のノード RPC オプション

status

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

オプション:

• --json
• --all（完全な診断。読み取り専用、貼り付け可能）
• --deep（Gateway にライブヘルスプローブを要求します。サポートされている場合はチャンネルプローブも含みます）
• --usage（モデルプロバイダーの使用量/クォータを表示します）
• --timeout <ms>
• --verbose
• --debug（--verbose のエイリアス）

注意事項:

• 概要には、利用可能な場合に Gateway とノードホストサービスの状態が含まれます。
• --usage は、正規化されたプロバイダー使用状況ウィンドウを X% left（残り X%）として表示します。

使用状況の追跡（Usage tracking）

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

表示場所:

• /status（利用可能な場合に短いプロバイダー使用状況の行を追加します）
• openclaw status --usage（プロバイダーごとの詳細な内訳を表示します）
• macOS メニューバー（Context の下の Usage セクション）

注意事項:

• データはプロバイダーの使用状況エンドポイントから直接取得されます（推定値ではありません）。
• 人間が読み取れる出力は、プロバイダー間で X% left に正規化されます。
• 現在使用状況ウィンドウをサポートしているプロバイダー: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi, z.ai。
• MiniMax に関する注意: 生の usage_percent / usagePercent は残りクォータを意味するため、OpenClaw は表示前にこれを反転させます。カウントベースのフィールドが存在する場合は、そちらが優先されます。model_remains レスポンスではチャットモデルのエントリを優先し、必要に応じてタイムスタンプからウィンドウラベルを導出し、プランラベルにモデル名を含めます。
• 使用状況の認証は、利用可能な場合はプロバイダー固有のフックから取得されます。それ以外の場合、OpenClaw は認証プロファイル、環境変数、または設定から一致する OAuth/API キー認証情報へのフォールバックを試みます。解決できない場合、使用状況は非表示になります。
• 詳細: 使用状況の追跡 を参照してください。

health

実行中の Gateway からヘルス情報を取得します。

オプション:

• --json
• --timeout <ms>
• --verbose（ライブプローブを強制し、Gateway 接続の詳細を表示します）
• --debug（--verbose のエイリアス）

注意事項:

• デフォルトの health は、最新のキャッシュされた Gateway スナップショットを返すことがあります。
• health --verbose はライブプローブを強制し、設定されているすべてのアカウントとエージェントにわたって人間が読み取れる出力を展開します。

sessions

保存された会話セッションを一覧表示します。

オプション:

• --json
• --verbose
• --store <path>
• --active <minutes>
• --agent <id>（エージェントでセッションをフィルタリング）
• --all-agents（すべてのエージェントのセッションを表示）

サブコマンド:

• sessions cleanup — 期限切れまたは孤立したセッションを削除します。

注意事項:

• sessions cleanup は、トランスクリプトファイルが消失したエントリを削除するための --fix-missing もサポートしています。

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

reset

ローカルの config や状態をリセットします（CLI 自体はインストールされたまま残ります）。

Options:

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

Notes:

• --non-interactive を使用する場合は、--scope と --yes の指定が必要です。

uninstall

Gateway サービスとローカルデータをアンインストールします（CLI は残ります）。

Options:

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

Notes:

• --non-interactive を使用する場合は、--yes と明示的なスコープ（または --all）の指定が必要です。
• --all を指定すると、サービス、状態、Workspace、App がまとめて削除されます。

tasks

エージェント全体で実行されている background task を一覧表示し、管理します。

• tasks list — 実行中および最近のタスクを表示します
• tasks show <id> — 特定のタスク実行の詳細を表示します
• tasks notify <id> — タスク実行の通知ポリシーを変更します
• tasks cancel <id> — 実行中のタスクをキャンセルします
• tasks audit — 運用上の問題（停滞、消失、配信失敗など）を表面化させます
• tasks maintenance [--apply] [--json] — タスクおよび TaskFlow のクリーンアップや調整（ACP/subagent の子セッション、アクティブな cron ジョブ、実行中の CLI など）のプレビューまたは適用を行います
• tasks flow list — 実行中および最近の Task Flow を一覧表示します
• tasks flow show <lookup> — ID またはルックアップキーでフローを調査します
• tasks flow cancel <lookup> — 実行中のフローと、それに紐づくアクティブなタスクをキャンセルします

flows

以前のドキュメント用のショートカットです。Flow コマンドは openclaw tasks flow の配下に移動しました。

• tasks flow list [--json]
• tasks flow show <lookup>
• tasks flow cancel <lookup>

Gateway

gateway

WebSocket Gateway を実行します。

Options:

• --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 config + credentials + sessions + workspace をリセット)
• --force (ポート上の既存のリスナーを強制終了)
• --verbose
• --cli-backend-logs
• --ws-log <auto|full|compact>
• --compact (--ws-log compact のエイリアス)
• --raw-stream
• --raw-stream-path <path>

gateway service

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

Subcommands:

• gateway status (デフォルトで Gateway RPC をプローブします)
• gateway install (サービスのインストール)
• gateway uninstall
• gateway start
• gateway stop
• gateway restart

Notes:

• gateway status は、サービスの解決済みポート/config を使用して Gateway RPC をプローブします（--url/--token/--password で上書き可能です）。
• gateway status は、スクリプト用に --no-probe、--deep、--require-rpc、--json をサポートしています。
• gateway status は、検出可能な場合に古い Gateway サービスや余分な Gateway サービスも表示します（--deep を付けるとシステムレベルのスキャンが追加されます）。プロフィール名が付いた OpenClaw サービスは第一級オブジェクトとして扱われ、「余分なもの」としてはフラグが立てられません。
• gateway status は、ローカルの CLI config が欠落しているか無効な場合でも、診断のために利用可能です。
• gateway status は、解決されたログファイルのパス、CLI とサービスの config パス/有効性のスナップショット、および解決されたプローブ対象 URL を出力します。
• 現在のコマンドパスで Gateway 認証の SecretRefs が解決されない場合、gateway status --json はプローブの接続または認証に失敗したときのみ rpc.authWarning を報告します（プローブが成功した場合は警告は抑制されます）。
• Linux の systemd インストールでは、ステータスのトークン不一致チェックに Environment= と EnvironmentFile= の両方のユニットソースが含まれます。
• gateway install|uninstall|start|stop|restart は、スクリプト用に --json をサポートしています（デフォルトの出力は人間が読みやすい形式のままです）。
• gateway install はデフォルトで Node ランタイムを使用します。bun は推奨されません（WhatsApp/Telegram のバグのため）。
• gateway install のオプション: --port, --runtime, --token, --force, --json

daemon

Gateway サービス管理コマンドの古いエイリアスです。/cli/daemon を参照してください。

Subcommands:

• daemon status
• daemon install
• daemon uninstall
• daemon start
• daemon stop
• daemon restart

Common options:

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• uninstall|start|stop|restart: --json

logs

RPC 経由で Gateway のログファイルをリアルタイムで表示（tail）します。

Options:

• --limit <n>: 返されるログ行の最大数
• --max-bytes <n>: ログファイルから読み取る最大バイト数
• --follow: ログファイルをフォローします（tail -f スタイル）
• --interval <ms>: フォロー時のポーリング間隔（ミリ秒）
• --local-time: タイムスタンプをローカル時間で表示
• --json: 行区切りの JSON を出力
• --plain: 構造化されたフォーマットを無効化
• --no-color: ANSI カラーを無効化
• --url <url>: 明示的な Gateway WebSocket URL
• --token <token>: Gateway トークン
• --timeout <ms>: Gateway RPC タイムアウト
• --expect-final: 必要に応じて最終レスポンスを待機

Examples:

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

Notes:

• --url を渡した場合、CLI は config や環境変数の認証情報を自動適用しません。
• ローカルループバックのペアリングに失敗した場合は、設定されたローカルログファイルにフォールバックしますが、明示的な --url ターゲットの場合はフォールバックしません。

gateway <subcommand>

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

Subcommands:

• gateway call <method> [--params <json>] [--url <url>] [--token <token>] [--password <password>] [--timeout <ms>] [--expect-final] [--json]
• gateway health
• gateway status
• gateway probe
• gateway discover
• gateway install|uninstall|start|stop|restart
• gateway run

Notes:

• gateway status --deep はシステムレベルのサービススキャンを追加します。より詳細なランタイムプローブの詳細については、gateway probe、health --verbose、またはトップレベルの status --deep を使用してください。

Common RPCs:

• config.schema.lookup (1つの config サブツリーを、浅いスキーマノード、一致したヒントメタデータ、および直接の子のサマリーとともに検査します)
• config.get (現在の config スナップショットとハッシュを読み取ります)
• config.set (フル config の検証と書き込み。楽観的並行性制御のために baseHash を使用します)
• config.apply (検証 + config 書き込み + 再起動 + ウェイク)
• config.patch (部分的な更新のマージ + 再起動 + ウェイク)
• update.run (アップデート実行 + 再起動 + ウェイク)

Tip: config.set/config.apply/config.patch を直接呼び出す際、すでに config が存在する場合は config.get から取得した baseHash を渡してください。 Tip: 部分的な編集を行う場合は、まず config.schema.lookup で検査し、config.patch を使用することをお勧めします。 Tip: これらの config 書き込み RPC は、送信された config ペイロード内の SecretRef 解決を事前にチェックし、アクティブな参照が解決されない場合は書き込みを拒否します。 Tip: オーナー専用の gateway ランタイムツールは、tools.exec.ask または tools.exec.security の書き換えを引き続き拒否します。古い tools.bash.* エイリアスは、同じ保護された実行パスに正規化されます。

モデル

フォールバックの挙動やスキャン戦略については、/concepts/models を参照してください。

Anthropicに関する注意：Anthropicのスタッフからの情報に基づき、OpenClawスタイルのClaude CLIの使用が再び許可されました。そのため、Anthropicが新しいポリシーを公開しない限り、OpenClawはClaude CLIの再利用および claude -p の使用を、この統合において公認のものとして扱います。本番環境では、Anthropic APIキー、またはOpenAI Codex、Alibaba Cloud Model Studio Coding Plan、MiniMax Coding Plan、Z.AI / GLM Coding Planなど、サポートされている他のサブスクリプション形式のプロバイダーの使用を推奨します。

Anthropicの setup-token は引き続きサポートされている認証パスとして利用可能ですが、OpenClawは現在、利用可能な場合にはClaude CLIの再利用と claude -p を優先します。

models (root)

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>
• --agent <id>

常に認証の概要と、認証ストア内のプロファイルのOAuth有効期限ステータスが含まれます。 --probe はライブリクエストを実行します（トークンを消費し、レート制限をトリガーする可能性があります）。 プローブの行は、認証プロファイル、環境変数の認証情報、または models.json から取得されます。 プローブのステータスには、ok、auth、rate_limit、billing、timeout、format、unknown、no_model などが表示されます。 明示的な auth.order.<provider> で保存済みのプロファイルが省略されている場合、プローブはそのプロファイルを黙って試行するのではなく、excluded_by_auth_order と報告します。

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|login|login-github-copilot|setup-token|paste-token

オプション：

• add: 対話型の認証ヘルパー（プロバイダーの認証フローまたはトークンの貼り付け）
• login: --provider <name>, --method <method>, --set-default
• login-github-copilot: GitHub Copilot OAuth ログインフロー (--yes)
• setup-token: --provider <name>, --yes
• paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

注意点：

• setup-token と paste-token は、トークン認証メソッドを公開しているプロバイダー向けの汎用トークンコマンドです。
• setup-token は対話型 TTY を必要とし、プロバイダーのトークン認証メソッドを実行します。
• paste-token はトークン値の入力を求めます。--profile-id が省略された場合は、デフォルトで認証プロファイル ID <provider>:manual が使用されます。
• Anthropic の setup-token / paste-token は、サポートされている OpenClaw トークンパスとして引き続き利用可能ですが、OpenClaw は現在、利用可能な場合には Claude CLI の再利用と claude -p を優先します。

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 のいずれか一つと、--system-event | --message のいずれか一つのペイロードを必ず指定してください）
• cron edit <id>（フィールドの修正）
• cron rm <id>（エイリアス：remove, delete）
• cron enable <id>
• cron disable <id>
• cron runs --id <id> [--limit <n>]
• cron run <id> [--due]

すべての cron コマンドで --url, --token, --timeout, --expect-final が使用可能です。

cron add|edit --model ... を使用すると、そのジョブに対して選択した許可済みのモデルが適用されます。もし指定したモデルが許可されていない場合、Cron は警告を表示し、ジョブの Agent またはデフォルトのモデル選択にフォールバックします。設定済みのフォールバックチェーンは引き続き適用されますが、明示的なジョブごとのフォールバックリストを持たない単純なモデルの上書きでは、Agent のプライマリモデルが隠れたリトライ先として追加されることはなくなりました。

Node ホスト

node

node は、ヘッドレスな Node host を実行したり、バックグラウンドサービスとして管理したりします。詳細は 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 は環境変数や設定から Gateway の認証情報を解決します（--token や --password フラグはありません）。具体的には OPENCLAW_GATEWAY_TOKEN または OPENCLAW_GATEWAY_PASSWORD が参照され、その次に gateway.auth.* が確認されます。ローカルモードでは、Node host は意図的に gateway.remote.* を無視します。gateway.mode=remote の場合は、リモートの優先順位ルールに従って gateway.remote.* が適用されます。
• Node host の認証解決では、OPENCLAW_GATEWAY_* 環境変数のみが有効です。

Nodes

nodes は Gateway と通信し、ペアリングされたノードを操作するためのコマンドです。詳細は /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 notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac のみ)

Camera（カメラ）:

• 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|1

音声通話

voicecall

プラグインが提供する音声通話ユーティリティです。この機能は、voice-call プラグインがインストールされ、有効になっている場合にのみ表示されます。詳細は openclaw voicecall を確認してください。

よく使われるコマンド：

- `voicecall call --to &lt;phone&gt; --message <text> [--mode notify|conversation]`
- `voicecall start --to <phone> [--message <text>] [--mode notify|conversation]`
- `voicecall continue --call-id <id> --message <text>`
- `voicecall speak --call-id <id> --message <text>`
- `voicecall end --call-id <id>`
- `voicecall status --call-id <id>`
- `voicecall tail [--file <path>] [--since <n>] [--poll <ms>]`
- `voicecall latency [--file <path>] [--last <n>]`
- `voicecall expose [--mode off|serve|funnel] [--path <path>] [--port <port>] [--serve-path <path>]`

ドキュメント検索

docs

最新の OpenClaw ドキュメントインデックスを検索します。

docs [query...]

最新のドキュメントインデックスを検索します。

TUI

tui

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

オプション：

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