OpenClaw Slash Commands 完整参考手册

2026年6月6日 by Yuan

基于官方文档 docs.openclaw.ai/tools/slash-commands 整理

命令机制说明

OpenClaw 的命令系统分为三类：

Commands（命令）：发送以 / 开头的独立消息触发，Gateway 处理，不进入模型上下文。

Directives（指令）：/think、/fast、/verbose、/reasoning、/elevated、/model、/queue 等。消息发送前被 Gateway 剥离，模型不可见。

在普通消息中内联使用（如 帮我分析一下 /think high）：仅对当次请求生效，不持久化
作为独立消息发送（如只发 /think high）：写入会话状态并持久化，直到下次修改

Inline shortcuts（内联快捷）：/help、/commands、/status、/whoami 可嵌入普通消息使用，触发后被剥离，剩余文本正常走模型流程。例：今天怎么样 /status 会同时返回状态信息并继续处理问候。

权限说明：命令只对白名单授权用户生效。未授权用户发送命令会被静默忽略，内联 /... 被当作普通文本处理。

一、快速查询（内联快捷）

`/help`

显示简短帮助摘要。

/help

可嵌入普通消息：出错了 /help

`/commands`

列出当前 Gateway 所有可用命令。

/commands

`/status`

显示当前运行状态，包括 Gateway 状态、系统运行时间、当前模型提供商的用量/配额（如剩余百分比）。

/status

提供商用量以”剩余 X%”格式显示（如 “Claude 80% left”）
Token/缓存数据从实时会话快照获取，不可用时回退至最新转录记录
详细提供商用量可通过 CLI 命令 openclaw status --usage 查看

`/whoami` / `/id`

显示当前发送者的 ID（用于确认身份和白名单配置）。

/whoami
/id

二、会话控制

`/new [model]`

归档当前会话，开始一个新的会话。可选指定模型。

/new
/new claude-sonnet-4-6
/new openai/gpt-4o

支持模型别名、provider/model 格式或提供商名称（模糊匹配）
若无法匹配模型名，文本内容会被当作消息正文处理

`/reset [soft [message]]`

原地重置当前会话（不归档）。

/reset
/reset soft
/reset soft 你好，重新开始

不带参数：硬重置，清空上下文
soft：软重置，保留部分上下文，可附带新的开场消息

`/compact [instructions]`

压缩当前上下文（仅文本命令，不支持原生命令）。触发后 Gateway 会将上下文摘要化，减少 token 占用。

/compact
/compact 重点保留代码相关内容

参见官方文档：Compaction

`/stop`

终止当前正在运行的任务/请求。

/stop

/stop 针对当前活跃的聊天会话发送中止信号
子代理中止：使用 /kill <id|#|all>

`/export-session [path]` / `/export`

将当前会话导出为 HTML 文件，包含完整系统提示。

/export-session
/export
/export-session /tmp/my-session.html

`/export-trajectory`

导出 JSONL 格式的会话轨迹包，包含工具调用、推理步骤等原始数据，适合调试和分析。

/export-trajectory

`/session idle <duration|off>`

管理聚焦线程绑定的闲置自动解绑超时。需要已启用线程绑定（Discord）。

/session idle 30m
/session idle 1h
/session idle off

`/session max-age <duration|off>`

管理聚焦线程绑定的硬性最大存活时间，超时后自动解绑。

/session max-age 2h
/session max-age off

三、模型 & 运行控制

`/think <level>`

设置模型思考深度级别（别名：/thinking、/t）。

/think off
/think minimal
/think low
/think medium
/think high
/think xhigh

可用级别因模型和提供商不同而有差异
作为独立消息发送时持久化到会话，内联使用仅对当次生效
Anthropic Claude Opus 4.8 在 OpenClaw 中默认关闭思考；Claude 4.6 系列默认为 adaptive

`/verbose on|full|off`

切换详细输出模式（别名：/v）。

/verbose on
/verbose full
/verbose off

on：显示工具失败详情等额外信息
full：最详细输出
正常使用时建议保持 off
⚠️ 群聊中使用有风险：可能暴露内部推理或工具输出，不建议在群组中开启

`/trace on|off`

切换插件/工具调用追踪日志。

/trace on
/trace off

`/fast on|off|status`

快速模式开关，映射到提供商的优先服务层。

