斜杠命令

命令由网关处理。大多数命令必须作为以 / 开头的独立消息发送。仅限主机的 bash 聊天命令使用 ! <cmd>(/bash <cmd> 作为别名)。

有两个相关系统:

命令: 独立的 /... 消息。
指令: /think、/verbose、/reasoning、/elevated、/exec、/model、/queue。
- 指令在模型看到消息之前被剥离。
- 在普通聊天消息中(非纯指令消息),它们被视为"内联提示",不会持久化会话设置。
- 在纯指令消息中(消息仅包含指令),它们会持久化到会话并回复确认消息。
- 指令仅对授权发送者生效(频道白名单/配对加 commands.useAccessGroups)。未授权发送者看到的指令会被视为纯文本。

还有一些内联快捷方式(仅限白名单/授权发送者): /help、/commands、/status、/whoami(/id)。它们立即运行,在模型看到消息之前被剥离,剩余文本继续通过正常流程。

配置

json5

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    debug: false,
    restart: false,
    useAccessGroups: true,
  },
}

commands.text(默认 true)启用聊天消息中的 /... 解析。
- 在没有原生命令的平台上(WhatsApp/WebChat/Signal/iMessage/Google Chat/MS Teams),即使设置为 false,文本命令仍然有效。
commands.native(默认 "auto")注册原生命令。
- 自动: Discord/Telegram 开启;Slack 关闭(直到添加斜杠命令);不支持的提供商忽略。
- 设置 channels.discord.commands.native、channels.telegram.commands.native 或 channels.slack.commands.native 按提供商覆盖(布尔值或 "auto")。
- false 在启动时清除 Discord/Telegram 上先前注册的命令。Slack 命令在 Slack 应用中管理,不会自动删除。
commands.nativeSkills(默认 "auto")在支持时原生注册技能命令。
- 自动: Discord/Telegram 开启;Slack 关闭(Slack 需要为每个技能创建斜杠命令)。
- 设置 channels.discord.commands.nativeSkills、channels.telegram.commands.nativeSkills 或 channels.slack.commands.nativeSkills 按提供商覆盖(布尔值或 "auto")。
commands.bash(默认 false)启用 ! <cmd> 运行主机 shell 命令(/bash <cmd> 是别名;需要 tools.elevated 白名单)。
commands.bashForegroundMs(默认 2000)控制 bash 切换到后台模式前的等待时间(0 立即后台运行)。
commands.config(默认 false)启用 /config(读写 openclaw.json)。
commands.debug(默认 false)启用 /debug(仅运行时覆盖)。
commands.useAccessGroups(默认 true)为命令强制执行白名单/策略。

命令列表

文本 + 原生(启用时):

/help
/commands
/skill <name> [input](按名称运行技能)
/status(显示当前状态;包含当前模型提供商的用量/配额,如果可用)
/allowlist(列出/添加/删除白名单条目)
/approve <id> allow-once|allow-always|deny(解决执行审批提示)
/context [list|detail|json](解释"上下文";detail 显示每个文件 + 每个工具 + 每个技能 + 系统提示大小)
/whoami(显示你的发送者 ID;别名: /id)
/subagents list|stop|log|info|send(检查、停止、记录或向当前会话的子代理运行发送消息)
/config show|get|set|unset(将配置持久化到磁盘,仅所有者;需要 commands.config: true)
/debug show|set|unset|reset(运行时覆盖,仅所有者;需要 commands.debug: true)
/usage off|tokens|full|cost(每个响应的用量页脚或本地成本摘要)
/tts off|always|inbound|tagged|status|provider|limit|summary|audio(控制 TTS;参见 /tts)
- Discord: 原生命令是 /voice(Discord 保留了 /tts);文本 /tts 仍然有效。
/stop
/restart
/dock-telegram(别名: /dock_telegram)(将回复切换到 Telegram)
/dock-discord(别名: /dock_discord)(将回复切换到 Discord)
/dock-slack(别名: /dock_slack)(将回复切换到 Slack)
/activation mention|always(仅限群组)
/send on|off|inherit(仅所有者)
/reset 或 /new [model](可选模型提示;其余部分传递)
/think <off|minimal|low|medium|high|xhigh>(按模型/提供商动态选择;别名: /thinking、/t)
/verbose on|full|off(别名: /v)
/reasoning on|off|stream(别名: /reason;开启时,发送前缀为 Reasoning: 的单独消息;stream = 仅 Telegram 草稿)
/elevated on|off|ask|full(别名: /elev;full 跳过执行审批)
/exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>(发送 /exec 显示当前状态)
/model <name>(别名: /models;或从 agents.defaults.models.*.alias 发送 /<alias>)
/queue <mode>(加上 debounce:2s cap:25 drop:summarize 等选项;发送 /queue 查看当前设置)
/bash <command>(仅限主机;! <command> 的别名;需要 commands.bash: true + tools.elevated 白名单)

