🦞 OpenClaw · /commands 指令手册

/commands 讲成人话

这页不是官方原文搬运,而是给你随时查、能立刻用的版本:每个命令都尽量回答 4 件事——它是干嘛的、什么时候用、怎么写、最小示例。默认按“完全没背景也能看懂”来写。

先记住 3 条

  1. 大多数命令最好单独发一条。 比如直接发 /status/model gpt,最稳。
  2. 指令类命令(如 /think/model)单独发会改当前会话;夹在一句话里通常只影响这一条。
  3. 不是每个命令都一定启用。 某些管理员命令要看配置和权限,比如 /config/debug/bash

这台实例当前已知

Telegram 原生命令已开启,可菜单点,也可手打 /xxx
Skill 原生命令已开启,部分 skill 可直接变成命令
/restart已开启
/config /debug /bash按当前配置看,默认未启用

0. 完全没背景时,先看这块

你只要先理解下面几件事,后面大部分命令就不容易看懵。

命令

/status/stop 这种,是让 OpenClaw 直接做一件事。一般单独发一条。

指令

/think/model/verbose,更像“调开关”。单独发会改会话,混在一句话里通常只影响这一条。

少数内联快捷

/status/commands 可以塞进一句话里先执行,再继续正常聊天,但不是所有命令都支持这样用。

1. 命令怎么读

<必填> = 必须填
[可选] = 可以不填
a|b|c = 三选一
alias = 别名,意思一样
/new [model]
/approve <id> allow-once|allow-always|deny
/think <off|minimal|low|medium|high|xhigh>

还有一个小规则:命令和参数之间可以加冒号,比如 /think high/think: high 都行。

2. 最短上手路线

如果你只想先把 OpenClaw 用起来,先记这 8 个就够了。

/commands

/commands

作用:列出当前可用命令总表。

什么时候用:你忘了命令名,或者想确认这台实例到底开放了哪些命令。

/commands

/status

/status

作用:看当前会话状态,比如模型、thinking、usage、上下文占用。

什么时候用:怀疑模型不对、觉得变慢、想确认现在是什么模式。

/status

/model

/model <name>

作用:切模型,或者查看可选模型。

/model
/model gpt
/model status

/think

/think <off|minimal|low|medium|high|xhigh>

作用:调“思考强度”。

/think high
/think off

/new

/new [model]

作用:开一个新会话;后面还能顺手接一句新问题。

/new
/new gpt
/new gpt 帮我重新规划这个任务

/stop

/stop

作用:立刻停掉当前正在生成或执行的任务。

/stop

/skill

/skill <name> [input]

作用:直接按名字运行一个 skill。

/skill weather 上海

/tts

/tts off|always|inbound|tagged|status|audio

作用:控制语音输出。

/tts status
/tts audio

3. 概念区:你最容易搞混的

命令 vs 指令

命令:直接做事,比如 /commands/status/stop

指令:更像改开关,比如 /think/model/verbose/reasoning/elevated/exec/queue

关键区别:

  • 单独发:通常会写进当前会话
  • 夹在一句话里:通常只影响当前这条消息
/think high
→ 后面默认更认真

用 /think high 帮我分析这段日志
→ 只影响这一条

内联快捷

目前常见支持:/help/commands/status/whoami//id

效果:先执行命令,再把剩下文本按正常聊天继续处理。

先 /status 再帮我看为什么慢

注意:不是所有命令都支持这样塞进一句话里。

4. 逐条指令手册

下面是你未来最常查的主体内容。每张卡尽量回答:作用 / 场景 / 用法 / 示例 / 注意点

/help

/help
入门

作用:查看帮助。

什么时候用:你知道有命令,但忘了怎么写。

/help

/commands

/commands
总目录

作用:列出当前可用命令。

场景:第一次接触这台 OpenClaw、或者想看看某些管理员命令有没有开。

/commands

/skill

/skill <name> [input]
直接跑 skill

作用:按名字调用 skill。

  • 适合你知道 skill 名字时
  • 适合原生命令太多,不想记每个 skill 的单独命令时
/skill weather 上海
/skill apple-reminders 今天

/status

/status
排错常用

作用:看当前会话状态。

你一般能看到:

  • 当前模型
  • thinking / verbose / elevated 状态
  • 上下文占用
  • 有时会带 usage / quota
