CLI commands
命令列介面參考資料
openclaw 是主要的命令列介面進入點。每個核心命令都有專屬的
參考頁面,或與其別名所對應的命令一併記錄;此索引列出適用於整個命令列介面的
命令、全域旗標與輸出樣式規則。
依用途分類的設定命令:
openclaw setup與openclaw 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 · capability(infer 的別名)· memory · commitments · wiki |
| 網路與節點 | 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 |
| 安全性與外掛 | 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。
命令樹
完整命令樹
此對照表涵蓋核心命令及其主要子命令。由外掛新增的
子命令(例如位於 skills、plugins 與 wiki 下)會
獨立演進;請執行 <command> --help 以取得具權威性且最新的清單。
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 workboard 或 openclaw 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?