/fast on
/fast off
/fast status

仅发送 status 或不带参数显示当前状态
OpenAI/Codex 映射为 service_tier=priority
Anthropic 映射为 service_tier=auto 或 standard_only
持久化到会话；在 Sessions UI 选 inherit 可清除并回退到配置默认值

`/reasoning on|off|stream`

控制推理过程的可见性（别名：/reason）。

/reasoning on
/reasoning off
/reasoning stream

on：将推理过程作为独立消息发送，前缀为 Reasoning:
stream：仅在 Telegram 中以草稿形式流式展示
⚠️ 群聊中使用有风险，建议关闭

`/elevated on|off|ask|full`

提权模式（别名：/elev），控制工具执行权限。

/elevated on
/elevated off
/elevated ask
/elevated full

ask：执行前询问确认
full：跳过 exec 审批直接执行
需要 tools.elevated 白名单配置

参见官方文档：Elevated Mode

`/model [name|status|list]`

查看或切换当前会话使用的模型（别名：/models）。

/model
/model list
/model 3
/model openai/gpt-4o
/model claude-sonnet-4-6
/model opus@anthropic:default
/model status

/model 或 /model list：显示编号选择器（模型系列 + 可用提供商）
/model <#>：按编号选择
/model status：显示详细信息，包括提供商端点 baseUrl 和 API 模式
Discord 上 /model 会打开含提供商和模型下拉菜单的交互选择器
模型切换立即持久化；若有任务运行中，会在干净的重试点切换

`/models [provider]`

列出可用模型（按提供商过滤）。

/models
/models anthropic
/models openai

`/queue <mode>`

管理运行队列，支持去抖、上限、丢弃策略等选项。

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

不带参数：显示当前队列设置
debounce：去抖时间
cap：队列上限
drop:summarize：超限时摘要丢弃

`/steer <message>`

在当前运行过程中实时引导/修正输出方向。

/steer 请用中文回答
/steer 重点放在安全方面

四、技能 & 工具

`/skill <name> [input]`

按名称运行一个技能（Skill）。

/skill translate 这段话需要翻译
/skill summarize
/skill prose my-workflow.prose

适用于原生命令数量限制导致技能无法单独注册为命令的场景
默认将命令作为普通请求转发给模型
技能可声明 command-dispatch: tool 实现直接路由（不经模型，确定性执行）

`/tools [compact|verbose]`

查看当前会话中 Agent 实际可用的工具列表（运行时状态，非静态配置）。

/tools
/tools compact
/tools verbose

默认显示紧凑格式
verbose：附带简短描述
结果是会话作用域的：更换 Agent、频道、线程、发送者授权或模型都可能改变输出

`/allowlist list|add|remove`

管理命令/工具执行的发送者白名单。

/allowlist list
/allowlist add discord:user:123456789
/allowlist remove discord:user:123456789

add/remove 需要 commands.config: true，且遵守频道的 configWrites 设置
多账号频道支持 --account <id> 参数

`/approve <id> <decision>`

审批待处理的 exec 执行请求。

/approve abc123 allow
/approve abc123 deny

<id> 从待审批消息中获取
可用决策选项见待审批消息内容

`/btw <question>`

附带提问：针对当前会话上下文的旁路问题，不影响后续会话上下文。

/btw 这段代码是什么语言写的？
/btw 之前提到的端口号是多少？

参见官方文档：BTW Side Questions

`/context [list|detail|json]`

查看当前上下文组成，便于排查 token 占用。

/context
/context list
/context detail
/context json

detail：显示每个文件、工具、技能、系统提示的大小

五、子代理 & ACP

`/subagents list|log|info|send|steer|spawn|kill`

查看和控制当前会话的子代理运行状态。

/subagents list
/subagents log
/subagents info
/subagents kill all
/subagents steer 1 请用中文输出

list：列出当前会话的子代理运行
log：查看子代理日志
info：显示运行元数据（状态、时间戳、会话 ID、转录路径）
spawn：手动启动子代理
steer：实时引导指定子代理

`/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions`

管理 ACP（Agent Coordination Protocol）运行时会话。

/acp status
/acp spawn
/acp cancel
/acp sessions
/acp doctor
/acp model claude-sonnet-4-6

参见官方文档：ACP Agents

`/focus <target>` / `/unfocus`