/status

/allowlist

/allowlist /allowlist add ... /allowlist remove ...
管理员向

作用:查看、增加、删除白名单。

什么时候用:某个账号能不能发命令、某个用户为什么没权限。

这类通常要写配置权限,普通使用场景不常碰。

/approve

/approve <id> allow-once|allow-always|deny
涉及执行审批

作用:处理系统弹出的执行审批。

三个结果怎么选:

  • allow-once:只放行这一次
  • allow-always:以后都放行
  • deny:拒绝
/approve 17 allow-once

/context

/context [list|detail|json]
排查上下文

作用:看这轮对话到底喂了什么上下文进模型。

  • list:简版清单
  • detail:详细,适合查卡顿和注入文件
  • json:机器可读
/context
/context detail

/export-session /export

/export-session [path] /export
导出记录

作用:导出当前会话,通常是 HTML。

/export
/export-session ~/Desktop/chat.html

/whoami /id

/whoami /id
查身份

作用:看当前发送者 ID。

场景:排权限、看 allowlist、确认自己在系统里被识别成谁。

/session idle /session max-age

/session idle <duration|off> /session max-age <duration|off>
线程绑定场景

作用:控制绑定线程多久自动解绑。

更像谁会用? Discord 线程 / 持续会话 / 子 Agent 线程。

/session idle 2h
/session max-age 24h

/subagents

/subagents list|kill|log|info|send|steer|spawn
主控分兵

作用:查看、控制、创建后台子 Agent。

/subagents list
/subagents spawn main 调研一下 Cloudflare Pages 最低权限
/subagents steer 2 改成只输出中文结论

/acp

/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions
编码代理运行时

作用:管理 Codex / Claude Code 这类 ACP 运行时。

/acp status
/acp sessions
/acp spawn codex --mode persistent --thread auto

/agents

/agents

作用:列出当前会话或线程绑定到哪些 agent。

/focus /unfocus

/focus <target> /unfocus

作用:把当前线程绑到某个 session / subagent,或者解绑。

主要用于 Discord 线程场景。

/kill /steer /tell

/kill <id|#|all> /steer <id|#> <message> /tell <id|#> <message>
控制正在跑的 Agent

作用:

  • /kill:停掉一个或全部子 Agent
  • /steer:半路改方向
  • /tell:就是 /steer 的别名
/kill 2
/steer 2 改成只看本地 docs
/tell 2 输出改成中文

/config

/config show|get|set|unset
写 openclaw.json

作用:直接改磁盘上的配置文件。

危险点:这是长期配置,不是临时开关。

/config show
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"

这台实例按当前配置看,默认未开启。

/debug

/debug show|set|unset|reset
临时改配置

作用:只改运行时,不落盘。

/debug show
/debug set messages.responsePrefix="[debug]"
/debug reset

适合临时试验,重启后通常就没了。

/usage

/usage off|tokens|full|cost

作用:控制每条回复后面要不要显示 token / 成本。

/usage off
/usage full
/usage cost

/tts

/tts off|always|inbound|tagged|status|provider|limit|summary|audio

作用:控制语音模式。

  • always:总是语音
  • inbound:来语音我也回语音
  • tagged:只有被标记时才语音
  • audio:这次直接生成音频,不一定长期开启
/tts status
/tts always
/tts audio

/stop

/stop
立刻中止

作用:停掉当前正在跑的回复或任务。

/stop

/restart

/restart

作用:重启 OpenClaw / Gateway。

这台实例:已开启。

/dock-telegram / /dock-discord / /dock-slack

/dock-telegram /dock-discord /dock-slack

作用:把回复停靠到指定平台。

/activation

/activation mention|always

作用:群聊里控制“必须 @ 我才回”还是“总是可回”。

/activation mention
/activation always

/send

/send on|off|inherit

作用:控制当前会话是否允许发送。

偏管理员场景,普通聊天不常用。

/reset / /new

/reset /new [model]

作用:

  • /reset:清空重来
  • /new gpt 你好:开新会话 + 切模型 + 直接发第一条问题
/reset
/new
/new gpt 帮我从零写一个部署方案

/think / /thinking / /t

/think <off|minimal|low|medium|high|xhigh>

作用:调思考强度。

  • off:追求快
  • low:日常
  • high/xhigh:复杂分析
