OpenClaw的常用命令大全以及使用新手指南(2026最新)

發(fā)布時間：2026-04-07 11:58:45 作者：未來轉(zhuǎn)換

OpenClaw 是一款開源的個人 AI 助手框架，2026 年初開源后迅速成為最受關(guān)注的 AI Agent 框架之一,本文將基于 OpenClaw 2026.2.25 版本為大家整理 40+ 頂級命令，聊天斜杠命令及常見問題排查

一、OpenClaw 簡介

OpenClaw 是一款開源的個人 AI 助手框架，2026 年初開源后迅速成為最受關(guān)注的 AI Agent 框架之一。與依賴 Web 界面或桌面應(yīng)用的同類工具不同，OpenClaw 從設(shè)計之初就以 CLI（命令行）為主要入口，天然適合與 DevOps 工具鏈、Shell 腳本和自動化調(diào)度集成。

核心特性：

40+ 頂級命令，覆蓋 Gateway、模型、頻道、Skills、Hooks、Plugins 等
20+ 通信頻道：Telegram、Discord、Slack、WhatsApp、Signal、飛書等
100+ 子命令，完整的終端操作能力
內(nèi)置瀏覽器自動化、定時任務(wù)、語義記憶搜索

二、安裝與初始化

2.1 安裝

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2.2 驗證安裝

# 查看版本（注意：沒有 openclaw version 命令，必須用 --version）
openclaw --version
# 輸出: 2026.2.25

# 查看所有命令幫助
openclaw --help

2.3 首次初始化

# 交互式配置向?qū)Вㄍ扑]新手使用）
openclaw configure
# 健康檢查，確認(rèn)環(huán)境就緒
openclaw doctor

2.4 更新與卸載

# 更新到最新穩(wěn)定版
openclaw update

# 切換更新頻道（stable/beta/dev）
openclaw update --channel beta

# 預(yù)覽更新內(nèi)容（不實際執(zhí)行）
openclaw update --dry-run

# 更新后不自動重啟 Gateway
openclaw update --no-restart

# 卸載 Gateway 服務(wù)和本地數(shù)據(jù)（CLI 保留）
openclaw uninstall

# 完全卸載（含配置、狀態(tài)、工作空間）
openclaw uninstall --all --yes

# 重置本地配置（保留 CLI）
openclaw reset

三、全局標(biāo)志（Global Flags）

任何命令都可以附加以下全局標(biāo)志：

標(biāo)志	說明
`--help` / `-h`	顯示幫助信息
`--version` / `-V`	顯示版本號
`--log-level <level>`	全局日志級別：silent/fatal/error/warn/info/debug/trace
`--no-color`	禁用 ANSI 顏色（適合 CI 管道）
`--dev`	使用開發(fā)環(huán)境，隔離狀態(tài)到 `~/.openclaw-dev`
`--profile <name>`	使用命名配置文件，隔離狀態(tài)

四、Gateway 管理（核心服務(wù)）

Gateway 是 OpenClaw 的心臟，是一個 WebSocket 服務(wù)，負(fù)責(zé)接收消息、調(diào)度 Agent、管理會話。默認(rèn)監(jiān)聽 ws://127.0.0.1:18789。

4.1 啟動與運(yùn)行

# 前臺運(yùn)行（Ctrl+C 停止，適合調(diào)試）
openclaw gateway

# 指定端口
openclaw gateway --port 18790

# 綁定模式
openclaw gateway --bind loopback   # 僅本機(jī)（默認(rèn)，最安全）
openclaw gateway --bind lan        # 局域網(wǎng)可訪問
openclaw gateway --bind tailnet    # Tailscale 網(wǎng)絡(luò)

# 強(qiáng)制啟動（殺掉占用端口的進(jìn)程）
openclaw gateway --force

# 設(shè)置認(rèn)證模式
openclaw gateway --auth token --token "your-secret-token"
openclaw gateway --auth password --password "your-password"

# Tailscale 暴露
openclaw gateway --tailscale serve    # 內(nèi)網(wǎng)暴露
openclaw gateway --tailscale funnel   # 公網(wǎng)暴露

# 詳細(xì)日志模式
openclaw gateway --verbose

4.2 服務(wù)管理（持久化）

