信息与状态类命令

这类命令用于查看系统状态和获取帮助信息。

  • /help：显示常用命令帮助摘要，快速了解可用功能
  • /commands：列出所有可用斜杠命令的完整列表
  • /status：显示当前会话状态，包括使用的模型、token 用量、费用、配额等关键信息
  • /whoami 或 /id：显示你的发送者 ID，用于配置白名单时需要这个 ID
  • /context [list|detail|json]：查看当前上下文内容，detail 参数会显示每个文件、工具、技能、系统提示的大小

内联模式支持：以上命令中，/status、/help、/commands、/whoami 这 4 个命令支持嵌入在普通消息中使用，命令会被触发，剩余文字正常发给 AI。例如：

1
/status 顺便帮我总结一下今天    # 返回状态，"顺便帮我总结一下今天" 传给 AI

会话管理类命令

这类命令用于管理对话会话的生命周期。

  • /reset 或 /new [model]：开启新会话并重置上下文，可选指定使用的模型
  • /compact [instructions]：压缩当前会话上下文，减少 token 占用，适合长对话场景
  • /stop：中止当前正在运行的 AI 任务，并清空队列中的后续消息
  • /export-session [path] 或 /export：将当前会话导出为 HTML 文件，包含完整系统提示
  • /session idle <时长|off>：设置 Discord 线程绑定的空闲自动解绑超时时间
  • /session max-age <时长|off>：设置 Discord 线程绑定的最大存活时间

模型与推理类命令

这类命令用于控制 AI 模型的行为和推理方式。这些指令在消息发给模型之前会被剥离，单独发送时会持久化到会话，嵌入普通消息时为临时提示。

  • /think <off|minimal|low|medium|high|xhigh> 或 /t：设置 AI 思考深度，仅部分模型支持此功能
  • /verbose on|full|off 或 /v：开启或关闭详细输出模式，主要用于调试，在群组中慎用
  • /reasoning on|off|stream 或 /reason：开启或关闭推理输出，stream 模式仅在 Telegram 草稿模式下可用
  • /elevated on|off|ask|full 或 /elev：设置提升权限级别，full 会跳过 exec 审批
  • /model <名称> 或 /models：切换 AI 模型，支持序号、provider/model 格式、别名
  • /exec host=... security=... ask=... node=...：配置代码执行环境，包括沙箱、Gateway、Node 等选项及安全策略
  • /queue <模式>：配置消息队列模式，如 debounce:2s cap:25 drop:summarize

用量与费用类命令

这类命令用于监控 API 使用情况和费用。

  • /usage off|tokens|full|cost：控制每次回复的 token 和费用页脚显示，cost 参数可查看本地累计费用

子智能体与 ACP 类命令

这类命令用于管理子智能体和 ACP 运行时会话。

  • /subagents list|kill|log|info|send|steer|spawn：查看、控制或创建当前会话的子智能体
  • /kill <id|#|all>：立即中止一个或所有子智能体，无需确认
  • /steer <id|#> <消息> 或 /tell：向子智能体发送引导消息，实时修正其行为
  • /agents：列出当前会话的线程绑定智能体，主要用于 Discord 线程绑定场景
  • /acp spawn|cancel|steer|close|status|...：管理 ACP 运行时会话，用于连接 IDE

Discord 专属命令

这类命令仅在 Discord 平台可用。

  • /focus <目标>：将当前 Discord 线程绑定到指定会话或子智能体
  • /unfocus：解除当前 Discord 线程绑定
  • /vc join|leave|status：控制 Discord 语音频道，需要配置 channels.discord.voice

回复路由类命令

这类命令用于控制 AI 回复的发送目标和触发方式。

  • /dock-telegram：将 AI 回复切换到 Telegram 平台
  • /dock-discord：将 AI 回复切换到 Discord 平台
  • /dock-slack：将 AI 回复切换到 Slack 平台
  • /send on|off|inherit：控制是否发送回复，仅所有者可用
  • /activation mention|always：设置群聊触发方式，mention 仅在 @提及时响应，always 总是响应，仅在群组中可用

白名单与审批类命令

这类命令用于管理访问权限和执行审批。

  • /allowlist [add|remove]：列出、添加或删除允许使用命令的发送者，需要启用 commands.config: true
  • /approve <id> allow-once|allow-always|deny：审批 exec 工具的执行请求

配置类命令

这类命令用于修改 OpenClaw 配置，需要在配置文件中启用。

  • /config show|get|set|unset：持久化修改磁盘配置文件 openclaw.json，需要启用 commands.config: true
  • /debug show|set|unset|reset：临时运行时配置覆盖，不写入磁盘，重启后失效，需要启用 commands.debug: true

技能类命令

这类命令用于运行已安装的技能。

  • /skill <名称> [输入]：按名称运行一个技能（Skill）

TTS 语音类命令

这类命令用于控制文本转语音功能。

  • /tts off|always|inbound|tagged|status|...：控制文本转语音（TTS）行为，在 Discord 中使用 /voice 命令

Shell 和 Bash 类命令

这类命令用于在 Gateway 宿主机上执行 Shell 命令，需要在配置文件中启用。

  • /bash <命令> 或 ! <命令>：在 Gateway 宿主机上执行 Shell 命令，需要启用 commands.bash: true
  • !poll 或 /bash poll：查看后台 Bash 任务的输出和状态
  • !stop 或 /bash stop：停止正在运行的 Bash 任务

使用技巧

  • 命令补全：大多数平台支持输入 / 后显示命令列表
  • 内联使用：仅 /status、/help、/commands、/whoami 这 4 个命令支持嵌入在普通消息中使用（如 hey /status），命令会被触发，剩余文字正常发给 AI。其他命令（如 /reset、/compact、/think 等）必须单独发送
  • 持久化配置：单独发送的指令类命令会持久化到会话，嵌入消息中的为临时提示
  • 权限管理：敏感命令如 /config、/bash 需要在配置文件中显式启用
  • 群组使用：在群组中使用 /verbose 等调试命令时要谨慎，避免刷屏

参考资料