OpenClaw CLI的全部命令及其使用方法
我要評(píng)論摘要
本文是 OpenClaw 命令行工具的完整參考手冊，系統(tǒng)性地介紹了 OpenClaw CLI 的全部命令及其使用方法。文章從安裝驗(yàn)證開始，逐步深入講解 Gateway 網(wǎng)關(guān)管理、Status 狀態(tài)查詢、Config 配置管理、Sessions 會(huì)話控制、Skills 技能系統(tǒng)、Nodes 節(jié)點(diǎn)管理、Logs 日志查看、Doctor 診斷工具等核心命令。通過豐富的代碼示例、流程圖和實(shí)戰(zhàn)場景，幫助開發(fā)者快速掌握 OpenClaw 的運(yùn)維管理技能。無論你是初次接觸 OpenClaw 的新手，還是需要深入定制的高級(jí)用戶，本文都將是你不可或缺的案頭參考。
1. 引言
在現(xiàn)代 AI Agent 開發(fā)領(lǐng)域，命令行工具扮演著至關(guān)重要的角色。一個(gè)設(shè)計(jì)良好的 CLI 不僅能提升開發(fā)效率，還能讓運(yùn)維管理變得更加輕松。OpenClaw 作為新一代 AI Agent 框架，提供了一套功能完備、設(shè)計(jì)優(yōu)雅的命令行工具，覆蓋了從安裝部署到日常運(yùn)維的全生命周期管理。
OpenClaw CLI 的設(shè)計(jì)理念是"簡單的事情簡單做，復(fù)雜的事情也能做"。對(duì)于日常操作，一條命令即可完成；對(duì)于高級(jí)需求，豐富的參數(shù)選項(xiàng)提供了足夠的靈活性。這種設(shè)計(jì)使得新手能夠快速上手，同時(shí)不限制高級(jí)用戶的定制需求。
本文將按照由淺入深的順序，全面介紹 OpenClaw CLI 的各項(xiàng)功能。每個(gè)命令都配有詳細(xì)的參數(shù)說明、使用示例和注意事項(xiàng)，確保讀者能夠真正理解并應(yīng)用到實(shí)際工作中。
2. OpenClaw CLI 概述與安裝驗(yàn)證
2.1 什么是 OpenClaw CLI
OpenClaw CLI（Command Line Interface）是 OpenClaw 框架的官方命令行管理工具。它提供了對(duì) OpenClaw 系統(tǒng)的全生命周期管理能力，包括服務(wù)啟停、配置管理、會(huì)話監(jiān)控、技能管理、節(jié)點(diǎn)控制等功能。
作為一個(gè)本地自托管的 AI Agent 框架，OpenClaw 強(qiáng)調(diào)用戶對(duì)系統(tǒng)的完全控制權(quán)。CLI 正是這種理念的體現(xiàn)——所有操作都在本地執(zhí)行，數(shù)據(jù)不離開你的服務(wù)器，隱私和安全完全掌握在自己手中。
2.2 安裝與環(huán)境要求
在開始使用 OpenClaw CLI 之前，需要確保系統(tǒng)滿足以下環(huán)境要求：
| 環(huán)境要求 | 最低配置 | 推薦配置 |
|---|---|---|
| 操作系統(tǒng) | Linux / macOS / Windows WSL | Linux (Ubuntu 22.04+) |
| Node.js | v18.0.0+ | v22.0.0+ LTS |
| 內(nèi)存 | 2GB | 4GB+ |
| 磁盤空間 | 1GB | 5GB+ |
| 網(wǎng)絡(luò) | 能訪問 AI 模型 API | 穩(wěn)定的網(wǎng)絡(luò)連接 |
安裝 OpenClaw 非常簡單，只需一條 npm 命令：
# 全局安裝 OpenClaw npm install -g @openclaw/cli # 或者使用 yarn yarn global add @openclaw/cli # 或者使用 pnpm pnpm add -g @openclaw/cli # 驗(yàn)證安裝 openclaw --version # 輸出: ?? OpenClaw 2026.2.26
上述安裝命令會(huì)將 OpenClaw CLI 安裝到全局環(huán)境，使其可以在任意目錄下直接調(diào)用。安裝過程會(huì)自動(dòng)處理依賴關(guān)系，包括核心運(yùn)行時(shí)、工具鏈和必要的系統(tǒng)組件。
2.3 驗(yàn)證安裝
安裝完成后，首先需要驗(yàn)證安裝是否成功。OpenClaw CLI 提供了多種方式來確認(rèn)安裝狀態(tài)：
# 查看版本信息 openclaw --version # 輸出示例： # ?? OpenClaw 2026.2.26 (unknown) — Gateway online # 查看幫助信息 openclaw --help # 輸出所有可用命令和全局選項(xiàng) # 查看詳細(xì)系統(tǒng)信息 openclaw doctor # 執(zhí)行系統(tǒng)診斷，檢查所有依賴項(xiàng)
版本命令會(huì)顯示 CLI 版本、Node.js 版本和操作系統(tǒng)信息，這是確認(rèn)安裝成功最直接的方式。幫助命令則列出所有可用命令，方便快速查閱。doctor 命令會(huì)執(zhí)行全面的系統(tǒng)診斷，檢查配置文件、網(wǎng)絡(luò)連接、模型 API 等是否正常。
3. 命令結(jié)構(gòu)總覽
3.1 層級(jí)命令體系
OpenClaw CLI 采用層級(jí)化的命令結(jié)構(gòu)，主命令 openclaw 下設(shè)多個(gè)子命令，每個(gè)子命令又可以有進(jìn)一步的子命令和選項(xiàng)。這種設(shè)計(jì)使得命令組織清晰，功能邊界明確。
上圖展示了 OpenClaw CLI 的主要命令層級(jí)結(jié)構(gòu)?？梢钥吹剑琯ateway、config、sessions、skills、nodes 等命令都有各自的子命令，形成了一個(gè)完整的命令樹。帶有 * 標(biāo)記的命令表示它們還有更深層的子命令。
3.2 全局選項(xiàng)
除了各命令的特定參數(shù)外，OpenClaw CLI 還提供了一系列全局選項(xiàng)，可以在任何命令前使用：
| 選項(xiàng) | 說明 |
|---|---|
--dev | 開發(fā)模式：使用 ~/.openclaw-dev 目錄隔離狀態(tài)，默認(rèn)端口 19001 |
-h, --help | 顯示命令幫助信息 |
--log-level <level> | 日志級(jí)別覆蓋（silent/fatal/error/warn/info/debug/trace） |
--no-color | 禁用彩色輸出 |
--profile <name> | 使用命名配置文件（隔離狀態(tài)目錄） |
-V, --version | 顯示版本信息 |
全局選項(xiàng)的使用示例：
# 開發(fā)模式啟動(dòng) Gateway openclaw --dev gateway run # 指定日志級(jí)別 openclaw --log-level debug gateway status # 使用命名配置 openclaw --profile production gateway start
全局選項(xiàng)為命令提供了額外的控制能力，在腳本自動(dòng)化和日志分析場景中特別有用。
4. Gateway 網(wǎng)關(guān)命令
4.1 Gateway 概述
Gateway（網(wǎng)關(guān)）是 OpenClaw 系統(tǒng)的核心組件，負(fù)責(zé)處理所有消息渠道的接入和路由。它作為一個(gè)常駐后臺(tái)服務(wù)運(yùn)行，接收來自 Telegram、飛書、Discord 等平臺(tái)的消息，并將其分發(fā)給對(duì)應(yīng)的 Agent 進(jìn)行處理。
Gateway 命令提供了對(duì)網(wǎng)關(guān)服務(wù)的完整生命周期管理，包括啟動(dòng)、停止、重啟和狀態(tài)查詢。熟練掌握這些命令是運(yùn)維 OpenClaw 系統(tǒng)的基礎(chǔ)。
4.2 Gateway 子命令一覽
| 子命令 | 說明 |
|---|---|
run | 前臺(tái)運(yùn)行 Gateway（開發(fā)調(diào)試用） |
start | 啟動(dòng) Gateway 服務(wù)（systemd/launchd） |
stop | 停止 Gateway 服務(wù) |
restart | 重啟 Gateway 服務(wù) |
status | 查看服務(wù)狀態(tài)和可達(dá)性 |
health | 獲取 Gateway 健康狀態(tài) |
install | 安裝 Gateway 系統(tǒng)服務(wù) |
uninstall | 卸載 Gateway 系統(tǒng)服務(wù) |
discover | 通過 Bonjour 發(fā)現(xiàn) Gateway |
probe | 顯示 Gateway 可達(dá)性和發(fā)現(xiàn)狀態(tài) |
call | 直接調(diào)用 Gateway RPC 方法 |
usage-cost | 獲取使用成本統(tǒng)計(jì) |
4.3 啟動(dòng)網(wǎng)關(guān)
# 前臺(tái)運(yùn)行（開發(fā)調(diào)試） openclaw gateway run # 后臺(tái)啟動(dòng)系統(tǒng)服務(wù) openclaw gateway start # 指定端口和認(rèn)證模式 openclaw gateway run --port 18789 --auth token --token my-secret-token # 強(qiáng)制啟動(dòng)（殺死占用端口的進(jìn)程） openclaw gateway run --force # 開發(fā)模式（隔離配置） openclaw --dev gateway run # 綁定到局域網(wǎng) openclaw gateway run --bind lan # 通過 Tailscale 暴露 openclaw gateway run --tailscale serve
啟動(dòng)命令的常用參數(shù)說明：
| 參數(shù) | 說明 | 默認(rèn)值 |
|---|---|---|
--port <port> | 監(jiān)聽端口 | 18789（開發(fā)模式 19001） |
--auth <mode> | 認(rèn)證模式（none/token/password/trusted-proxy） | token |
--token <token> | 認(rèn)證令牌 | 環(huán)境變量 OPENCLAW_GATEWAY_TOKEN |
--bind <mode> | 綁定模式（loopback/lan/tailnet/auto/custom） | loopback |
--force | 強(qiáng)制啟動(dòng)，殺死占用端口的進(jìn)程 | false |
--verbose | 詳細(xì)日志輸出 | false |
--tailscale <mode> | Tailscale 暴露模式（off/serve/funnel） | off |
4.4 停止與重啟
# 停止網(wǎng)關(guān)服務(wù) openclaw gateway stop # 重啟網(wǎng)關(guān)服務(wù) openclaw gateway restart # 查看服務(wù)狀態(tài) openclaw gateway status
4.5 Gateway 運(yùn)行流程
上述時(shí)序圖展示了 Gateway 啟動(dòng)的完整流程。CLI 首先加載配置，檢查端口占用情況，然后啟動(dòng) Gateway 服務(wù)并初始化消息渠道和技能系統(tǒng)。
5. Status 狀態(tài)命令
5.1 系統(tǒng)狀態(tài)概覽
Status 命令提供了 OpenClaw 系統(tǒng)的整體運(yùn)行狀態(tài)視圖，包括 Gateway 狀態(tài)、活躍會(huì)話、資源使用等關(guān)鍵指標(biāo)。這是了解系統(tǒng)健康狀況的第一入口。
# 查看系統(tǒng)狀態(tài) openclaw status # 輸出示例： # Gateway: online # Channels: telegram ?, feishu ?, discord ? # Sessions: 3 active # Model: gpt-4o-mini (default)
狀態(tài)輸出采用可視化的表格形式，一目了然地展示系統(tǒng)各組件的運(yùn)行情況。綠色勾號(hào)表示正常，紅色叉號(hào)表示異?；蛭磫⒂?。
5.2 詳細(xì)狀態(tài)選項(xiàng)
# 完整診斷（只讀，可粘貼分享） openclaw status --all # 深度探測消息渠道 openclaw status --deep # 顯示模型使用配額 openclaw status --usage # 以 JSON 格式輸出 openclaw status --json # 設(shè)置探測超時(shí) openclaw status --deep --timeout 5000
JSON 格式輸出特別適合在監(jiān)控腳本中使用，可以通過 jq 等工具進(jìn)行解析：
# 獲取 Gateway 狀態(tài) openclaw status --json | jq '.gateway.status' # 獲取活躍會(huì)話數(shù) openclaw status --json | jq '.sessions.active'
5.3 Status 命令參數(shù)
| 參數(shù) | 說明 |
|---|---|
--all | 完整診斷輸出（只讀，便于分享） |
--deep | 深度探測消息渠道（WhatsApp/Telegram/Discord/Slack/Signal） |
--json | JSON 格式輸出 |
--timeout <ms> | 探測超時(shí)時(shí)間（毫秒） |
--usage | 顯示模型提供商使用配額 |
--verbose | 詳細(xì)日志 |
6. Config 配置管理命令
6.1 配置文件結(jié)構(gòu)
OpenClaw 的配置采用 YAML 格式，默認(rèn)位于 ~/.openclaw/openclaw.json。配置文件包含 Gateway、模型、渠道、技能等多個(gè)部分的設(shè)置。
# OpenClaw 配置文件示例
{
"gateway": {
"mode": "local",
"port": 18789,
"bind": "loopback",
"auth": "token"
},
"model": {
"default": "gpt-4o-mini",
"reasoning": "o1-mini"
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "${TELEGRAM_BOT_TOKEN}"
},
"feishu": {
"enabled": true,
"appId": "${FEISHU_APP_ID}",
"appSecret": "${FEISHU_APP_SECRET}"
}
},
"agents": {
"defaults": {
"workspace": "~/.openclaw/workspace"
}
}
}上述配置文件展示了 OpenClaw 的主要配置項(xiàng)。使用環(huán)境變量（如 ${TELEGRAM_BOT_TOKEN}）可以避免在配置文件中硬編碼敏感信息，這是推薦的安全實(shí)踐。
6.2 配置管理命令
# 交互式配置向?qū)? openclaw configure # 獲取配置值 openclaw config get gateway.port openclaw config get model.default # 設(shè)置配置值 openclaw config set gateway.port 19000 openclaw config set model.default "gpt-4o" # 刪除配置值 openclaw config unset channels.discord.enabled # 指定配置部分運(yùn)行向?qū)? openclaw config --section gateway --section model
配置命令提供了對(duì)配置文件的完整管理能力。config get 和 config set 支持點(diǎn)號(hào)路徑訪問嵌套配置，非常直觀。
6.3 Config 命令詳解
| 命令 | 說明 | 示例 |
|---|---|---|
config get <path> | 獲取配置值 | openclaw config get gateway.port |
config set <path> <value> | 設(shè)置配置值 | openclaw config set gateway.port 19000 |
config unset <path> | 刪除配置值 | openclaw config unset channels.discord |
配置路徑支持點(diǎn)號(hào)和方括號(hào)兩種語法：
# 點(diǎn)號(hào)語法 openclaw config get gateway.port # 方括號(hào)語法（用于數(shù)組或特殊鍵名） openclaw config get "channels[0].name"
7. Sessions 會(huì)話控制命令
7.1 會(huì)話概念
在 OpenClaw 中，Session（會(huì)話）代表一個(gè)獨(dú)立的對(duì)話上下文。每次用戶與 Agent 開始對(duì)話，系統(tǒng)都會(huì)創(chuàng)建或關(guān)聯(lián)一個(gè)會(huì)話。會(huì)話管理命令讓你能夠查看、監(jiān)控和管理這些對(duì)話。
會(huì)話的設(shè)計(jì)使得同一個(gè) Agent 可以同時(shí)處理多個(gè)用戶的對(duì)話，每個(gè)對(duì)話都有獨(dú)立的上下文和歷史記錄。這對(duì)于多用戶場景和長期運(yùn)行的服務(wù)非常重要。
7.2 會(huì)話管理命令
# 列出所有會(huì)話 openclaw sessions # 輸出示例： # Session ID Channel Recipient Updated # sess_abc123... telegram user_001 2h ago # sess_def456... feishu user_002 1d ago # 僅顯示最近活躍的會(huì)話 openclaw sessions --active 120 # 指定 Agent 查看 openclaw sessions --agent work # 聚合所有 Agent 的會(huì)話 openclaw sessions --all-agents # JSON 格式輸出 openclaw sessions --json # 運(yùn)行會(huì)話存儲(chǔ)維護(hù) openclaw sessions cleanup
7.3 Sessions 命令參數(shù)
| 參數(shù) | 說明 |
|---|---|
--active <minutes> | 僅顯示最近 N 分鐘內(nèi)更新的會(huì)話 |
--agent <id> | 指定 Agent ID |
--all-agents | 聚合所有 Agent 的會(huì)話 |
--json | JSON 格式輸出 |
--store <path> | 指定會(huì)話存儲(chǔ)路徑 |
--verbose | 詳細(xì)日志 |
會(huì)話列表會(huì)顯示 Token 使用量（如果 Agent 報(bào)告），可以通過設(shè)置 agents.defaults.contextTokens 來限制上下文窗口大小。
8. Skills 技能系統(tǒng)命令
8.1 Skill 系統(tǒng)概述
Skill（技能）是 OpenClaw 的核心擴(kuò)展機(jī)制。每個(gè)技能定義了一組特定的能力和行為，Agent 可以根據(jù)用戶請求動(dòng)態(tài)調(diào)用相關(guān)技能。技能系統(tǒng)讓 OpenClaw 能夠靈活地適應(yīng)各種應(yīng)用場景。
OpenClaw 提供了豐富的官方技能庫，同時(shí)也支持用戶自定義開發(fā)技能。Skill 命令提供了對(duì)技能的完整生命周期管理。
8.2 技能管理命令
# 列出已安裝技能 openclaw skills list # 輸出示例： # Name Description # weather 天氣查詢與預(yù)報(bào) # translator 多語言翻譯 # calendar 日程管理 # web-search 網(wǎng)絡(luò)搜索 # 查看技能詳情 openclaw skills info weather # 檢查技能狀態(tài) openclaw skills check # 輸出示例： # ? weather: ready # ? translator: ready # ? custom-helper: missing requirements
8.3 技能開發(fā)流程
上述流程圖展示了技能開發(fā)的完整流程：從創(chuàng)建目錄到部署使用，每個(gè)環(huán)節(jié)都有對(duì)應(yīng)的 CLI 命令支持。
9. Nodes 節(jié)點(diǎn)管理命令
9.1 節(jié)點(diǎn)系統(tǒng)介紹
Node（節(jié)點(diǎn)）是 OpenClaw 的分布式擴(kuò)展機(jī)制。通過節(jié)點(diǎn)系統(tǒng)，OpenClaw 可以連接和控制遠(yuǎn)程設(shè)備，實(shí)現(xiàn)跨設(shè)備的協(xié)同工作。典型應(yīng)用場景包括：連接手機(jī)發(fā)送通知、控制智能家居設(shè)備、訪問遠(yuǎn)程攝像頭等。
節(jié)點(diǎn)系統(tǒng)采用配對(duì)機(jī)制，確保只有授權(quán)的設(shè)備才能連接。每個(gè)節(jié)點(diǎn)都有唯一標(biāo)識(shí)和權(quán)限配置。
9.2 節(jié)點(diǎn)管理命令
# 列出節(jié)點(diǎn)狀態(tài) openclaw nodes status # 輸出示例： # ID Name Platform Status Last Seen # node_001 我的手機(jī) android online 2m ago # node_002 工作電腦 mac online 1h ago # 列出待審批的配對(duì)請求 openclaw nodes pending # 批準(zhǔn)配對(duì)請求 openclaw nodes approve <request-id> # 拒絕配對(duì)請求 openclaw nodes reject <request-id> # 查看節(jié)點(diǎn)詳情 openclaw nodes describe node_001 # 重命名節(jié)點(diǎn) openclaw nodes rename node_001 --name "我的手機(jī)"
9.3 節(jié)點(diǎn)高級(jí)功能
節(jié)點(diǎn)系統(tǒng)支持豐富的高級(jí)功能，如攝像頭訪問、屏幕錄制、位置獲取等：
# 拍照 openclaw nodes camera snap --node node_001 --facing back # 錄制屏幕 openclaw nodes screen record --node node_002 --duration 10 # 獲取位置 openclaw nodes location --node node_001 # 發(fā)送通知 openclaw nodes notify --node node_001 --title "測試" --body "消息內(nèi)容" # 在節(jié)點(diǎn)上執(zhí)行命令（僅 Mac） openclaw nodes run --node node_002 --command "uname -a" # 調(diào)用節(jié)點(diǎn)命令 openclaw nodes invoke --node node_001 --command <cmd>
9.4 Nodes 子命令一覽
| 子命令 | 說明 |
|---|---|
status | 列出節(jié)點(diǎn)狀態(tài)和能力 |
list | 列出待審批和已配對(duì)節(jié)點(diǎn) |
pending | 列出待審批配對(duì)請求 |
approve | 批準(zhǔn)配對(duì)請求 |
reject | 拒絕配對(duì)請求 |
describe | 查看節(jié)點(diǎn)詳情 |
rename | 重命名節(jié)點(diǎn) |
notify | 發(fā)送本地通知 |
camera | 攝像頭操作 |
screen | 屏幕錄制 |
location | 獲取位置 |
run | 執(zhí)行命令（僅 Mac） |
invoke | 調(diào)用節(jié)點(diǎn)命令 |
10. Logs 日志查看命令
10.1 日志系統(tǒng)概述
日志是診斷和排查問題的重要依據(jù)。OpenClaw 提供了完善的日志系統(tǒng)，記錄所有關(guān)鍵操作和事件。Logs 命令提供了便捷的日志查看和分析能力。
10.2 日志查看命令
# 查看最新日志 openclaw logs # 實(shí)時(shí)跟蹤日志 openclaw logs --follow # 限制行數(shù) openclaw logs --limit 100 # JSON 格式輸出 openclaw logs --json # 顯示本地時(shí)間 openclaw logs --local-time # 禁用顏色 openclaw logs --no-color # 純文本輸出 openclaw logs --plain
10.3 Logs 命令參數(shù)
| 參數(shù) | 說明 | 默認(rèn)值 |
|---|---|---|
--follow | 實(shí)時(shí)跟蹤日志 | false |
--interval <ms> | 輪詢間隔 | 1000 |
--json | JSON 格式輸出 | false |
--limit <n> | 最大行數(shù) | 200 |
--local-time | 顯示本地時(shí)間 | false |
--max-bytes <n> | 最大字節(jié)數(shù) | 250000 |
--no-color | 禁用顏色 | false |
--plain | 純文本輸出 | false |
--timeout <ms> | 超時(shí)時(shí)間 | 30000 |
--token <token> | Gateway 令牌 | - |
--url <url> | Gateway WebSocket URL | - |
11. Doctor 診斷工具命令
11.1 Doctor 功能介紹
Doctor 命令是 OpenClaw 的系統(tǒng)診斷工具，能夠自動(dòng)檢測系統(tǒng)配置、依賴項(xiàng)、網(wǎng)絡(luò)連接等各方面的潛在問題。當(dāng)遇到問題時(shí)，首先運(yùn)行 doctor 命令往往能快速定位原因。
11.2 診斷命令使用
# 運(yùn)行完整診斷 openclaw doctor # 輸出示例： # ? Node.js version: v22.22.0 (supported) # ? OpenClaw CLI: 2026.2.26 # ? Configuration file: valid # ? Gateway: running # ? Model API: connected # ? Telegram channel: configured # ? Discord channel: not configured # ? Skills: 1 skill has errors # 自動(dòng)修復(fù)問題 openclaw doctor --fix # 非交互模式 openclaw doctor --non-interactive # 深度掃描（檢查系統(tǒng)服務(wù)） openclaw doctor --deep # 生成 Gateway 令牌 openclaw doctor --generate-gateway-token
11.3 Doctor 檢查項(xiàng)
| 檢查項(xiàng) | 說明 |
|---|---|
| Node.js 版本 | 是否滿足最低要求 |
| CLI 版本 | 是否為最新版本 |
| 配置文件 | 語法是否正確，必填項(xiàng)是否完整 |
| Gateway 狀態(tài) | 是否正常運(yùn)行 |
| 模型 API | 是否能正常連接和調(diào)用 |
| 渠道配置 | 各消息渠道是否正確配置 |
| 技能狀態(tài) | 是否有加載失敗的技能 |
| 系統(tǒng)服務(wù) | 是否有多個(gè) Gateway 安裝 |
11.4 Doctor 參數(shù)說明
| 參數(shù) | 說明 |
|---|---|
--deep | 深度掃描系統(tǒng)服務(wù) |
--fix | 自動(dòng)修復(fù)問題 |
--force | 強(qiáng)制修復(fù)（覆蓋自定義配置） |
--generate-gateway-token | 生成并配置 Gateway 令牌 |
--non-interactive | 非交互模式 |
--no-workspace-suggestions | 禁用工作區(qū)建議 |
--yes | 接受默認(rèn)值 |
12. 其他重要命令
12.1 Channels 渠道管理
Channels 命令用于管理消息渠道的連接和認(rèn)證：
# 列出已配置渠道 openclaw channels list # 查看渠道狀態(tài) openclaw channels status --probe # 登錄渠道（如 WhatsApp Web） openclaw channels login --channel whatsapp # 登出渠道 openclaw channels logout --channel whatsapp # 添加渠道配置 openclaw channels add --channel telegram --token <token> # 移除渠道 openclaw channels remove --channel discord # 查看渠道日志 openclaw channels logs --channel telegram # 解析用戶/群組 ID openclaw channels resolve --channel telegram --query "username"
12.2 Models 模型管理
Models 命令用于管理 AI 模型配置：
# 列出可用模型 openclaw models list # 查看模型狀態(tài) openclaw models status # 設(shè)置默認(rèn)模型 openclaw models set gpt-4o # 設(shè)置圖像模型 openclaw models set-image dall-e-3 # 掃描 OpenRouter 免費(fèi)模型 openclaw models scan # 管理模型別名 openclaw models aliases # 管理認(rèn)證配置 openclaw models auth # 管理回退模型列表 openclaw models fallbacks
12.3 Agents 代理管理
Agents 命令用于管理隔離的 Agent 實(shí)例：
# 列出已配置 Agent openclaw agents list # 添加新 Agent openclaw agents add --id work --workspace ~/work-agent # 刪除 Agent openclaw agents delete work # 設(shè)置 Agent 身份 openclaw agents set-identity work --name "工作助手" --emoji "??" # 管理路由綁定 openclaw agents bind --agent work --channel telegram --target @mygroup openclaw agents unbind --agent work --channel telegram openclaw agents bindings
12.4 Setup 與 Onboard
初始化和引導(dǎo)命令：
# 初始化配置和工作區(qū) openclaw setup # 交互式引導(dǎo)向?qū)? openclaw onboard # 非交互模式 openclaw setup --non-interactive # 遠(yuǎn)程模式 openclaw setup --mode remote --remote-url wss://gateway.example.com
13. 實(shí)戰(zhàn)場景示例
13.1 場景一：從零搭建 OpenClaw 服務(wù)
以下是一個(gè)完整的從零搭建流程，展示了如何使用 CLI 命令快速部署：
#!/bin/bash
# OpenClaw 快速部署腳本
# 1. 安裝 OpenClaw
npm install -g @openclaw/cli
# 2. 初始化配置
openclaw setup --mode local
# 3. 配置模型 API
openclaw config set model.default "gpt-4o-mini"
openclaw config set model.apiKey "${OPENAI_API_KEY}"
# 4. 配置 Telegram 渠道
openclaw channels add --channel telegram --token "${TELEGRAM_BOT_TOKEN}"
# 5. 安裝 Gateway 服務(wù)
openclaw gateway install
# 6. 啟動(dòng)服務(wù)
openclaw gateway start
# 7. 驗(yàn)證狀態(tài)
openclaw status --all
# 8. 運(yùn)行診斷
openclaw doctor上述腳本展示了從安裝到啟動(dòng)的完整流程。每個(gè)步驟都有對(duì)應(yīng)的 CLI 命令，整個(gè)過程可以完全自動(dòng)化。
13.2 場景二：健康檢查與告警腳本
以下腳本展示了如何使用 CLI 構(gòu)建健康監(jiān)控系統(tǒng)：
#!/bin/bash
# OpenClaw 健康檢查腳本
# 檢查 Gateway 是否運(yùn)行
GATEWAY_STATUS=$(openclaw gateway status --json 2>/dev/null | jq -r '.status')
if [ "$GATEWAY_STATUS" != "running" ]; then
echo "Gateway not running, attempting to start..."
openclaw gateway start
sleep 5
# 再次檢查
GATEWAY_STATUS=$(openclaw gateway status --json 2>/dev/null | jq -r '.status')
if [ "$GATEWAY_STATUS" != "running" ]; then
echo "Failed to start Gateway"
# 發(fā)送告警通知
openclaw nodes notify --node node_001 --title "OpenClaw Alert" --body "Gateway 啟動(dòng)失敗"
exit 1
fi
fi
# 檢查渠道狀態(tài)
CHANNEL_ERRORS=$(openclaw status --deep --json 2>/dev/null | jq '[.channels[] | select(.status != "ok")] | length')
if [ "$CHANNEL_ERRORS" -gt 0 ]; then
echo "Channel errors detected: $CHANNEL_ERRORS"
openclaw nodes notify --node node_001 --title "OpenClaw Alert" --body "檢測到 $CHANNEL_ERRORS 個(gè)渠道異常"
fi
# 檢查錯(cuò)誤日志
ERROR_COUNT=$(openclaw logs --level error --limit 1000 2>/dev/null | grep -c "error")
if [ "$ERROR_COUNT" -gt 10 ]; then
echo "High error rate: $ERROR_COUNT errors"
fi
# 清理過期會(huì)話
openclaw sessions cleanup
echo "Health check completed at $(date)"這個(gè)腳本展示了如何組合使用多個(gè) CLI 命令構(gòu)建完整的健康檢查流程：檢查服務(wù)狀態(tài)、監(jiān)控渠道健康、統(tǒng)計(jì)錯(cuò)誤日志、清理過期數(shù)據(jù)，并在異常時(shí)發(fā)送通知。
13.3 場景三：多環(huán)境配置管理
使用 Profile 功能管理多個(gè)環(huán)境：
# 開發(fā)環(huán)境 openclaw --profile dev config set gateway.port 19001 openclaw --profile dev config set model.default "gpt-4o-mini" openclaw --profile dev gateway run # 生產(chǎn)環(huán)境 openclaw --profile prod config set gateway.port 18789 openclaw --profile prod config set model.default "gpt-4o" openclaw --profile prod gateway start # 測試環(huán)境 openclaw --profile test config set gateway.port 19002 openclaw --profile test gateway run
每個(gè) Profile 都有獨(dú)立的配置目錄（~/.openclaw-<name>），可以輕松切換不同環(huán)境。
14. 命令速查表
以下是 OpenClaw CLI 的常用命令速查表，方便快速查閱：
| 命令 | 說明 | 示例 |
|---|---|---|
openclaw --version | 查看版本 | openclaw -V |
openclaw gateway run | 前臺(tái)運(yùn)行網(wǎng)關(guān) | openclaw gateway run --port 18789 |
openclaw gateway start | 啟動(dòng)網(wǎng)關(guān)服務(wù) | openclaw gateway start |
openclaw gateway stop | 停止網(wǎng)關(guān)服務(wù) | openclaw gateway stop |
openclaw gateway status | 查看網(wǎng)關(guān)狀態(tài) | openclaw gateway status |
openclaw status | 查看系統(tǒng)狀態(tài) | openclaw status --deep |
openclaw config get | 獲取配置值 | openclaw config get gateway.port |
openclaw config set | 設(shè)置配置值 | openclaw config set gateway.port 19000 |
openclaw sessions | 列出會(huì)話 | openclaw sessions --active 120 |
openclaw skills list | 列出技能 | openclaw skills list |
openclaw skills info | 查看技能詳情 | openclaw skills info weather |
openclaw nodes status | 列出節(jié)點(diǎn)狀態(tài) | openclaw nodes status |
openclaw nodes notify | 發(fā)送通知 | openclaw nodes notify --node xxx --title "Hello" |
openclaw logs | 查看日志 | openclaw logs --follow |
openclaw doctor | 系統(tǒng)診斷 | openclaw doctor --fix |
openclaw channels list | 列出渠道 | openclaw channels list |
openclaw models status | 查看模型狀態(tài) | openclaw models status |
上圖按使用場景對(duì)常用命令進(jìn)行了分類，幫助快速定位所需命令。
15. 常見問題與解決方案
15.1 Gateway 啟動(dòng)失敗
問題：執(zhí)行 openclaw gateway start 時(shí)報(bào)錯(cuò)
排查步驟：
# 1. 檢查端口是否被占用 lsof -i :18789 # 2. 運(yùn)行診斷 openclaw doctor # 3. 查看詳細(xì)錯(cuò)誤 openclaw gateway run --verbose # 4. 強(qiáng)制啟動(dòng) openclaw gateway run --force
常見原因與解決：
- 端口被占用：使用
--force參數(shù)或修改端口 - 配置文件錯(cuò)誤：運(yùn)行
openclaw doctor檢查 - 權(quán)限不足：檢查文件權(quán)限或使用 sudo
15.2 模型 API 連接失敗
問題：Agent 無法響應(yīng)，日志顯示 API 連接錯(cuò)誤
排查步驟：
# 檢查 API 配置 openclaw config get model # 測試網(wǎng)絡(luò)連接 curl -I https://api.openai.com # 檢查診斷結(jié)果 openclaw doctor --check network
解決方案：
- 確認(rèn) API Key 正確且未過期
- 檢查網(wǎng)絡(luò)是否能訪問模型 API
- 如需代理，配置 HTTP_PROXY 環(huán)境變量
15.3 技能加載失敗
問題：某個(gè)技能顯示 error 狀態(tài)
排查步驟：
# 查看技能狀態(tài) openclaw skills check # 查看相關(guān)日志 openclaw logs --grep "skill"
解決方案：
- 檢查 SKILL.md 語法
- 確認(rèn)依賴項(xiàng)已安裝
- 查看錯(cuò)誤日志定位具體問題
15.4 渠道連接問題
問題：消息渠道無法正常工作
排查步驟：
# 深度檢查渠道狀態(tài) openclaw status --deep # 查看渠道日志 openclaw channels logs --channel telegram # 重新登錄渠道 openclaw channels login --channel whatsapp
16. 總結(jié)
本文全面介紹了 OpenClaw CLI 的各項(xiàng)命令和使用方法，從基礎(chǔ)的安裝驗(yàn)證到高級(jí)的自動(dòng)化腳本，覆蓋了日常運(yùn)維的各個(gè)方面。以下是核心要點(diǎn)的回顧：
1. 命令體系：OpenClaw CLI 采用層級(jí)化命令結(jié)構(gòu)，主命令下設(shè) gateway、status、config、sessions、skills、nodes、logs、doctor、channels、models、agents 等子命令，每個(gè)子命令又支持多個(gè)操作和選項(xiàng)。這種設(shè)計(jì)既保證了命令的清晰組織，又提供了足夠的靈活性。
2. 網(wǎng)關(guān)管理：Gateway 是 OpenClaw 的核心服務(wù)，通過 gateway 命令可以實(shí)現(xiàn)啟停、重啟、狀態(tài)查詢等完整生命周期管理。支持前臺(tái)運(yùn)行（開發(fā)調(diào)試）和系統(tǒng)服務(wù)模式（生產(chǎn)部署），熟練掌握這些命令是運(yùn)維的基礎(chǔ)。
3. 配置與診斷：config 命令提供了配置管理能力，支持點(diǎn)號(hào)路徑訪問嵌套配置。doctor 命令則能自動(dòng)診斷系統(tǒng)問題并提供修復(fù)建議。兩者結(jié)合使用，可以快速定位和解決大部分配置問題。
4. 擴(kuò)展能力：Skills 和 Nodes 系統(tǒng)是 OpenClaw 的核心擴(kuò)展機(jī)制。通過 skills 命令可以管理技能，通過 nodes 命令可以控制遠(yuǎn)程設(shè)備，實(shí)現(xiàn)功能的無限擴(kuò)展。節(jié)點(diǎn)系統(tǒng)支持?jǐn)z像頭、屏幕錄制、位置獲取等豐富功能。
5. 運(yùn)維效率：通過命令組合、腳本自動(dòng)化和 Profile 配置，可以大幅提升運(yùn)維效率。OpenClaw CLI 的設(shè)計(jì)充分考慮了與其他 Unix 工具的配合，使得集成到現(xiàn)有運(yùn)維體系變得簡單。
思考題：
在你的實(shí)際場景中，哪些命令會(huì)最頻繁使用？如何為它們設(shè)計(jì)更高效的 Shell 別名？
如果要將 OpenClaw 集成到現(xiàn)有的監(jiān)控告警系統(tǒng)中（如 Prometheus/Grafana），你會(huì)如何設(shè)計(jì)健康檢查腳本？
當(dāng)系統(tǒng)出現(xiàn)異常時(shí)，你會(huì)按照什么順序使用 CLI 命令進(jìn)行排查？如何構(gòu)建一個(gè)自動(dòng)化的故障恢復(fù)流程？
參考資料
到此這篇關(guān)于OpenClaw CLI全部命令及其使用方法的文章就介紹到這了,更多相關(guān)OpenClaw CLI命令手冊內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
本文檔提供了OpenClaw CLI命令的速查手冊，包含初始化配置、診斷維護(hù)和網(wǎng)關(guān)管理三大類命令,文中介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友2026-03-26
OpenClaw常用操作命令完整速查手冊：從入門到精通的終端 CLI & 聊天指令全解析
作為 OpenClaw 生態(tài)（包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列開源應(yīng)用）的核心用戶，我根據(jù)開源資料和個(gè)人使用體驗(yàn)整理了這份全網(wǎng)最全的命令速查手冊2026-03-09
