OpenClaw常用操作命令完整速查手冊：從入門到精通的終端 CLI & 聊天指令全解析
發(fā)布時間：2026-03-09 12:55:54 作者：佚名 
我要評論
我要評論作為 OpenClaw 生態(tài)（包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列開源應(yīng)用）的核心用戶，我根據(jù)開源資料和個人使用體驗整理了這份全網(wǎng)最全的命令速查手冊
作為 OpenClaw 生態(tài)（包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列開源應(yīng)用）的核心用戶，我根據(jù)開源資料和個人使用體驗整理了這份全網(wǎng)最全的命令速查手冊。無論你是剛接觸的新手，還是已經(jīng)玩轉(zhuǎn)過各種 AI Agent 的資深開發(fā)者，這份指南都能讓你：
? 5 分鐘快速定位任何操作指令
? 告別百度/Google反復(fù)搜索的低效循環(huán)
? 掌握高級技巧，讓 OpenClaw 成為你的超級生產(chǎn)力工具
建議立即收藏本文，下次遇到問題時直接 Ctrl+F 搜索，效率提升肉眼可見！
命令分類總覽
OpenClaw 的命令體系分為兩大核心類別：
| 類型 | 使用場景 | 輸入方式 |
|---|---|---|
| ??? 終端 CLI 命令 | 系統(tǒng)配置、服務(wù)管理、故障排查 | 在 Terminal / CMD / PowerShell 中輸入 |
| ?? 聊天斜杠命令 | 會話控制、模型切換、任務(wù)執(zhí)行 | 在 OpenClaw 對話窗口中輸入 / 開頭 |
第一部分：終端 CLI 命令詳解
所有 CLI 命令統(tǒng)一格式：openclaw <命令> [參數(shù)]
一、基礎(chǔ)操作（每日必用 ???）
| 命令 | 功能說明 | 典型使用場景 |
|---|---|---|
openclaw --version | 查看當(dāng)前安裝版本 | 確認(rèn)安裝成功或檢查是否需要更新 |
openclaw --help | 顯示所有可用命令列表 | 忘記具體命令時快速查閱 |
openclaw tui | 啟動終端交互界面 | **新手最推薦！**無需記憶復(fù)雜命令，圖形化操作 |
openclaw dashboard | 打開網(wǎng)頁管理控制臺 | 習(xí)慣瀏覽器操作的用戶首選 |
openclaw restart | 重啟 OpenClaw 服務(wù) | 修改配置后必須執(zhí)行！ |
openclaw stop | 停止運行中的服務(wù) | 臨時暫?；蜿P(guān)機(jī)前操作 |
openclaw update | 一鍵更新到最新版本 | 獲取新功能和安全補(bǔ)丁 |
?? Pro Tip：
openclaw tui是隱藏寶藏命令，提供可視化界面，比純命令行友好 10 倍！
二、安裝與初始化（首次使用必看）
| 命令 | 功能說明 | 進(jìn)階用法 |
|---|---|---|
openclaw onboard | 啟動交互式配置向?qū)?/strong> | 首次安裝后引導(dǎo)你完成所有設(shè)置 |
openclaw onboard --install-daemon | 配置向?qū)?+ 安裝為系統(tǒng)服務(wù) | 實現(xiàn)開機(jī)自啟，服務(wù)器部署必備 |
openclaw configure | 重新進(jìn)入配置向?qū)?/td> | 隨時修改 API Key、模型偏好等設(shè)置 |
?? 配置流程示例：
# 第1步：啟動向?qū)? openclaw onboard # 第2步：按提示輸入模型提供商（如 OpenAI/Claude/通義千問） # 第3步：輸入 API Key # 第4步：選擇默認(rèn)模型 # 第5步：完成！
三、診斷與排錯（出問題先跑這個 ???）
| 命令 | 功能說明 | 使用時機(jī) |
|---|---|---|
openclaw doctor | 全面健康檢查 | 遇到任何問題，先跑這個！ |
openclaw doctor --fix | 健康檢查 + 自動修復(fù) | 讓系統(tǒng)嘗試自動解決常見問題 |
openclaw status | 查看運行狀態(tài)（網(wǎng)關(guān)在線狀態(tài)、端口占用） | 檢查服務(wù)是否正常啟動 |
openclaw status --deep | 深度狀態(tài)檢測（含網(wǎng)關(guān)健康探測） | 網(wǎng)絡(luò)連接異常時深度排查 |
openclaw logs | 查看最近運行日志 | 查看錯誤堆棧信息 |
?? 故障排查標(biāo)準(zhǔn)流程：
# 第1步：全面體檢 openclaw doctor # 第2步：查看錯誤日志 openclaw logs # 第3步：檢查詳細(xì)狀態(tài) openclaw status --deep # 第4步：嘗試自動修復(fù) openclaw doctor --fix # 第5步：重啟服務(wù) openclaw restart
四、模型管理（多模型切換核心）
| 命令 | 功能說明 | 示例 |
|---|---|---|
openclaw models list | 列出所有已配置的模型 | 查看可用模型清單 |
openclaw models set <提供商/模型名> | 切換默認(rèn)模型 | 快速切換不同 AI 引擎 |
openclaw models auth login --provider <提供商> | OAuth 方式登錄模型商 | 支持 Claude、GPT、千問等 |
openclaw models auth paste-token --provider <提供商> | 粘貼 API Token 認(rèn)證 | 直接輸入 Key 認(rèn)證 |
?? 模型切換實戰(zhàn)示例：
# 切換到阿里百煉千問模型 openclaw models set bailian/qwen3-max-2026-01-23 # 切換到 MiniMax 模型 openclaw models set minimax/MiniMax-M2.1 # 切換到 Claude 3.5 Sonnet openclaw models set anthropic/claude-3-5-sonnet-20241022 # 查看當(dāng)前在用哪個模型 openclaw models list
五、網(wǎng)關(guān) Gateway 管理（核心引擎）
Gateway 是 OpenClaw 的心臟，負(fù)責(zé)所有通信調(diào)度。
| 命令 | 功能說明 | 適用場景 |
|---|---|---|
openclaw gateway | 啟動網(wǎng)關(guān)服務(wù) | 手動啟動網(wǎng)關(guān) |
openclaw gateway --port 18789 | 指定端口啟動 | 默認(rèn)端口被占用時 |
openclaw gateway --verbose | 啟動并顯示詳細(xì)日志 | 調(diào)試模式，排查連接問題 |
openclaw gateway restart | 重啟網(wǎng)關(guān) | 配置變更后生效 |
openclaw gateway --token <你的token> | 帶認(rèn)證 Token 啟動 | 安全加固場景 |
六、聊天通道 Channel 管理（對接微信/飛書/釘釘）
通道 = OpenClaw 與外部聊天平臺的橋梁。
| 命令 | 功能說明 | 備注 |
|---|---|---|
openclaw channels status | 查看所有通道實時狀態(tài) | 綠色=正常，紅色=異常 |
openclaw channels list | 列出已配置的所有通道 | 查看已接入的平臺 |
openclaw channels add | 交互式添加新通道 | 向?qū)脚渲?，新手友?/td> |
openclaw channels add --channel telegram --token <BOT_TOKEN> | 非交互式添加 Telegram | 自動化部署腳本使用 |
openclaw channels add --channel feishu | 添加飛書通道 | 需提前安裝 feishu 插件 |
openclaw channels remove --channel <名稱> | 移除指定通道 | 清理不再使用的連接 |
openclaw channels logs | 查看通道日志 | 排查消息收發(fā)問題 |
openclaw channels login | 登錄通道（如 WhatsApp Web 掃碼） | 需要交互認(rèn)證的平臺 |
openclaw channels logout | 登出通道 | 切換賬號或安全退出 |
?? 支持的平臺列表：
whatsapp | telegram | discord | slack | googlechat | signal | imessage | msteams | mattermost | feishu （需插件）
?? 快速接入飛書示例：
# 第1步：確保已啟用飛書插件 openclaw plugins enable feishu # 第2步：添加飛書通道（交互式） openclaw channels add --channel feishu # 第3步：按提示輸入 App ID 和 App Secret # 完成！
七、插件 Plugin 管理（功能擴(kuò)展）
| 命令 | 功能說明 |
|---|---|
openclaw plugins list | 查看所有可用插件 |
openclaw plugins enable <插件名> | 啟用指定插件 |
openclaw plugins disable <插件名> | 禁用指定插件 |
openclaw plugins install <插件名> | 從倉庫安裝新插件 |
openclaw plugins doctor | 檢查插件加載錯誤 |
?? 常用插件操作示例：
# 啟用飛書接入插件 openclaw plugins enable feishu # 啟用千問認(rèn)證插件（阿里系模型必備） openclaw plugins enable qwen-portal-auth # 登錄千問平臺并設(shè)為默認(rèn) openclaw models auth login --provider qwen-portal --set-default
八、技能 Skill 管理（AI 能力擴(kuò)展）
本地技能管理：
| 命令 | 功能說明 |
|---|---|
openclaw skills list | 列出已安裝的所有技能 |
openclaw skills install <技能名> | 安裝新技能 |
ClawHub 技能商店（社區(qū)生態(tài)）：
| 命令 | 功能說明 |
|---|---|
clawhub search <關(guān)鍵詞> | 搜索社區(qū)技能（如"爬蟲"、“數(shù)據(jù)分析”） |
clawhub install <技能名> | 安裝社區(qū)技能 |
clawhub list | 列出已安裝的技能 |
clawhub sync --all | 批量更新所有已安裝技能 |
clawhub update <技能名> | 更新指定技能到最新版 |
??? 技能管理實戰(zhàn)：
# 搜索數(shù)據(jù)分析相關(guān)技能 clawhub search data-analysis # 安裝找到的技能 clawhub install excel-analyzer # 更新所有技能 clawhub sync --all
九、消息與配對（高級操作）
| 命令 | 功能說明 | 使用場景 |
|---|---|---|
openclaw message send --to <號碼> --message "內(nèi)容" | 主動發(fā)送消息 | 系統(tǒng)通知、定時提醒 |
openclaw agent --message "任務(wù)內(nèi)容" | 直接向 Agent 派發(fā)任務(wù) | 后臺自動化任務(wù) |
openclaw agent --message "任務(wù)" --thinking high | 高思考深度模式 | 復(fù)雜推理任務(wù) |
openclaw pairing approve <通道> <配對碼> | 批準(zhǔn)設(shè)備配對 | 新設(shè)備接入授權(quán) |
十、沙箱 Sandbox 管理（安全隔離）
Docker 沙箱提供代碼執(zhí)行的安全隔離環(huán)境。
| 命令 | 功能說明 |
|---|---|
openclaw sandbox explain | 查看當(dāng)前沙箱配置狀態(tài) |
openclaw sandbox explain --json | JSON 格式輸出（供腳本解析） |
openclaw sandbox list | 列出所有沙箱容器 |
openclaw sandbox list --browser | 僅查看瀏覽器相關(guān)容器 |
openclaw sandbox recreate --all | 重建所有容器（解決環(huán)境問題） |
openclaw sandbox recreate --all --force | 強(qiáng)制重建（跳過確認(rèn)提示） |
十一、瀏覽器控制（自動化操作）
| 命令 | 功能說明 | 示例 |
|---|---|---|
openclaw browser open <URL> | 打開指定網(wǎng)頁 | openclaw browser open https://github.com |
openclaw browser snapshot | 獲取當(dāng)前頁面 DOM 快照 | 用于分析頁面結(jié)構(gòu) |
openclaw browser click <元素> | 點擊頁面元素 | 自動化測試/爬蟲 |
openclaw browser type <元素> <文字> | 在輸入框輸入文字 | 自動填寫表單 |
openclaw browser screenshot | 截取頁面截圖 | 保存可視化證據(jù) |
openclaw browser close | 關(guān)閉瀏覽器實例 | 清理資源 |
openclaw browser console | 查看瀏覽器控制臺日志 | 調(diào)試 JS 錯誤 |
十二、配置文件操作
| 命令 | 功能說明 |
|---|---|
openclaw config | 查看當(dāng)前配置（只讀） |
openclaw config edit | 編輯配置文件（自動打開編輯器） |
?? 手動編輯配置文件路徑：
# Windows 系統(tǒng) notepad %USERPROFILE%\.openclaw\openclaw.json # macOS 系統(tǒng) nano ~/.openclaw/openclaw.json # Linux 系統(tǒng) vim ~/.openclaw/openclaw.json # 快速查看配置內(nèi)容 cat ~/.openclaw/openclaw.json
十三、更新與維護(hù)
| 命令 | 功能說明 |
|---|---|
openclaw update | 更新到最新穩(wěn)定版 |
openclaw update --channel stable | 明確指定穩(wěn)定版通道 |
openclaw update --channel beta | 切換到測試版（體驗新功能） |
npm install -g openclaw@latest | 通過 npm 強(qiáng)制更新到最新版 |
第二部分：聊天斜杠命令詳解
在 OpenClaw 對話窗口中輸入，以 / 開頭。
一、會話管理（最常用 ???）
| 命令 | 功能說明 | 使用頻率 |
|---|---|---|
/new | 開始全新會話（清除上下文，節(jié)省 Token） | ??? |
/new 任務(wù)描述 | 新建會話并直接帶上任務(wù) | ??? |
/compact | 壓縮上下文（保留要點，大幅減少 Token 消耗） | ??? |
/status | 查看當(dāng)前會話狀態(tài)（Token 用量、模型信息） | ?? |
/help 或 /commands | 顯示所有可用斜杠命令 | ?? |
?? 使用技巧：
- 長對話后 Token 消耗劇增？輸入
/compact立即瘦身！ - 想換個話題？
/new一鍵清空，比手動刪除快 10 倍！
二、模型切換（多模型對比測試）
| 命令 | 功能說明 |
|---|---|
/model | 查看當(dāng)前正在使用的模型 |
/model <模型名> | 實時切換到指定模型 |
示例：
/model claude-3-5-sonnet /model gpt-4o /model qwen-max
三、會話歷史管理
| 命令 | 功能說明 |
|---|---|
/sessions list | 列出所有歷史會話 |
/sessions history | 查看當(dāng)前會話的詳細(xì)歷史 |
/sessions send <會話ID> <消息> | 向指定會話發(fā)送消息（跨會話通信） |
/sessions spawn <任務(wù)> | 創(chuàng)建子會話執(zhí)行獨立任務(wù) |
四、工具與執(zhí)行控制
| 命令 | 功能說明 | 使用場景 |
|---|---|---|
/approve | 批準(zhǔn)待確認(rèn)的操作 | Agent 請求權(quán)限時確認(rèn) |
/deny | 拒絕待確認(rèn)的操作 | 阻止危險操作 |
/cancel | 取消當(dāng)前執(zhí)行中的任務(wù) | 任務(wù)卡死或想中斷時 |
/undo | 撤銷上一步操作 | 誤操作回滾 |
五、技能與記憶管理
| 命令 | 功能說明 |
|---|---|
/skills | 查看當(dāng)前已加載的所有技能 |
/memory | 查看 AI 的記憶內(nèi)容（長期記憶） |
/forget <內(nèi)容> | 刪除指定的記憶條目 |
六、信息查詢
| 命令 | 功能說明 |
|---|---|
/cost | 查看本次會話的 Token 消耗和費用估算 |
/version | 查看當(dāng)前 OpenClaw 版本 |
/ping | 測試與網(wǎng)關(guān)的連接是否正常 |
第三部分：關(guān)鍵文件路徑速查表
| 路徑 | 說明 | 重要性 |
|---|---|---|
~/.openclaw/openclaw.json | 主配置文件（API Key、模型設(shè)置） | ??? |
~/.openclaw/workspace/ | 默認(rèn)工作目錄 | ?? |
~/.openclaw/skills/ | 全局技能存放目錄 | ?? |
~/.openclaw/agents/ | Agent 數(shù)據(jù)根目錄 | ?? |
~/.openclaw/agents/<ID>/USER.md | 用戶偏好文件（個性化設(shè)置） | ??? |
~/.openclaw/agents/<ID>/memory/ | 長期記憶存儲目錄 | ?? |
~/.openclaw/agents/<ID>/cron/jobs.json | 定時任務(wù)配置文件 | ? |
~/.openclaw/agents/<ID>/sessions/ | 會話記錄存檔 | ? |
~/.openclaw/workspace/AGENTS.md | 核心提示詞定義文件 | ??? |
?? Windows 用戶注意：
~等于%USERPROFILE%，即C:\Users\你的用戶名
第四部分：新手急救流程（遇到問題按這個來）
第1步：openclaw doctor ← 全面體檢，看哪里出問題
↓
第2步：openclaw logs ← 查看具體錯誤日志
↓
第3步：openclaw status --deep ← 深度檢查服務(wù)狀態(tài)
↓
第4步：openclaw doctor --fix ← 嘗試自動修復(fù)
↓
第5步：openclaw restart ← 重啟服務(wù)? 改配置后的標(biāo)準(zhǔn)操作流程：
# 1. 編輯配置文件 nano ~/.openclaw/openclaw.json # 2. 保存退出 (Ctrl+O, Enter, Ctrl+X) # 3. 重啟服務(wù)使配置生效 openclaw restart
?? 完全重新配置：
openclaw configure # 重新走一遍配置向?qū)?/pre>
第五部分：必備命令大全速記法（建議收藏）
?? 高頻命令速記（每天使用）
| 場景 | 命令 | 記憶口訣 |
|---|---|---|
| 開始聊天 | openclaw tui | Terminal User Interface |
| 查看狀態(tài) | openclaw status | "狀態(tài)"拼音首字母 |
| 檢查健康 | openclaw doctor | 醫(yī)生檢查身體 |
| 重啟服務(wù) | openclaw restart | 重新啟動 |
| 新建會話 | /new | 新的開始 |
| 壓縮上下文 | /compact | 壓縮包 compact |
??? 故障排查速記
| 順序 | 命令 | 作用 |
|---|---|---|
| 1 | openclaw doctor | 看病 |
| 2 | openclaw logs | 查病歷 |
| 3 | openclaw status | 量體溫 |
| 4 | openclaw restart | 吃藥重啟 |
| 5 | openclaw doctor --fix | 自動治療 |
?? 通道管理速記
| 操作 | 命令模式 | 示例 |
|---|---|---|
| 查看 | channels status/list | 看狀態(tài)/看列表 |
| 添加 | channels add --channel <平臺> | 加通道 |
| 移除 | channels remove --channel <名> | 刪通道 |
?? 模型管理速記
| 操作 | 命令 | 記憶點 |
|---|---|---|
| 查看列表 | models list | 列模型 |
| 切換模型 | models set <模型> | 設(shè)模型 |
| 登錄認(rèn)證 | models auth login | 認(rèn)證登錄 |
?? 插件技能速記
| 類型 | 啟用 | 禁用 | 安裝 |
|---|---|---|---|
| 插件 | plugins enable | plugins disable | plugins install |
| 技能 | - | - | skills install / clawhub install |
?? 聊天命令速記
| 功能 | 命令 | 使用時機(jī) |
|---|---|---|
| 新開對話 | /new | 話題切換 |
| 瘦身省 Token | /compact | 對話太長 |
| 查看狀態(tài) | /status | 想看用量 |
| 確認(rèn)操作 | /approve | Agent 詢問 |
| 拒絕操作 | /deny | 阻止執(zhí)行 |
結(jié)語：成為 OpenClaw 高手的下一步
恭喜你讀完了這份全網(wǎng)最全的 OpenClaw 命令手冊！現(xiàn)在你已經(jīng)掌握了：
? 100+ 個常用命令的詳細(xì)用法
? 故障排查的標(biāo)準(zhǔn)流程? 多模型切換的實戰(zhàn)技巧? 微信/飛書/釘釘接入的完整路徑? Token 節(jié)省的高級玩法
但這只是開始！OpenClaw 生態(tài)（PicoClaw、ZeroClaw、losterAI、EasyClaw 等）還在快速迭代，建議：
- 收藏本文，遇到問題第一時間查閱
- 加入社區(qū)，關(guān)注 GitHub Releases 獲取更新
- 實踐出真知，把上面的命令都敲一遍，形成肌肉記憶
相關(guān)文章
本文檔提供了OpenClaw CLI命令的速查手冊，包含初始化配置、診斷維護(hù)和網(wǎng)關(guān)管理三大類命令,文中介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友2026-03-26