# 安裝為系統(tǒng)服務(wù)（launchd/systemd/schtasks）
openclaw gateway install

# 啟動 / 停止 / 重啟
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 卸載系統(tǒng)服務(wù)
openclaw gateway uninstall

# 查看服務(wù)狀態(tài)
openclaw gateway status

Windows 注意：openclaw gateway install 需要管理員權(quán)限（底層使用 schtasks），非管理員環(huán)境請用前臺模式。

4.3 狀態(tài)查詢與日志

# 查看完整狀態(tài)
openclaw gateway status

# 健康檢查
openclaw gateway health

# 探測 Gateway 可達(dá)性
openclaw gateway probe

# 發(fā)現(xiàn)局域網(wǎng)/廣域網(wǎng)上的 Gateway
openclaw gateway discover

# 調(diào)用 Gateway RPC 方法
openclaw gateway call health

# 查看用量成本
openclaw gateway usage-cost

# 查看日志
openclaw logs
openclaw logs --follow       # 實時跟蹤
openclaw logs --limit 100    # 限制行數(shù)
openclaw logs --json         # JSON 格式

五、配置管理

配置文件位于 ~/.openclaw/openclaw.json，使用 JSON5 格式（支持注釋和尾逗號）。

# 獲取配置值（點(diǎn)路徑語法）
openclaw config get gateway.port
# 輸出: 18789

# 設(shè)置配置值
openclaw config set gateway.port 18790
openclaw config set gateway.bind loopback

# 刪除配置項
openclaw config unset gateway.tailscale

# 交互式配置向?qū)?
openclaw configure
openclaw configure --section model   # 僅配置模型部分
openclaw configure --section web     # 僅配置 Web 部分

六、模型管理

6.1 查看與設(shè)置模型

# 列出已配置的模型
openclaw models list

# 查看當(dāng)前模型狀態(tài)
openclaw models status
openclaw models status --json    # JSON 格式

# 設(shè)置默認(rèn)模型
openclaw models set qwen-portal/coder-model
openclaw models set qwen          # 使用別名

# 設(shè)置圖像模型
openclaw models set-image qwen-portal/vision-model

6.2 模型認(rèn)證

# 交互式認(rèn)證向?qū)Вㄒ龑?dǎo)完成 OAuth 或 Token 設(shè)置）
openclaw models auth add

# 手動粘貼 Token
openclaw models auth paste-token

# 通過 CLI 設(shè)置 Token
openclaw models auth setup-token

# 管理認(rèn)證順序
openclaw models auth order

6.3 別名與回退

# 管理模型別名
openclaw models aliases

# 管理回退鏈（主模型不可用時自動切換）
openclaw models fallbacks

# 管理圖像模型回退
openclaw models image-fallbacks

# 掃描 OpenRouter 免費(fèi)模型
openclaw models scan

支持的模型提供商：OpenAI、Anthropic（Claude）、Google（Gemini）、OpenRouter、DeepSeek、Mistral、Groq 等。

七、頻道管理（Channels）

OpenClaw 支持 20+ 通信頻道：Telegram、WhatsApp、Discord、Slack、Signal、iMessage、IRC、飛書、LINE 等。

7.1 添加頻道

# 添加 Telegram Bot
openclaw channels add --channel telegram --token "123456:ABC..."

# 添加 Discord Bot
openclaw channels add --channel discord --token "MTIz..."

# 添加 Slack App
openclaw channels add --channel slack --bot-token "xoxb-..." --app-token "xapp-..."

# 添加 WhatsApp（需要掃碼登錄）
openclaw channels login --channel whatsapp

# 添加 Matrix
openclaw channels add --channel matrix --homeserver "https://matrix.org" --user-id "@user:matrix.org" --access-token "..."

# 添加 Signal
openclaw channels add --channel signal --signal-number "+886..."

# 添加多賬號（指定 account ID）
openclaw channels add --channel telegram --account work --token "..."

7.2 管理頻道

# 列出所有頻道
openclaw channels list

# 查看頻道連接狀態(tài)（含 Gateway 探測）
openclaw channels status
openclaw channels status --probe

# 查看頻道日志
openclaw channels logs

# 查看頻道支持的功能
openclaw channels capabilities

# 移除頻道
openclaw channels remove --channel telegram

# 登出頻道
openclaw channels logout --channel whatsapp

