CLI commands

命令列介面參考資料

openclaw 是主要的命令列介面進入點。每個核心命令都有專屬的 參考頁面,或與其別名所對應的命令一併記錄;此索引列出適用於整個命令列介面的 命令、全域旗標與輸出樣式規則。

依用途分類的設定命令:

  • openclaw setupopenclaw onboard 會先驗證推論功能,接著啟動 Crestodian,以設定閘道、工作區、頻道、Skills 與健康狀態。
  • openclaw setup --baseline 會建立基準設定與工作區,而不進入引導式初始設定流程。
  • openclaw configure 會變更現有設定的特定部分:模型驗證、閘道、頻道、外掛或 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 · logs · system
模型與推論 models · promos · infer · capabilityinfer 的別名)· memory · commitments · wiki
網路與節點 directory · nodes · devices · node
執行階段與沙箱 approvals · exec-policy(請參閱 approvals)· sandbox · tui · chat/terminaltui --local 的別名)· browser
自動化 cron · tasks · hooks · webhooks · transcripts
探索與文件 dns · docs
配對與頻道 pairing · qr · channels
安全性與外掛 security · secrets · skills · plugins · proxy
舊版別名 daemon(閘道服務)· clawbot(命名空間)
外掛(選用) path · policy · voicecall · workboard(若已安裝)

全域旗標

旗標 用途
--dev 將狀態隔離於 ~/.openclaw-dev 下,預設閘道連接埠為 19001,並平移衍生連接埠
--profile <name> 將狀態隔離於 ~/.openclaw-<name> 下(OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH
--container <name> 在名為 <name> 的執行中 Podman/Docker 容器內執行命令列介面(預設:環境變數 OPENCLAW_CONTAINER
--log-level <level> 覆寫檔案與主控台輸出的全域日誌層級
--no-color 停用 ANSI 色彩(也會遵循 NO_COLOR=1
--update openclaw update 的簡寫;適用於原始碼簽出與套件安裝版本
-V, --version, -v 顯示版本並結束

輸出模式

  • ANSI 色彩與進度指示器只會在 TTY 工作階段中顯示。
  • OSC-8 超連結會在支援的環境中顯示為可點擊連結;否則 命令列介面會改用純文字 URL。
  • --json(以及支援時的 --plain)會停用樣式,以產生乾淨的輸出。
  • 長時間執行的命令會顯示進度指示器(支援時使用 OSC 9;4)。

調色盤

OpenClaw 的命令列介面輸出採用龍蝦色調色盤:

權杖 十六進位值 用途
accent #FF5A2D 標題、標籤、主要醒目提示
accentBright #FF7A3D 命令名稱、強調
accentDim #D14A22 次要醒目提示文字
info #FF8A5B 資訊值
success #2FBF71 成功狀態
warn #FFB020 警告、選項旗標、備援機制
error #E23D2D 錯誤、失敗
muted #8B7F77 弱化顯示、中繼資料

調色盤的唯一依據:packages/terminal-core/src/palette.ts

命令樹

完整命令樹

此對照表涵蓋核心命令及其主要子命令。由外掛新增的 子命令(例如位於 skillspluginswiki 下)會 獨立演進;請執行 <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)

外掛可以新增其他頂層命令,例如 openclaw workboardopenclaw voicecall

聊天斜線命令

聊天訊息支援 /... 命令。請參閱斜線命令

重點功能:

  • /status - 快速診斷。
  • /trace - 工作階段範圍的外掛追蹤/除錯行。
  • /config - 持久化的設定變更。
  • /debug - 僅限執行階段的設定覆寫(儲存於記憶體而非磁碟;需要 commands.debug: true)。

使用量追蹤

當 OAuth/API 憑證可用時,openclaw status --usage 和控制介面會顯示供應商的使用量/配額。資料直接來自供應商的使用量端點,並統一標準化為 X% left。目前提供使用量時間窗的供應商包括:Anthropic、Gemini CLI、GitHub Copilot、MiniMax、OpenAI Codex、Xiaomi 及 z.ai。

詳情請參閱使用量追蹤

相關內容

Was this useful?
On this page

On this page