/think high
/think: low
/t xhigh

/verbose / /v

/verbose on|full|off

作用:控制要不要暴露更多调试细节。

/verbose on
/verbose full
/v off

平时建议关,排错时再开。

/reasoning / /reason

/reasoning on|off|stream

作用:控制 reasoning 可见性。

  • on:会发一条带 Reasoning: 的附加消息
  • stream:偏 Telegram 流式草稿场景
/reasoning off
/reasoning on

群聊里谨慎开,容易暴露内部细节。

/elevated / /elev

/elevated on|off|ask|full
提权

作用:控制执行工具时的提权模式。

/elevated ask
/elevated full
/elev off

full 最猛,别长期常驻开。

/exec

/exec /exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>

作用:细粒度控制 exec 跑在哪里、什么安全级别、需不需要审批。

/exec
/exec host=gateway security=full ask=off
/exec host=sandbox security=allowlist ask=on-miss

/model / /models

/model /model list /model <name or #> /model status

作用:切模型、看模型、看 provider 状态。

/model
/model gpt
/model 3
/model status

/queue

/queue /queue <mode or options>

作用:控制消息排队和节流方式。

/queue
/queue debounce:2s cap:25 drop:summarize

/bash

/bash <command>
主机 shell

作用:直接跑主机 shell 命令。

/bash pwd

这台实例按当前配置看,默认未开启。

/compact

/compact [instructions]

作用:做上下文压缩 / 摘要整理。

/compact
/compact 只保留任务事实,去掉寒暄

! <command>

! <command>
文本专用 Shell

作用:文本模式下跑 shell,功能上接近 /bash

! pwd
! ls -la

!poll / !stop

!poll [sessionId] !stop [sessionId]

作用:看长任务进度,或停掉长任务。

!poll
!stop

5. 什么时候会“没反应”

没权限

某些命令只有授权发送者能用。没权限时,可能被当普通文本,也可能静默忽略。

命令没单独发

很多命令要求单独发一条。塞进长句里,系统不一定按你想的方式解析。

命令本身没开启

/config/debug/bash 这种,通常要配置里显式开启。

群聊 gating

在群组里,有时要 @、要提及、或要满足 allowlist 规则。

6. 你最常用的推荐组合

查状态

/status
/context detail
/usage full

切模型 + 提高思考

/model gpt
/think high

开新会话继续干

/new gpt 帮我从零整理这个需求

让主控分兵

/subagents list
/subagents spawn main 调研一下这个问题

7. 容易漏掉的规则

命令最好单独发

最稳写法:

/status
/model gpt
/think high

除少数内联快捷外,大多数命令都更适合单独发一条。

命令消息会走“快路径”

意思:纯命令消息通常会直接由 Gateway 处理,绕过普通聊天队列和模型。

所以像 /status/commands 这种,响应往往更直接。

没权限时会像“没反应”

未授权发送者发命令时,可能会:

  • 被静默忽略
  • 被当成普通文本

这不是命令坏了,通常是 allowlist / pairing / access group 问题。

/reasoning 与 /verbose 要谨慎

这两个命令在群聊里可能把内部过程、工具输出、排错细节暴露出来。

/verbose off
/reasoning off

/new 的一个小坑

/new <model> 会先尝试把后面那段识别成模型名。

如果识别不到,它就把那段当成普通消息正文。

/new gpt 帮我重新开始
/new 继续刚才那个需求,但换个思路

/config 和 /debug 不一样

  • /config:改磁盘配置,重启后还在
  • /debug:只改运行时,重启后通常消失

8. 完整命令总表

这块是“漏斗底”。如果上面的解释你还没找到答案,就来这里直接按命令查。它尽量把本地文档里列出的命令都过一遍。