7.3 DM 配對

# 查看待配對請求
openclaw pairing

# 批準(zhǔn)配對
openclaw pairing approve telegram WR8XRQQA

八、Skills（技能插件）

Skills 是 OpenClaw 的功能擴(kuò)展機(jī)制，每個 Skill 定義 AI Agent 可以執(zhí)行的特定能力。

# 列出所有 Skills
openclaw skills list

# 檢查 Skills 就緒狀態(tài)
openclaw skills check

# 查看某個 Skill 詳情
openclaw skills info coding-agent

常用內(nèi)置 Skills：

Skill	說明	依賴
weather	天氣查詢	curl
github	GitHub 倉庫操作	gh CLI
coding-agent	代碼輔助	無
himalaya	郵件收發(fā)	himalaya CLI + IMAP
openai-whisper-api	語音轉(zhuǎn)文字	OPENAI_API_KEY
session-logs	搜索歷史對話	jq + rg
summarize	網(wǎng)頁/視頻摘要	summarize CLI

九、Hooks（事件鉤子）

Hooks 是 OpenClaw 的事件驅(qū)動自動化機(jī)制，特定事件觸發(fā)時自動執(zhí)行預(yù)定義操作。

# 列出所有 Hooks
openclaw hooks list

# 查看某個 Hook 詳情
openclaw hooks info session-memory

# 檢查 Hooks 就緒狀態(tài)
openclaw hooks check

# 啟用 / 禁用 Hook
openclaw hooks enable session-memory
openclaw hooks disable command-logger

# 安裝 Hook 包
openclaw hooks install ./my-hook-pack
openclaw hooks install some-npm-hook-package

# 更新已安裝的 Hooks
openclaw hooks update

內(nèi)置 Hooks：boot-md（啟動時運(yùn)行 BOOT.md）、session-memory（/new 或 /reset 時保存上下文）、command-logger（記錄所有命令事件）。

十、Plugins（插件管理）

# 列出所有插件
openclaw plugins list

# 查看插件詳情
openclaw plugins info some-plugin

# 安裝插件
openclaw plugins install ./my-plugin
openclaw plugins install some-npm-plugin

# 啟用 / 禁用插件
openclaw plugins enable some-plugin
openclaw plugins disable some-plugin

# 診斷插件加載問題
openclaw plugins doctor

十一、Agents（代理管理）

Agents 是 OpenClaw 的隔離執(zhí)行單元，每個 Agent 有獨(dú)立的工作空間、認(rèn)證配置和路由規(guī)則。

# 列出所有 Agent
openclaw agents list

# 添加隔離 Agent
openclaw agents add work

# 設(shè)置 Agent 身份
openclaw agents set-identity work --name "Work Bot"

# 刪除 Agent
openclaw agents delete work

終端直接對話

# 基礎(chǔ)對話
openclaw agent --agent main --message "今天天氣怎么樣？"

# 指定會話 ID 繼續(xù)對話
openclaw agent --session-id 1234 --message "繼續(xù)上次的話題"

# 指定思考級別
openclaw agent --message "分析代碼性能" --thinking medium

# 對話結(jié)果發(fā)送到 Telegram
openclaw agent --message "生成周報" --deliver --channel telegram --reply-to "@mychat"

十二、會話管理（Sessions）

# 列出所有會話
openclaw sessions

# 只看最近 2 小時活躍的會話
openclaw sessions --active 120

# 聚合所有 Agent 的會話
openclaw sessions --all-agents

# JSON 格式輸出
openclaw sessions --json

十三、記憶系統(tǒng)（Memory）

OpenClaw 內(nèi)置語義記憶搜索，可以從歷史對話和筆記中檢索信息。

# 查看記憶索引狀態(tài)
openclaw memory status

# 重建索引
openclaw memory index
openclaw memory index --force

# 語義搜索
openclaw memory search --query "服務(wù)器配置"

記憶文件結(jié)構(gòu)：

MEMORY.md — 長期記憶（手動維護(hù)）
memory/YYYY-MM-DD.md — 每日筆記（自動/手動）

十四、定時任務(wù)（Cron）

讓 AI 助手定時執(zhí)行任務(wù)。

# 查看調(diào)度器狀態(tài)
openclaw cron status