绑定/解除当前 Discord 线程到指定会话或子代理（Discord 专属）。

/focus session:abc123
/focus subagent:2
/unfocus

需要启用线程绑定：session.threadBindings.enabled 或 channels.discord.threadBindings.enabled

`/agents`

列出当前会话已绑定的代理。

/agents

`/kill <id|#|all>`

立即中止一个或所有子代理（无确认消息）。

/kill 1
/kill all

`/tell <id|#> <message>` / `/steer <id|#> <message>`

引导指定子代理：运行中时实时引导，否则中止当前任务并以新消息重启。

/tell 1 请重新整理输出格式
/steer 2 聚焦在安全漏洞分析

六、Owner 权限命令

以下命令均为 Owner 专属，默认禁用，需在配置中显式开启。

`/config show|get|set|unset`

读写持久化配置文件（openclaw.json）。需 commands.config: true。

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

写入前会进行验证，非法值会被拒绝
修改在重启后依然生效

`/mcp show|get|set|unset`

管理 OpenClaw 托管的 MCP 服务器配置（mcp.servers 下）。需 commands.mcp: true。

/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7

`/plugins list|show|get|install|enable|disable`

插件管理（别名：/plugin）。需 commands.plugins: true，写操作仅限 Owner。

/plugins list
/plugins show open-prose
/plugins install clawhub:open-prose
/plugins install ./my-local-plugin
/plugins enable open-prose
/plugins disable open-prose

/plugin install <spec> 支持本地路径/压缩包、npm 包、clawhub:<pkg> 格式
启用/禁用后会提示重启；若 Gateway 在前台监听模式运行，可能自动触发重启

`/debug show|set|unset|reset`

运行时配置覆盖（内存级，不写磁盘）。需 commands.debug: true。

/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+86138xxxx","+86139xxxx"]
/debug unset messages.responsePrefix
/debug reset

覆盖立即生效，但不写入 openclaw.json
/debug reset 清除所有覆盖，回到磁盘配置状态

`/restart`

重启 Gateway 进程。默认启用，可通过 commands.restart: false 禁用。

/restart

七、其他功能命令

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

控制 TTS（文字转语音）功能。Discord 上原生命令名为 /voice（Discord 保留了 /tts），文本命令 /tts 仍有效。

/tts status
/tts on
/tts off
/tts always
/tts inbound
/tts tagged
/tts audio
/tts provider elevenlabs
/tts limit 500
/tts summary

always：所有回复都转语音
inbound：仅语音输入触发语音回复
tagged：仅标记内容转语音
audio：生成一次性语音回复（不持久开启 TTS）
/tts status：显示当前模式、提供商、模型、音色，以及最近一次的回退诊断信息

参见官方文档：Text-to-speech

`/goal status|start|pause|...`

目标管理：启动、暂停或查看当前目标任务状态。

/goal status
/goal start 整理本周报告
/goal pause

`/usage off|tokens|full|cost`

控制每条回复后的用量展示页脚。

/usage off
/usage tokens
/usage full
/usage cost

tokens：显示 token 用量
full：显示完整用量信息
cost：从本地 OpenClaw 会话日志中打印费用摘要
/usage 控制的是每条回复的页脚展示；完整提供商用量明细用 CLI openclaw status --usage

`/session idle <duration|off>` / `/session max-age <duration|off>`

见「会话控制」章节。

`/dreaming on|off|core|rem|deep|status|help`

控制记忆梦境（Dreaming）功能。

/dreaming status
/dreaming on
/dreaming off
/dreaming core
/dreaming rem
/dreaming deep
/dreaming help

core / rem / deep：不同深度的记忆整合模式
参见官方文档：Dreaming

`/pair qr|status|pending|...`

设备配对管理，用于移动端节点连接。

/pair qr
/pair status
/pair pending

`/bash <command>` / `! <command>`

在宿主机上执行 Shell 命令（需 commands.bash: true + tools.elevated 白名单）。

! ls -la
! cat /etc/os-release
/bash ls -la
!poll
!stop

一次只能运行一个命令
!poll：检查后台运行命令的输出/状态（也可用 /bash poll）
!stop：停止正在运行的后台命令（也可用 /bash stop）
bashForegroundMs（默认 2000ms）：超时后切换到后台模式；设为 0 立即后台化

`/context [list|detail|json]`

见「技能 & 工具」章节。