仅文本:

/compact [instructions](参见 /concepts/compaction)
! <command>(仅限主机;一次一个;对于长时间运行的作业使用 !poll + !stop)
!poll(检查输出/状态;接受可选的 sessionId;/bash poll 也有效)
!stop(停止运行中的 bash 作业;接受可选的 sessionId;/bash stop 也有效)

注意:

命令在命令和参数之间接受可选的 :(例如 /think: high、/send: on、/help:)。
/new <model> 接受模型别名、provider/model 或提供商名称(模糊匹配);如果没有匹配,文本被视为消息正文。
对于完整的提供商用量明细,使用 openclaw status --usage。
/allowlist add|remove 需要 commands.config=true 并遵守频道 configWrites。
/usage 控制每个响应的用量页脚;/usage cost 从 OpenClaw 会话日志打印本地成本摘要。
/restart 默认禁用;设置 commands.restart: true 启用。
/verbose 用于调试和额外可见性;在正常使用中保持关闭。
/reasoning(和 /verbose)在群组设置中有风险:它们可能泄露你不想公开的内部推理或工具输出。最好保持关闭,尤其是在群聊中。
快速路径: 白名单发送者的纯命令消息立即处理(绕过队列 + 模型)。
群组提及限制: 白名单发送者的纯命令消息绕过提及要求。
内联快捷方式(仅限白名单发送者): 某些命令在嵌入到普通消息中时也有效,并在模型看到剩余文本之前被剥离。
- 示例: hey /status 触发状态回复,剩余文本继续通过正常流程。
目前: /help、/commands、/status、/whoami(/id)。
未授权的纯命令消息被静默忽略,内联 /... 标记被视为纯文本。
技能命令: user-invocable 技能作为斜杠命令公开。名称被清理为 a-z0-9_(最多 32 个字符);冲突获得数字后缀(例如 _2)。
- /skill <name> [input] 按名称运行技能(当原生命令限制阻止每个技能命令时很有用)。
- 默认情况下,技能命令作为正常请求转发给模型。
- 技能可以选择声明 command-dispatch: tool 将命令直接路由到工具(确定性,无模型)。
- 示例: /prose(OpenProse 插件)— 参见 OpenProse。
原生命令参数: Discord 使用自动完成处理动态选项(当省略必需参数时使用按钮菜单)。当命令支持选项且省略参数时,Telegram 和 Slack 显示按钮菜单。

使用场景(什么显示在哪里)

提供商用量/配额(示例:"Claude 剩余 80%")在启用用量跟踪时显示在当前模型提供商的 /status 中。
每个响应的令牌/成本由 /usage off|tokens|full 控制(附加到正常回复)。
/model status 是关于模型/认证/端点,而非用量。

模型选择(`/model`)

/model 作为指令实现。

示例:

/model
/model list
/model 3
/model openai/gpt-5.2
/model opus@anthropic:default
/model status

注意:

/model 和 /model list 显示紧凑的编号选择器(模型系列 + 可用提供商)。
/model <#> 从该选择器中选择(并在可能时优先使用当前提供商)。
/model status 显示详细视图,包括配置的提供商端点(baseUrl)和 API 模式(api,如果可用)。

调试覆盖

/debug 允许设置仅运行时配置覆盖(内存,而非磁盘)。仅所有者。默认禁用;使用 commands.debug: true 启用。

示例:

/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset

注意:

覆盖立即应用于新的配置读取,但不会写入 openclaw.json。
使用 /debug reset 清除所有覆盖并返回磁盘配置。

配置更新

/config 写入磁盘配置(openclaw.json)。仅所有者。默认禁用;使用 commands.config: true 启用。

示例:

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

注意:

写入前验证配置;无效更改被拒绝。
/config 更新在重启后持久化。

平台说明

文本命令在正常聊天会话中运行(DM 共享 main,群组有自己的会话)。
原生命令使用隔离会话:
- Discord: agent:<agentId>:discord:slash:<userId>
- Slack: agent:<agentId>:slack:slash:<userId>(前缀可通过 channels.slack.slashCommand.sessionPrefix 配置)
- Telegram: telegram:slash:<userId>(通过 CommandTargetSessionKey 定位聊天会话)
/stop 定位活动聊天会话,以便中止当前运行。
Slack: 对于单个 /openclaw 样式的命令,仍然支持 channels.slack.slashCommand。如果启用 commands.native,则必须为每个内置命令创建一个 Slack 斜杠命令(与 /help 同名)。Slack 的命令参数菜单以临时 Block Kit 按钮形式交付。

斜杠命令 ​

配置 ​

命令列表 ​

使用场景(什么显示在哪里) ​

模型选择(/model) ​

调试覆盖 ​

配置更新 ​

平台说明 ​