# 列出所有定時任務(wù)
openclaw cron list

# 添加定時任務(wù)（交互式）
openclaw cron add

# 手動觸發(fā)任務(wù)
openclaw cron run <job-id>

# 啟用 / 禁用任務(wù)
openclaw cron enable <job-id>
openclaw cron disable <job-id>

# 編輯任務(wù)
openclaw cron edit <job-id>

# 查看運(yùn)行歷史
openclaw cron runs <job-id>

常見用例：每天 9 點(diǎn)播報天氣、每小時檢查新郵件、每周一生成周報。

十五、瀏覽器自動化（Browser）

OpenClaw 可以控制無頭瀏覽器，實現(xiàn)網(wǎng)頁自動化操作。

# 查看狀態(tài) / 啟動
openclaw browser status
openclaw browser start

# 打開網(wǎng)頁
openclaw browser open https://example.com

# 列出標(biāo)簽頁
openclaw browser tabs

# 截圖
openclaw browser screenshot
openclaw browser screenshot --full-page

# 獲取頁面快照（AI 可讀的結(jié)構(gòu)化格式）
openclaw browser snapshot

# 點(diǎn)擊元素（通過 ref 編號）
openclaw browser click 12

# 輸入文字
openclaw browser type 23 "hello" --submit

# 按鍵
openclaw browser press Enter

# 導(dǎo)航
openclaw browser navigate https://google.com

十六、多設(shè)備聯(lián)動（Nodes）

# 查看已配對設(shè)備
openclaw nodes status

# 查看節(jié)點(diǎn)能力
openclaw nodes describe <node-id>

# 發(fā)送通知
openclaw nodes notify --node mac --body "任務(wù)完成！"

# 遠(yuǎn)程拍照
openclaw nodes camera --node iphone --facing back

# 獲取設(shè)備位置
openclaw nodes location --node iphone

# 遠(yuǎn)程執(zhí)行命令
openclaw nodes run --node mac -- "ls -la ~/Desktop"

十七、診斷與排查

17.1 openclaw doctor（最重要的診斷命令）

# 運(yùn)行環(huán)境診斷
openclaw doctor

# 自動修復(fù)
openclaw doctor --fix

# 深度掃描（含系統(tǒng)服務(wù)）
openclaw doctor --deep

# 生成 Gateway Token
openclaw doctor --generate-gateway-token

# 非交互模式
openclaw doctor --non-interactive

17.2 安全審計

# 本地安全審計
openclaw security audit

# 深度審計（含 Gateway 探測）
openclaw security audit --deep

# 自動修復(fù)安全問題
openclaw security audit --fix

17.3 其他實用命令

# 查看整體狀態(tài)
openclaw status
openclaw status --all
openclaw status --deep

# 打開 Web 控制臺
openclaw dashboard
openclaw dashboard --no-open

# 打開終端 TUI
openclaw tui

十八、聊天斜杠命令

在聊天窗口（Telegram、Discord、Slack、WhatsApp 等）中使用的命令。

18.1 基礎(chǔ)命令

命令	說明	示例
`/new`	重置會話，清空歷史	`/new`
`/new <model>`	重置并切換模型	`/new claude-sonnet-4-20250514`
`/status`	查看會話狀態(tài)、Token、成本	`/status`
`/help`	查看所有斜杠命令	`/help`
`/commands`	查看可用命令列表	`/commands`

18.2 模型與上下文管理

# 切換模型
/model deepseek/deepseek-chat

# 列出可用模型
/models

# 查看當(dāng)前模型狀態(tài)
/model-status

# 壓縮上下文（減少 Token 消耗）
/compact
/compact 保留代碼相關(guān)的討論，其他可以簡化

# 查看用量
/usage off        # 關(guān)閉顯示
/usage tokens     # 僅顯示 Token 數(shù)
/usage full       # 顯示完整用量
/usage cost       # 顯示成本統(tǒng)計

# 查看上下文詳情
/context
/context list     # 列出上下文組件
/context detail   # 詳細(xì) Token 分布
/context json     # JSON 格式

18.3 執(zhí)行控制與安全

# 查看當(dāng)前執(zhí)行設(shè)置
/exec

# 設(shè)置安全策略
/exec host=sandbox security=allowlist ask=always

