跳转到主要内容

​
斜杠命令

命令由网关处理。大多数命令必须作为以 / 开头的独立消息发送。仅主机的 bash 聊天命令使用 ! <cmd>(以 /bash <cmd> 作为别名)。 有两个相关系统:
  • 命令: 独立的 /... 消息。
  • 指令: /think、/verbose、/reasoning、/elevated、/exec、/model、/queue。
    • 在模型看到消息之前,指令会从消息中剥离。
    • 在正常聊天消息(非仅指令)中,它们被视为”内联提示”,不持久化会话设置。
    • 在仅指令消息(消息仅包含指令)中,它们持久化到会话并回复确认。
    • 指令仅对授权发送者(频道允许列表/配对加 commands.useAccessGroups)应用。未授权的发送者看到指令被视为纯文本。
还有一些内联快捷方式(仅允许列表/授权发送者): /help、/commands、/status、/whoami(/id)。它们立即运行,在模型看到消息之前被剥离,剩余文本继续正常流程。

​
配置

{
  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 以每个提供商覆盖(bool 或 "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 以每个提供商覆盖(bool 或 "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(解决 exec 批准提示)
  • /context [list|detail|json](解释”上下文”;detail 显示每个文件 + 每个工具 + 每个技能 + 系统提示大小)
  • /whoami(显示您的发送者 id;别名: /id)
  • /subagents list|stop|log|info|send(检查、停止、记录或消息当前会话的子 agent 运行)
  • /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 批准)
  • /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: 仍支持 channels.slack.slashCommand 用于单个 /openclaw 风格命令。如果启用 commands.native,您必须为每个内置命令创建一个 Slack 斜杠命令(与 /help 相同的名称)。Slack 的命令参数菜单作为临时 Block Kit 按钮提供。