OpenClaw 命令完全速查手册：CLI + 聊天命令一文吃透

如果你在用 OpenClaw，一定会遇到一个问题：命令太多、入口太杂，终端里敲 openclaw、聊天里发 /，到底什么时候用哪个？

这篇文章帮你把 OpenClaw 所有常用命令，按用途分成 6 大类，讲清场景 + 用法 + 核心区别，新手能快速上手，老手可直接当速查表。

---

一、终端 CLI 命令：系统的「总控制台」

OpenClaw CLI 不只是聊天入口，它是整套系统的运维控制面。

这里的操作，大多是系统级、持久生效的。

我按使用场景分成 6 组：

1）启动 & 入口场景

新装、日常检查、出问题排障，最先用这组。

运行

openclaw onboard         # 初始化引导，首次安装必跑
openclaw dashboard       # 打开 Dashboard，最快聊天入口
openclaw status          # 系统整体诊断
openclaw status --deep   # 深度诊断，带实时探测
openclaw status --usage  # 查看完整 Provider 用量明细
openclaw health          # 快速检查 Gateway 是否正常
openclaw doctor          # 自动排障，出问题第一个跑它

口诀：

部署完第一件事：openclaw dashboard

出问题第一件事：openclaw doctor

---

2）渠道 & 消息场景

接入飞书、Telegram、WhatsApp、Discord、Slack 等渠道，或主动发消息。

运行

openclaw channels list       # 列出所有渠道
openclaw channels status     # 检查渠道健康，自带修复建议
openclaw channels add        # 添加渠道
openclaw channels remove     # 移除渠道
openclaw channels login      # 登录渠道账号
openclaw channels logout     # 登出渠道账号
openclaw channels logs       # 查看渠道日志
# 主动发消息
openclaw message send --target <id> --message <text>
openclaw directory           # 查找目标 ID，配合 message send 使用

我最常用的排障命令：

运行

openclaw channels status --probe --json

一眼看清哪个渠道挂了。

---

3）能力 & 资源场景

查看系统有哪些技能、模型、记忆可用。

运行

# 技能
openclaw skills list
openclaw skills info <name>
openclaw skills check
# 模型
openclaw models              # 等价于 models status
openclaw models list
openclaw models status
openclaw models set          # 设置默认模型
openclaw models set-image    # 设置图像模型
openclaw models auth         # 模型认证
openclaw models aliases      # 模型别名
openclaw models fallbacks    # 模型回退链
# 记忆
openclaw memory status
openclaw memory index
openclaw memory search

这组命令不指挥 Agent 干活，只看系统底层有什么资源。

---

4）Agent 管理场景

脚本化、批量调度、管理多个独立 Agent。

运行

# 直接在终端跑一轮对话
openclaw agent --message "..."
openclaw agent --local       # 本地运行，不走 Gateway
# 管理多个独立 Agent
openclaw agents list
openclaw agents add
openclaw agents delete
openclaw agents bindings     # 查看绑定关系
openclaw agents bind
openclaw agents unbind
openclaw agents set-identity # 设置 Agent 身份

关键区分：

• agent（单数）：直接在终端跑一轮对话
• agents（复数）：管理独立 Agent 的 workspace、绑定、身份

适合脚本化、自动化、批量调度。

---

5）安全 & 执行控制场景

控制 Agent 能不能在你机器上真正执行命令，是安全闸门。

运行

openclaw approvals get               # 查看审批规则
openclaw approvals set               # 设置审批规则
openclaw approvals allowlist add     # 添加白名单
openclaw approvals allowlist remove  # 移除白名单
openclaw security audit              # 安全审计

Exec Approvals 是 sandboxed Agent 操作真机的核心：

命令能否执行 = 策略 + 白名单 + 用户审批 同时满足。

新手建议：先用默认策略，弄懂再放开。

---

6）进阶系统能力场景

网关运维、浏览器自动化、节点、定时任务、备份等，新手可先忽略。

运行

openclaw gateway install|start|stop|status|restart
openclaw browser ...       # 浏览器实例控制
openclaw nodes ...         # 节点管理
openclaw node ...          # 单节点操作
openclaw cron ...          # 定时任务
openclaw backup ...        # 备份
openclaw plugins ...       # 插件管理
openclaw sessions ...      # 会话管理

