斜杠命令

适用范围

在以下情况使用本页面：

• 使用或配置聊天命令
• 调试命令路由或权限

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

有两个相关的系统：

• 命令：独立的 /... 消息。
• 指令：/think、/verbose、/reasoning、/elevated、/exec、/model、/queue。
  • 指令在模型看到消息之前从消息中剥离。
  • 在正常聊天消息中（非仅指令），它们被视为"内联提示"，不持久化会话设置。
  • 在仅指令消息中（消息仅包含指令），它们持久化到会话并回复确认。

还有一些内联快捷方式（仅限允许列表/授权发送者）：/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"）注册原生命令。
  • 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"）在支持时原生注册技能命令。
  • 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（读取/写入 moltbot.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（检查、停止、记录或消息当前会话的子代理运行）
• /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 或提供商名称（模糊匹配）；如果没有匹配，文本将被视为消息正文。
• 有关完整的提供商使用细分，请使用 moltbot status --usage。
• /allowlist add|remove 需要 commands.config=true 并遵守频道 configWrites。
• /usage 控制每响应使用页脚；/usage cost 从 Moltbot 会话日志打印本地成本摘要。
• /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% left”）在启用使用跟踪时显示在当前模型提供商的 /status 中。
• 每响应令牌/成本由 /usage off|tokens|full 控制（附加到正常回复）。
• /model status 关于模型/身份验证/端点，而不是使用。

模型选择（/model）

/model 被实现为指令。

示例：

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

注意：

• /model 和 /model list 显示紧凑的、编号的选择器（模型系列 + 可用的提供商）。
• /model <#> 从该选择器中选择（并尽可能优先考虑当前提供商）。
• /model status 显示详细视图，包括配置的提供商端点（baseUrl）和 API 模式（api）（如果可用）。

调试覆盖

/debug 允许您设置仅运行时配置覆盖（内存，而不是磁盘）。仅所有者。默认禁用；通过 commands.debug: true 启用。

示例：

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

注意：

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

配置更新

/config 写入您的磁盘配置（moltbot.json）。仅所有者。默认禁用；通过 commands.config: true 启用。

示例：

/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[moltbot]"
/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 仍然支持单个 /clawd 样式命令。如果您启用 commands.native，您必须为每个内置命令创建一个 Slack 斜杠命令（与 /help 同名）。Slack 的命令参数菜单作为临时 Block Kit 按钮传递。