CLI commands

CLI リファレンス

openclaw は主要な CLI エントリーポイントです。各コアコマンドには専用のリファレンスページがあるか、エイリアス先のコマンドとともに文書化されています。この索引では、 CLI 全体に適用されるコマンド、グローバルフラグ、出力スタイルのルールを一覧にしています。

目的別のセットアップコマンド:

openclaw setup と openclaw onboard は最初に推論を検証し、その後 Gateway、ワークスペース、チャンネル、Skills、ヘルスチェックのセットアップ用に Crestodian を起動します。
openclaw setup --baseline は、ガイド付きオンボーディングフローを進めずに、ベースライン設定とワークスペースを作成します。
openclaw configure は、既存のセットアップの対象部分（モデル認証、Gateway、チャンネル、Plugin、または Skills）を変更します。
openclaw channels add は、ベースラインの作成後にチャンネルアカウントを設定します。ガイド付きセットアップではフラグなしで、スクリプトではチャンネル固有のフラグを指定して実行します。

コマンドページ

領域	コマンド
セットアップとオンボーディング	`crestodian` · `setup` · `onboard` · `configure` · `config` · `completion` · `doctor` · `dashboard`
リセット、バックアップ、移行	`backup` · `migrate` · `reset` · `uninstall` · `update`
メッセージングとエージェント	`message` · `agent` · `agents` · `attach` · `acp` · `mcp`
ヘルスチェックとセッション	`status` · `health` · `sessions` · `audit`
Gateway とログ	`gateway` · `logs` · `system`
モデルと推論	`models` · `promos` · `infer` · `capability`（`infer` のエイリアス）· `memory` · `commitments` · `wiki`
ネットワークと Node	`directory` · `nodes` · `devices` · `node`
ランタイムとサンドボックス	`approvals` · `exec-policy`（`approvals` を参照）· `sandbox` · `tui` · `chat`/`terminal`（`tui --local` のエイリアス）· `browser`
自動化	`cron` · `tasks` · `hooks` · `webhooks` · `transcripts`
検出とドキュメント	`dns` · `docs`
ペアリングとチャンネル	`pairing` · `qr` · `channels`
セキュリティと Plugin	`security` · `secrets` · `skills` · `plugins` · `proxy`
レガシーエイリアス	`daemon`（Gateway サービス）· `clawbot`（名前空間）
Plugin（任意）	`path` · `policy` · `voicecall` · `workboard`（インストールされている場合）

グローバルフラグ

フラグ	目的
`--dev`	状態を `~/.openclaw-dev` 配下に分離し、Gateway のデフォルトポートを 19001 に設定して、派生ポートをずらします
`--profile <name>`	状態を `~/.openclaw-<name>` 配下に分離します（`OPENCLAW_STATE_DIR`/`OPENCLAW_CONFIG_PATH`）
`--container <name>`	`<name>` という名前の実行中の Podman/Docker コンテナ内で CLI を実行します（デフォルト: 環境変数 `OPENCLAW_CONTAINER`）
`--log-level <level>`	ファイルおよびコンソール出力のグローバルログレベルを上書きします
`--no-color`	ANSI カラーを無効にします（`NO_COLOR=1` も考慮されます）
`--update`	`openclaw update` の短縮形です。ソースチェックアウトとパッケージインストールの両方で動作します
`-V`, `--version`, `-v`	バージョンを出力して終了します

出力モード

ANSI カラーと進捗インジケーターは、TTY セッションでのみ表示されます。
OSC-8 ハイパーリンクは、対応している環境ではクリック可能なリンクとして表示されます。それ以外の場合、 CLI はプレーン URL にフォールバックします。
--json（および対応している場合は --plain）は、クリーンな出力のためにスタイルを無効にします。
長時間実行されるコマンドは、進捗インジケーターを表示します（対応している場合は OSC 9;4）。

カラーパレット

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