---

二、聊天命令：会话的「临时控制器」

聊天里以 / 开头的命令，由 Gateway 处理，大多单独发一条消息才生效。

同样按场景分成 6 类：

1）基础查询场景

在聊天里快速看「我现在是什么状态」。

运行

/help               # 帮助
/commands           # 列出所有可用命令
/status             # 当前会话状态：模型、用量等
/context detail     # 查看当前上下文：文件、工具、Skill、Prompt 大小
/context json       # JSON 格式上下文
/whoami 或 /id      # 查看自己的 Sender ID

/context detail 调试必用。

---

2）会话控制场景

开新对话、停止、重启、看花费。

运行

/reset 或 /new      # 开新会话
/new <model>        # 新开并切换模型
/stop               # 停止当前运行
/restart            # 重启
/usage off          # 关闭用量显示
/usage tokens       # 显示 Token 用量
/usage full         # 完整用量
/usage cost         # 本次会话成本汇总
/compact            # 压缩上下文（对话过长时用）

想控制成本，多用 /usage cost。

---

3）Directives 运行时调参场景

聊天命令里最实用、最有门道的一组。

运行

/model <name>       # 切换模型
/model list
/model status
/think off          # 关闭思考
/think minimal
/think low
/think medium
/think high
/think xhigh
/verbose on|full|off    # 调试详细日志（正常关掉）
/reasoning on|off|stream # 输出推理过程
/elevated on|off|ask|full# 提升执行权限
/exec host=<...>        # 执行环境
/queue                  # 队列控制

重要机制：

• 混在消息里发 = 临时 hint
• 单独发一条 = 持久化到当前会话

/reasoning 和 /verbose 在群聊有泄密风险，平时关掉。

---

4）Sub-agent 控制场景

管理当前对话里派出去的子助手。

运行

/subagents list      # 查看所有子 Agent
/subagents spawn     # 启动子 Agent
/subagents info <id>
/subagents log <id>
/subagents send <id>
/subagents steer <id># 中途调整任务方向
/subagents kill <id> # 终止子 Agent

适合让 OpenClaw 同时处理多任务，实时监控与干预。

---

5）配置 & 权限场景

默认关闭，需要手动开启，仅限 owner 使用。

运行

/config show         # 查看配置
/config get <key>
/config set <k> <v>  # 写入 openclaw.json
/config unset <key>
/debug show          # 运行时调试配置
/debug set <k> <v>   # 只改运行时，不落地
/debug unset <key>
/debug reset
/approve <id> allow-once    # 本次允许执行
/approve <id> allow-always  # 永久允许
/approve <id> deny          # 拒绝
/allowlist                  # 管理白名单

---

6）Shell 执行场景

聊天里直接执行宿主机命令，谨慎使用。

运行

! <command>      # 在宿主机执行命令
/bash <command>  # 同上，别名
!poll            # 查看长任务状态
!stop            # 停止运行中命令

需要开启：

• commands.bash: true
• 配合 tools.elevated 白名单

它不是普通 Shell，受严格安全控制。

---

三、CLI vs 聊天命令 速查对照表

想做同一件事，用哪个入口？一张表看懂：

表格

你想做什么	终端 CLI	聊天命令
看系统状态	openclaw status	/status
系统排障	openclaw doctor	—
管理渠道	openclaw channels …	—
主动发消息	openclaw message send	—
系统级模型管理	openclaw models …	—
会话切模型	—	/model
管理审批规则	openclaw approvals …	—
处理单次审批	—	/approve …
管理独立 Agent	openclaw agents …	—
管子 Agent	—	/subagents …
调整思考级别	—	/think …
查看上下文	—	/context detail
查看花费	openclaw status --usage	/usage cost
修改配置	openaw config set	/config set（需开启）
执行 Shell	—	! （需开启）

---

四、核心区别：一句话记住

• CLI 命令：改的是规则，系统级、持久生效。
• 聊天命令：控制的是这次运行，默认只影响当前会话。

终端里改配置，聊天里调对话。

先记牢这一点，OpenClaw 你就已经入门了。

收藏这篇，用到时直接翻，比 --help 更好用。

把上面的文章输出成 markdown 源码

