OpenClaw 常用命令小結(jié)

發(fā)布時間：2026-03-01 17:50:54 作者：佚名

OpenClaw 的命令行工具非常強大，覆蓋了從安裝配置到日常使用的方方面面,為了讓你能快速上手，我將最常用的命令整理為以下分類速查表，你可以將它看作一份隨時查閱的急救手冊

OpenClaw 常用命令速查表

分類	命令	核心作用
?? 安裝與入門	`curl -fsSL https://openclaw.ai/install.sh \| bash` (macOS/Linux)	一鍵安裝 OpenClaw。
	`iwr -useb https://openclaw.ai/install.ps1 \| iex` (Windows PowerShell)	一鍵安裝 OpenClaw。
	`openclaw onboard --install-daemon`	啟動配置向?qū)?/strong>，并安裝后臺服務(wù)。
	`openclaw --help`	查看所有命令的幫助信息。
	`openclaw --version`	查看當(dāng)前 OpenClaw 版本。
?? 配置管理	`openclaw configure`	啟動交互式配置向?qū)?/strong>，修改設(shè)置。
	`openclaw config get`	查看當(dāng)前完整配置。
	`openclaw config set <key> <value>`	設(shè)置特定配置項 (例如: `openclaw config set models.default bailian/qwen3-max`)。
	`openclaw doctor`	運行診斷檢查，發(fā)現(xiàn)問題。
	`openclaw doctor --fix`	自動修復(fù) detected issues.
??? 服務(wù)控制 (Gateway)	`openclaw gateway install`	將 Gateway 安裝為系統(tǒng)服務(wù)。
	`openclaw gateway start`	啟動 Gateway 服務(wù)。
	`openclaw gateway stop`	停止 Gateway 服務(wù)。
	`openclaw gateway restart`	重啟 Gateway 服務(wù) (修改配置后常用)。
	`openclaw gateway status`	查看 Gateway 運行狀態(tài)。
	`openclaw logs follow` 或 `journalctl --user -u openclaw-gateway.service -f`	實時查看日志，方便排查錯誤。
?? 模型與渠道	`openclaw models list`	列出所有可用的 AI 模型。
	`openclaw models set <模型名稱>`	設(shè)置默認(rèn) AI 模型。
	`openclaw models status --probe`	探測模型連接狀態(tài)（可能會產(chǎn)生費用）。
	`openclaw channels list`	列出所有已配置的消息渠道 (如 Telegram, 飛書)。
	`openclaw devices list`	列出待配對的設(shè)備。
	`openclaw devices approve <requestId>`	批準(zhǔn)設(shè)備配對請求。
?? 日常使用	`openclaw dashboard`	在瀏覽器中打開 Web 控制臺 (通常是 `http://127.0.0.1:18789`)。
	`openclaw tui`	啟動終端界面進(jìn)行對話。
	`openclaw agent --message "你的指令"`	直接在命令行中讓 agent 執(zhí)行任務(wù)。
	`openclaw update`	升級 OpenClaw 到最新版本。

新手建議與小技巧

從doctor開始：無論何時遇到問題，第一反應(yīng)可以是執(zhí)行 openclaw doctor。它會像一位經(jīng)驗豐富的醫(yī)生一樣，幫你診斷大部分常見的配置和環(huán)境問題。
用好dashboard：對于不熟悉命令行的朋友，openclaw dashboard 命令是你最好的朋友。它會打開一個圖形化界面，讓你可以更直觀地管理模型、技能和查看日志。
安全第一：OpenClaw 功能強大，擁有較高權(quán)限。在安裝和配置新技能時，請留意相關(guān)安全提示，并考慮在沙盒環(huán)境中運行。

OpenClaw 常用命令如下

命令	作用	備注 / 參數(shù)
`openclaw status`	查看 Gateway 當(dāng)前運行狀態(tài)	包含健康度與上下文信息
`openclaw health`	健康檢查	檢測 core、依賴與運行環(huán)境
`openclaw doctor`	綜合診斷與修復(fù)建議	支持 `--deep` 深度檢查
`openclaw onboard`	交互式初始化向?qū)?/td>	首次使用推薦
`openclaw onboard --install-daemon`	安裝系統(tǒng)守護(hù)進(jìn)程	后臺常駐運行 Gateway
`openclaw onboard --uninstall-daemon`	卸載守護(hù)進(jìn)程	不刪除數(shù)據(jù)
`openclaw configure`	交互式配置向?qū)?/td>	模型、通道、憑據(jù)等
`openclaw config get <path>`	獲取配置值	JSON Path
`openclaw config set <path> <value>`	設(shè)置配置項	支持 JSON5 / raw 文本
`openclaw config unset <path>`	清除配置項	移除單個鍵值
`openclaw channels list`	列出已登錄通道	WhatsApp / Telegram / Discord 等
`openclaw channels login`	登錄新的通道賬號	掃碼或授權(quán)流程
`openclaw channels add`	添加通道	Telegram / Discord / Slack
`openclaw channels status --probe`	通道健康檢查	檢測連接可達(dá)性
`openclaw skills list`	列出技能	已安裝 / 可用技能
`openclaw skills info <skill>`	技能詳情	參數(shù)、版本信息
`clawhub install <slug>`	從 ClawHub 安裝技能	官方技能市場
`openclaw hooks list`	列出 Hook 列表	事件鉤子機制
`openclaw plugins list`	列出插件	查看已安裝插件
`openclaw plugins install <id>`	安裝插件	例如 `@openclaw/voice-call`
`openclaw plugins enable <id>`	啟用插件	通常需要重啟 Gateway
`openclaw models list`	列出可用模型	包含鑒權(quán)狀態(tài)
`openclaw models status`	模型狀態(tài)	當(dāng)前可用性
`openclaw models auth setup-token`	模型鑒權(quán)配置	Cheatsheet 推薦方式
`openclaw memory search "X"`	搜索長期記憶	向量搜索
`openclaw memory index`	重建記憶索引	修復(fù) memory 異常
`openclaw logs`	查看日志	默認(rèn)聚合輸出
`openclaw logs --follow`	實時日志	`--json / --plain / --limit`
`openclaw gateway install`	安裝 Gateway 系統(tǒng)服務(wù)	注冊為系統(tǒng)守護(hù)進(jìn)程
`openclaw gateway start`	啟動 Gateway 服務(wù)	system service 模式
`openclaw gateway stop`	停止 Gateway 服務(wù)
`openclaw gateway restart`	重啟 Gateway 服務(wù)	配置變更后使用
`openclaw gateway status`	Gateway 系統(tǒng)服務(wù)狀態(tài)	不同于 `openclaw status`
`openclaw browser start`	啟動瀏覽器代理	Automation 能力
`openclaw browser screenshot`	網(wǎng)頁截圖
`openclaw subagents list`	列出子代理
`openclaw cron list`	列出定時任務(wù)
`openclaw cron run <id>`	執(zhí)行定時任務(wù)
`openclaw uninstall`	卸載 Gateway 服務(wù)及數(shù)據(jù)	官方推薦
`openclaw uninstall --all --yes --non-interactive`	全自動卸載	狀態(tài) / workspace / 插件
`openclaw uninstall --state`	刪除狀態(tài)文件	不刪除 workspace
`openclaw uninstall --workspace`	刪除工作區(qū)	agent / workspace 數(shù)據(jù)
`openclaw uninstall --service`	僅卸載系統(tǒng)服務(wù)	不刪除數(shù)據(jù)
`openclaw uninstall --dry-run`	模擬卸載	僅展示結(jié)果