命令 一句话作用 最小示例 补充
/help查看帮助/help忘写法时先用它
/commands列命令总表/commands像聊天里的“命令目录”
/skill <name> [input]直接运行 skill/skill weather 上海知道 skill 名字时最快
/status看当前状态/status模型、thinking、usage、上下文占用
/allowlist看/改白名单/allowlistadd/remove 往往要配置写权限
/approve <id> allow-once|allow-always|deny处理执行审批/approve 17 allow-once看到审批 ID 时再用
/context [list|detail|json]看上下文注入/context detail排“为什么变笨/变慢”很有用
/export-session [path] / /export导出会话/export通常导成 HTML
/whoami / /id看当前发送者 ID/id常用于查权限
/session idle <duration|off>控制空闲后自动解绑/session idle 2h线程绑定场景为主
/session max-age <duration|off>控制绑定最长寿命/session max-age 24h线程绑定场景为主
/subagents ...查看/控制/创建子 Agent/subagents list主控分兵入口
/acp ...管理 ACP 编码代理运行时/acp statusCodex / Claude Code 这类会走它
/agents列当前 agent 绑定/agents线程/绑定场景更常用
/focus <target>把线程绑到目标会话/focus some-session主要是 Discord 线程
/unfocus解绑当前线程/unfocus/focus 配对
/kill <id|#|all>停掉子 Agent/kill all没有确认提示时要小心
/steer <id|#> <message>中途改子 Agent 方向/steer 2 改成只看本地 docs/tell 是别名
/tell <id|#> <message>/steer 别名/tell 2 输出改成中文意义一样
/config show|get|set|unset改磁盘配置/config show当前实例默认未启用
/debug show|set|unset|reset改运行时配置/debug show当前实例默认未启用
/usage off|tokens|full|cost控制 token/成本显示/usage fullcost 看本地成本摘要
/tts off|always|inbound|tagged|status|provider|limit|summary|audio控制语音模式/tts statusaudio 是一次性音频
/stop中止当前任务/stop跑偏或卡住就用
/restart重启 OpenClaw/restart这台实例已开启
/dock-telegram切到 Telegram 输出/dock-telegram也有下划线别名
/dock-discord切到 Discord 输出/dock-discord也有下划线别名
/dock-slack切到 Slack 输出/dock-slack也有下划线别名
/activation mention|always控制群聊触发方式/activation mention群聊用,私聊一般没意义
/send on|off|inherit控制当前会话能不能发送/send offowner/admin 场景多
/reset重开一个干净会话/reset等价于“这段别算了,重来”
/new [model]开新会话并可顺手提问/new gpt 帮我重做后半句如果不像模型名,就当消息正文
/think <level>调思考强度/think high别名:/thinking/t
/verbose on|full|off控制额外调试细节/verbose on别名:/v
/reasoning on|off|stream控制 reasoning 可见性/reasoning off别名:/reason;群聊谨慎开
/elevated on|off|ask|full控制提权模式/elevated ask别名:/elev
/exec ...细调 exec 的 host / security / ask/exec host=gateway security=full ask=off只发 /exec 会显示当前设置
/model <name or #>切模型或查看模型列表/model gpt支持 /model/model list/model status
/queue <mode>控制排队/节流/queue debounce:2s cap:25 drop:summarize不懂就先只发 /queue 看当前值
/bash <command>直接跑主机 shell/bash pwd当前实例默认未启用
/compact [instructions]做上下文压缩/compact 只保留任务事实文本命令专用
! <command>文本模式下跑 shell! pwdhost-only;一次一个
!poll [sessionId]查看长任务状态!poll/bash poll 也可
!stop [sessionId]停止长任务!stop/bash stop 也可

9. 平台差异与边界

Text commands vs Native commands

Text commands:你在聊天里手打 /xxx

Native commands:平台自己注册出来的命令菜单,比如 Telegram / Discord 菜单里的命令项。

你现在这台实例在 Telegram 上,两种都开着,所以菜单点和手打都可以。

Native command 的会话隔离

原生命令有时会走独立会话,不完全等于普通文本聊天那条会话。

/stop 这种会专门对当前活跃聊天会话生效。

群聊里还有 mention / allowlist 规则

在群组里,不是你发了命令就一定处理,还要看:

  • 你有没有被允许发命令
  • 群组是否要求 @ 才触发
  • 这个命令是不是走了快路径

Inline shortcut 目前只有少数

目前更适合夹在自然语言里的,主要是:

/help
/commands
/status
/whoami
/id

别把所有命令都按这种方式用。

10. 说明

这页基于本机 OpenClaw 2026.3.x 的本地文档和当前配置整理。核心参考:docs/tools/slash-commands.md 与当前实例配置。以后命令集变了,这页也该同步更新。

Made for daily lookup. 能查到、看得懂、抄了就能用,这页就算达标。