`/activation mention|always`

群组消息触发模式（群组专属）。

/activation mention
/activation always

mention：仅 @提及时响应
always：所有消息都响应

`/send on|off|inherit`

控制当前频道的消息发送行为（Owner 专属）。

/send on
/send off
/send inherit

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

将回复输出切换到指定频道。

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

附录：命令速查表

分类	命令	是否持久化	权限要求
查询	`/help` `/commands` `/status` `/whoami`	否	白名单用户
会话	`/new` `/reset` `/compact` `/stop` `/export`	部分	白名单用户
模型	`/model` `/models` `/think` `/fast` `/queue`	是	白名单用户
运行	`/verbose` `/reasoning` `/elevated` `/trace`	是	白名单用户
工具	`/tools` `/skill` `/btw` `/allowlist` `/approve`	否	白名单用户
子代理	`/subagents` `/acp` `/focus` `/kill` `/steer`	否	白名单用户
Owner	`/config` `/mcp` `/plugins` `/debug` `/restart`	是	Owner
其他	`/tts` `/dreaming` `/usage` `/bash` `/pair`	是	白名单用户

整理自 OpenClaw 官方文档，版本截至 2026 年 6 月。

命令机制说明

一、快速查询（内联快捷）

/help

/commands

/status

/whoami / /id

二、会话控制

/new [model]

/reset [soft [message]]

/compact [instructions]

/stop

/export-session [path] / /export

/export-trajectory

/session idle <duration|off>

/session max-age <duration|off>

三、模型 & 运行控制

/think <level>

/verbose on|full|off

/trace on|off

/fast on|off|status

/reasoning on|off|stream

/elevated on|off|ask|full

/model [name|status|list]

/models [provider]

/queue <mode>

/steer <message>

四、技能 & 工具

/skill <name> [input]

/tools [compact|verbose]

/allowlist list|add|remove

/approve <id> <decision>

/btw <question>

/context [list|detail|json]

五、子代理 & ACP

/subagents list|log|info|send|steer|spawn|kill

/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions

/focus <target> / /unfocus

/agents

/kill <id|#|all>

/tell <id|#> <message> / /steer <id|#> <message>

六、Owner 权限命令

/config show|get|set|unset

/mcp show|get|set|unset

/plugins list|show|get|install|enable|disable

/debug show|set|unset|reset

/restart

七、其他功能命令

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

/goal status|start|pause|...

/usage off|tokens|full|cost

/session idle <duration|off> / /session max-age <duration|off>

/dreaming on|off|core|rem|deep|status|help

/pair qr|status|pending|...

/bash <command> / ! <command>

/context [list|detail|json]

/activation mention|always

/send on|off|inherit

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

附录：命令速查表

`/help`

`/commands`

`/status`

`/whoami` / `/id`

`/new [model]`

`/reset [soft [message]]`

`/compact [instructions]`

`/stop`

`/export-session [path]` / `/export`

`/export-trajectory`

`/session idle <duration|off>`

`/session max-age <duration|off>`

`/think <level>`

`/verbose on|full|off`

`/trace on|off`

`/fast on|off|status`

`/reasoning on|off|stream`

`/elevated on|off|ask|full`

`/model [name|status|list]`

`/models [provider]`

`/queue <mode>`

`/steer <message>`

`/skill <name> [input]`

`/tools [compact|verbose]`

`/allowlist list|add|remove`

`/approve <id> <decision>`

`/btw <question>`

`/context [list|detail|json]`

`/subagents list|log|info|send|steer|spawn|kill`

`/acp spawn|cancel|steer|close|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|sessions`

`/focus <target>` / `/unfocus`

`/agents`

`/kill <id|#|all>`

`/tell <id|#> <message>` / `/steer <id|#> <message>`

`/config show|get|set|unset`

`/mcp show|get|set|unset`

`/plugins list|show|get|install|enable|disable`

`/debug show|set|unset|reset`

`/restart`

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

`/goal status|start|pause|...`

`/usage off|tokens|full|cost`

`/session idle <duration|off>` / `/session max-age <duration|off>`

`/dreaming on|off|core|rem|deep|status|help`

`/pair qr|status|pending|...`

`/bash <command>` / `! <command>`

`/context [list|detail|json]`

`/activation mention|always`

`/send on|off|inherit`

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