トークン	16 進数	用途
`accent`	`#FF5A2D`	見出し、ラベル、主要な強調表示
`accentBright`	`#FF7A3D`	コマンド名、強調
`accentDim`	`#D14A22`	副次的な強調テキスト
`info`	`#FF8A5B`	情報を示す値
`success`	`#2FBF71`	成功状態
`warn`	`#FFB020`	警告、オプションフラグ、フォールバック
`error`	`#E23D2D`	エラー、失敗
`muted`	`#8B7F77`	強調の抑制、メタデータ

パレットの信頼できる唯一の情報源: packages/terminal-core/src/palette.ts。

コマンドツリー

完全なコマンドツリー

この一覧は、コアコマンドとその主要なサブコマンドを網羅しています。Plugin によって追加されるサブコマンド（たとえば skills、plugins、wiki 配下）は個別に進化します。正式な最新の一覧を確認するには、<command> --help を実行してください。

Code

openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig  get  set  unset  file  schema  validatecompletiondoctordashboardbackup  create  verifymigrate  list  plan <provider>  apply <provider>security  auditsecrets  reload  audit  configure  applyresetuninstallupdate  wizard  status  repairchannels  list  status  capabilities  resolve  logs  add  remove  login  logoutdirectory  self  peers list  groups list|membersskills  search  install  update  verify  workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine  list  info  checkplugins  list  search  inspect  install  uninstall  update  enable  disable  doctor  build  validate  init  registry  marketplace list|entries|refreshworkboard  list  create  show  dispatchmemory  status  index  searchtranscripts  list  show  pathpath  resolve  find  set  validate  emitcommitments  list  dismisswiki  status  doctor  init  compile  lint  ingest  okf import  search  get  apply synthesis|metadata  bridge import  unsafe-local import  chatgpt import|rollback  obsidian status|search|open|command|dailymessage  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  banagentagents  list  add  delete  bindings  bind  unbind  set-identityattachacpmcp  serve  list  show  set  unsetstatushealthsessions  cleanupaudittasks  list  audit  maintenance  show  notify  cancel  flow list|show|cancelgateway  call  usage-cost  health  stability  diagnostics export  status  probe  discover  install  uninstall  start  stop  restart  rundaemon  status  install  uninstall  start  stop  restartlogssystem  event  heartbeat last|enable|disable  presencemodels  list  status  set  set-image  aliases list|add|remove  fallbacks list|add|remove|clear  image-fallbacks list|add|remove|clear  scan  auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot  auth order get|set|clearpromos  list  claim <slug>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|personas|providers|status|enable|disable|set-provider|set-persona  video generate|describe|providers  web search|fetch|providers  embedding create|providerssandbox  list  recreate  explaincron  status  list  get  add  edit  rm  enable  disable  runs  runnodes  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 getdevices  list  remove  clear  approve  reject  rotate  revokenode  run  status  install  uninstall  stop  restartapprovals  get  set  allowlist add|removeexec-policy  show  preset  setbrowser  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  pdfhooks  list  info  check  enable  disable  install  updatewebhooks  gmail setup|runproxy  start  run  coverage  sessions  query  blob  purgepairing  list  approveqrclawbot  qrdocsdns  setuptuichat (alias: tui --local)terminal (alias: tui --local)

Plugin は、openclaw workboard や openclaw voicecall などの追加のトップレベルコマンドを追加できます。

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

チャットメッセージは /... コマンドをサポートしています。スラッシュコマンドを参照してください。

主な機能:

/status - クイック診断。
/trace - セッション単位の Plugin トレース/デバッグ行。
/config - 永続化される設定変更。
/debug - ランタイムのみの設定上書き（メモリ上のみで、ディスクには保存されません。commands.debug: true が必要です）。

使用量の追跡

OAuth/API 認証情報が利用可能な場合、openclaw status --usage と Control UI にプロバイダーの使用量/クォータが表示されます。データはプロバイダーの使用量エンドポイントから直接取得され、X% left に正規化されます。現在使用量ウィンドウに対応しているプロバイダー: Anthropic、Gemini CLI、GitHub Copilot、MiniMax、OpenAI Codex、Xiaomi、z.ai。

詳細は使用量の追跡を参照してください。