openclaw 是主要的命令列介面進入點。每個核心命令都有專屬的
參考頁面,或會與其別名命令一同記錄;此索引列出
適用於整個命令列介面的命令、全域旗標與輸出樣式規則。
依用途區分的設定命令:
openclaw setup和openclaw onboard會執行完整的首次啟動導引流程,涵蓋閘道、模型驗證、工作區、頻道、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 · 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 的簡寫;適用於原始碼 checkout 與套件安裝 |
-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。
命令樹
Full command tree
Full command tree
此地圖涵蓋核心命令及其主要子命令。外掛新增的
子命令(例如位於 外掛可以新增其他頂層命令,例如
skills、plugins 和 wiki 之下)會
獨立演進;請執行 <command> --help 以取得權威且最新的清單。openclaw workboard 或 openclaw voicecall。聊天斜線命令
聊天訊息支援/... 命令。請參閱斜線命令。
重點:
/status- 快速診斷。/trace- 工作階段範圍的外掛追蹤/除錯列。/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。
詳情請參閱用量追蹤。