markdown

# OpenClaw 命令完全速查手册：CLI + 聊天命令一文吃透
如果你在用 OpenClaw，一定会遇到一个问题：**命令太多、入口太杂**，终端里敲 `openclaw`、聊天里发 `/`，到底什么时候用哪个？
这篇文章帮你把 OpenClaw 所有常用命令，按**用途**分成 6 大类，讲清**场景 + 用法 + 核心区别**，新手能快速上手，老手可直接当速查表。
---
## 一、终端 CLI 命令：系统的「总控制台」
OpenClaw CLI 不只是聊天入口，它是**整套系统的运维控制面**。
这里的操作，大多是**系统级、持久生效**的。
我按使用场景分成 6 组：
### 1）启动 & 入口场景
新装、日常检查、出问题排障，最先用这组。
```bash
openclaw onboard         # 初始化引导，首次安装必跑
openclaw dashboard       # 打开 Dashboard，最快聊天入口
openclaw status          # 系统整体诊断
openclaw status --deep   # 深度诊断，带实时探测
openclaw status --usage  # 查看完整 Provider 用量明细
openclaw health          # 快速检查 Gateway 是否正常
openclaw doctor          # 自动排障，出问题第一个跑它

口诀：

部署完第一件事：openclaw dashboard

出问题第一件事：openclaw doctor

---

2）渠道 & 消息场景

接入飞书、Telegram、WhatsApp、Discord、Slack 等渠道，或主动发消息。

运行

openclaw channels list       # 列出所有渠道
openclaw channels status     # 检查渠道健康，自带修复建议
openclaw channels add        # 添加渠道
openclaw channels remove     # 移除渠道
openclaw channels login      # 登录渠道账号
openclaw channels logout     # 登出渠道账号
openclaw channels logs       # 查看渠道日志
# 主动发消息
openclaw message send --target <id> --message <text>
openclaw directory           # 查找目标 ID，配合 message send 使用

我最常用的排障命令：

运行

openclaw channels status --probe --json

一眼看清哪个渠道挂了。

---

3）能力 & 资源场景

查看系统有哪些技能、模型、记忆可用。

运行

# 技能
openclaw skills list
openclaw skills info <name>
openclaw skills check
# 模型
openclaw models              # 等价于 models status
openclaw models list
openclaw models status
openclaw models set          # 设置默认模型
openclaw models set-image    # 设置图像模型
openclaw models auth         # 模型认证
openclaw models aliases      # 模型别名
openclaw models fallbacks    # 模型回退链
# 记忆
openclaw memory status
openclaw memory index
openclaw memory search

这组命令不指挥 Agent 干活，只看系统底层有什么资源。

---

4）Agent 管理场景

脚本化、批量调度、管理多个独立 Agent。

运行

# 直接在终端跑一轮对话
openclaw agent --message "..."
openclaw agent --local       # 本地运行，不走 Gateway
# 管理多个独立 Agent
openclaw agents list
openclaw agents add
openclaw agents delete
openclaw agents bindings     # 查看绑定关系
openclaw agents bind
openclaw agents unbind
openclaw agents set-identity # 设置 Agent 身份

关键区分：

• agent（单数）：直接在终端跑一轮对话
• agents（复数）：管理独立 Agent 的 workspace、绑定、身份

适合脚本化、自动化、批量调度。

---

5）安全 & 执行控制场景

控制 Agent 能不能在你机器上真正执行命令，是安全闸门。

运行

openclaw approvals get               # 查看审批规则
openclaw approvals set               # 设置审批规则
openclaw approvals allowlist add     # 添加白名单
openclaw approvals allowlist remove  # 移除白名单
openclaw security audit              # 安全审计

Exec Approvals 是 sandboxed Agent 操作真机的核心：

命令能否执行 = 策略 + 白名单 + 用户审批 同时满足。

新手建议：先用默认策略，弄懂再放开。

---

6）进阶系统能力场景

网关运维、浏览器自动化、节点、定时任务、备份等，新手可先忽略。

运行

openclaw gateway install|start|stop|status|restart
openclaw browser ...       # 浏览器实例控制
openclaw nodes ...         # 节点管理
openclaw node ...          # 单节点操作
openclaw cron ...          # 定时任务
openclaw backup ...        # 备份
openclaw plugins ...       # 插件管理
openclaw sessions ...      # 会话管理

---

二、聊天命令：会话的「临时控制器」

聊天里以 / 开头的命令，由 Gateway 处理，大多单独发一条消息才生效。

同样按场景分成 6 类：

1）基础查询场景

在聊天里快速看「我现在是什么状态」。

运行

/help               # 帮助
/commands           # 列出所有可用命令
/status             # 当前会话状态：模型、用量等
/context detail     # 查看当前上下文：文件、工具、Skill、Prompt 大小
/context json       # JSON 格式上下文
/whoami 或 /id      # 查看自己的 Sender ID

/context detail 调试必用。

---

2）会话控制场景

开新对话、停止、重启、看花费。

运行

/reset 或 /new      # 开新会话
/new <model>        # 新开并切换模型
/stop               # 停止当前运行
/restart            # 重启
/usage off          # 关闭用量显示
/usage tokens       # 显示 Token 用量
/usage full         # 完整用量
/usage cost         # 本次会话成本汇总
/compact            # 压缩上下文（对话过长时用）

想控制成本，多用 /usage cost。

---

3）Directives 运行时调参场景

聊天命令里最实用、最有门道的一组。

运行

/model <name>       # 切换模型
/model list
/model status
/think off          # 关闭思考
/think minimal
/think low
/think medium
/think high
/think xhigh
/verbose on|full|off    # 调试详细日志（正常关掉）
/reasoning on|off|stream # 输出推理过程
/elevated on|off|ask|full# 提升执行权限
/exec host=<...>        # 执行环境
/queue                  # 队列控制

重要机制：

• 混在消息里发 = 临时 hint
• 单独发一条 = 持久化到当前会话

/reasoning 和 /verbose 在群聊有泄密风险，平时关掉。

---

4）Sub-agent 控制场景

管理当前对话里派出去的子助手。

运行

/subagents list      # 查看所有子 Agent
/subagents spawn     # 启动子 Agent
/subagents info <id>
/subagents log <id>
/subagents send <id>
/subagents steer <id># 中途调整任务方向
/subagents kill <id> # 终止子 Agent

适合让 OpenClaw 同时处理多任务，实时监控与干预。

---

5）配置 & 权限场景

默认关闭，需要手动开启，仅限 owner 使用。

运行

/config show         # 查看配置
/config get <key>
/config set <k> <v>  # 写入 openclaw.json
/config unset <key>
/debug show          # 运行时调试配置
/debug set <k> <v>   # 只改运行时，不落地
/debug unset <key>
/debug reset
/approve <id> allow-once    # 本次允许执行
/approve <id> allow-always  # 永久允许
/approve <id> deny          # 拒绝
/allowlist                  # 管理白名单

---

6）Shell 执行场景

聊天里直接执行宿主机命令，谨慎使用。

运行

! <command>      # 在宿主机执行命令
/bash <command>  # 同上，别名
!poll            # 查看长任务状态
!stop            # 停止运行中命令

需要开启：

• commands.bash: true
• 配合 tools.elevated 白名单

它不是普通 Shell，受严格安全控制。

---

三、CLI vs 聊天命令 速查对照表

表格

你想做什么	终端 CLI	聊天命令
看系统状态	openclaw status	/status
系统排障	openclaw doctor	—
管理渠道	openclaw channels …	—
主动发消息	openclaw message send	—
系统级模型管理	openclaw models …	—
会话切模型	—	/model
管理审批规则	openclaw approvals …	—
处理单次审批	—	/approve …
管理独立 Agent	openclaw agents …	—
管子 Agent	—	/subagents …
调整思考级别	—	/think …
查看上下文	—	/context detail
查看花费	openclaw status --usage	/usage cost
修改配置	openaw config set	/config set（需开启）
执行 Shell	—	! （需开启）

---

四、核心区别：一句话记住

• CLI 命令：改的是规则，系统级、持久生效。
• 聊天命令：控制的是这次运行，默认只影响当前会话。

终端里改配置，聊天里调对话。

先记牢这一点，OpenClaw 你就已经入门了。

收藏这篇，用到时直接翻，比 --help 更好用。