# 批準(zhǔn)待執(zhí)行操作
/approve <操作ID> allow-once     # 僅允許本次
/approve <操作ID> allow-always   # 永久允許
/approve <操作ID> deny           # 拒絕

# 權(quán)限模式總開關(guān)
/elevated on      # 開啟提升權(quán)限
/elevated off     # 關(guān)閉提升權(quán)限

/exec 參數(shù)說明：

參數(shù)	選項	說明
`host`	`sandbox`	Docker 沙箱執(zhí)行（推薦）
	`gateway`	網(wǎng)關(guān)主機(jī)執(zhí)行
	`node`	配對節(jié)點(diǎn)執(zhí)行
`security`	`deny`	拒絕所有命令
	`allowlist`	僅允許白名單命令
	`full`	允許所有命令（謹(jǐn)慎）
`ask`	`off`	不詢問，按策略執(zhí)行
	`on-miss`	不在白名單時詢問
	`always`	每次都詢問

18.4 語音控制（TTS）

/tts off        # 關(guān)閉語音
/tts always     # 所有回復(fù)語音播報
/tts inbound    # 僅語音輸入時回復(fù)語音
/tts tagged     # 僅標(biāo)記內(nèi)容的語音播報
/tts status     # 查看當(dāng)前狀態(tài)
/tts provider   # 查看或切換 TTS 提供商

支持的 TTS 提供商：Edge TTS（免費(fèi)默認(rèn)）、OpenAI TTS、ElevenLabs。

18.5 子代理管理

/subagents list                  # 列出所有子代理
/subagents stop <id>             # 停止子代理
/subagents log <id>              # 查看日志
/subagents info <id>             # 查看詳情
/subagents send <id> <message>   # 發(fā)送消息

十九、常見問題排查

19.1 命令名稱錯誤

OpenClaw 的命名規(guī)范：頂級名詞用復(fù)數(shù)形式（models、channels、skills、hooks、agents），少數(shù)核心命令用單數(shù)（gateway、doctor、config）。

# 錯誤寫法
openclaw version          # ? 不存在
openclaw model list       # ? 不存在（提示 Did you mean models?）
openclaw channel list     # ? 不存在
openclaw skill list       # ? 不存在

# 正確寫法
openclaw --version        # ? 使用標(biāo)志
openclaw models list      # ? 復(fù)數(shù)形式
openclaw channels list    # ? 復(fù)數(shù)形式
openclaw skills list      # ? 復(fù)數(shù)形式

19.2 Gateway 端口被占用

# 方式一：強(qiáng)制啟動
openclaw gateway --force

# 方式二：更換端口
openclaw gateway --port 18790
openclaw config set gateway.port 18790

# 方式三：查看占用進(jìn)程
lsof -i :18789              # macOS/Linux
netstat -ano | findstr :18789   # Windows

19.3 配置文件位置速查

文件	路徑
主配置文件	`~/.openclaw/openclaw.json`
Agent 工作空間	`~/.openclaw/agents/main/`
認(rèn)證配置	`~/.openclaw/agents/main/agent/auth-profiles.json`
Gateway 日志	`/tmp/openclaw/openclaw-YYYY-MM-DD.log`

19.4 遇到問題時

# 完整診斷
openclaw doctor --deep

# 查看版本
openclaw --version

# 查看 Gateway 狀態(tài)
openclaw gateway status

# 查看健康狀態(tài)
openclaw gateway health

二十、每日核心命令速查表

日常使用掌握以下命令即可滿足大部分需求：

# 1. 啟動 Gateway
openclaw gateway start

# 2. 查看整體狀態(tài)
openclaw status

# 3. 管理 Channel
openclaw channels status

# 4. 管理模型
openclaw models status
openclaw models set <model-name>

# 5. 查看 Skills
openclaw skills check

# 6. 定期健康檢查
openclaw doctor

# 7. 查看日志
openclaw logs --follow

# 8. 更新 OpenClaw
openclaw update

到此這篇關(guān)于OpenClaw的常用命令大全以及使用新手指南(2026最新)的文章就介紹到這了,更多相關(guān)OpenClaw常用命令內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

Tag：OpenClaw 命令

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

OpenClaw的常用命令大全以及使用新手指南(2026最新)

目錄

一、OpenClaw 簡介