斜杠命令

Gateway(网关) 处理以 Gateway(网关)/ 开头的独立消息形式发送的命令。仅限主机使用的 bash 命令使用 ! <cmd>（以 /bash <cmd> 作为别名）。

当对话绑定到 ACP 会话时，普通文本会路由到 ACP harness。Gateway(网关) 管理命令保持本地：Gateway(网关)/acp ...OpenClaw 始终到达 OpenClaw 命令处理程序，而 /status 加上 /unfocus 在为该表面启用命令处理时始终保持本地状态。

三种命令类型

Commands

由 Gateway(网关) 处理的独立 /...Gateway(网关) 消息。必须作为消息中的唯一内容发送。

Directives

/think、/fast、/verbose、/trace、/reasoning、/elevated、 /exec、/model、/queue — 在模型看到之前从消息中剥离。单独发送时持久化会话设置；与其他文本一起发送时充当内联提示。

Inline shortcuts

/help、/commands、/status、/whoami — 立即运行，并在模型看到剩余文本之前被剥离。仅限授权发送者使用。

Directive behavior details

指令在模型看到消息之前从消息中剥离。 - 在仅指令消息（消息仅包含指令）中，它们会持久化到会话并回复确认。 - 在包含其他文本的正常聊天消息中，它们充当内联提示，并且不持久化会话设置。 - 指令仅适用于授权发送者。如果设置了 commands.allowFrom，它将作为唯一使用的允许列表；否则授权来自渠道允许列表/配对加上 commands.useAccessGroups。未经授权的发送者将看到指令被当作纯文本处理。

配置

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    mcp: false,
    plugins: false,
    debug: false,
    restart: true,
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw",
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

启用聊天消息中的 `/...` 解析。在没有原生命令的界面（WhatsApp、WebChat、Signal、iMessage、Google Chat、Microsoft Teams）上，即使设置为 `false`，文本命令仍然有效。注册原生命令。自动模式：Discord/Telegram 开启；Slack 关闭；对于不支持原生的提供程序则忽略。使用 `channels..commands.native` 按渠道覆盖。在 Discord 上，`false` 会跳过斜杠命令注册；之前注册的命令可能会保持可见，直到被移除。

<ParamField path=“commands.nativeSkills” type=‘boolean | “auto”’ default=‘“auto“‘DiscordTelegramSlack> 在受支持时原生注册技能命令。自动：Discord/Telegram 开启；Slack 关闭。使用 channels.<provider>.commands.nativeSkills 覆盖。

启用 `! ` 以运行主机 Shell 命令（`/bash ` 别名）。需要 `tools.elevated` 允许列表。 bash 在切换到后台模式之前等待的时间（`0` 立即后台运行）。启用 `/config`（读取/写入 `openclaw.json`）。仅限所有者。启用 `/mcp`OpenClaw（读取/写入 OpenClaw 管理的位于 `mcp.servers` 下的 MCP 配置）。仅限所有者。启用 `/plugins`（插件发现/状态以及安装 + 启用/禁用）。写入操作仅限所有者。启用 `/debug`（仅运行时配置覆盖）。仅限所有者。启用 `/restart` 和网关重启工具动作。仅限所有者命令界面的显式所有者允许列表。与 `commands.allowFrom` 和私信配对访问分开。逐渠道：仅限所有者的命令需要所有者身份。当 `true` 时，发送者必须匹配 `commands.ownerAllowFrom` 或持有内部 `operator.admin` 范围。通配符 `allowFrom` 条目是**不**充分的。控制所有者 ID 在系统提示词中的显示方式。当 `commands.ownerDisplay: "hash"` 时使用的 HMAC 密钥。用于命令授权的逐提供商白名单。配置后，它是命令和指令的 **唯一**授权来源。使用 `"*"` 作为全局默认值；特定于提供商的键会覆盖它。当未设置 `commands.allowFrom` 时，对命令执行白名单/策略。

命令列表

命令来自三个来源：

核心内置命令： src/auto-reply/commands-registry.shared.ts
生成的 Dock 命令： src/auto-reply/commands-registry.data.ts
插件命令： 插件 registerCommand() 调用

可用性取决于配置标志、渠道界面以及已安装/已启用的插件。

核心命令

会话和运行

命令	描述
`/new [model]`	归档当前会话并启动一个新会话
`/reset [soft [message]]`	原地重置当前会话。`soft`CLI 保留记录，丢弃重用的 CLI 后端会话 ID，并重新运行启动流程
`/compact [instructions]`	压缩会话上下文。请参阅压缩
`/stop`	中止当前运行
`/session idle

| 管理线程绑定的空闲过期 | |/session max-age

模型与运行控制

命令	描述
`/think

security=

ask=

node=

|all]| 列出已配置/可认证的提供商或模型 | |/queue

| 管理活动运行队列行为。参阅 [队列](/zh/concepts/queue) 和 [队列引导](/zh/concepts/queue-steering) | |/steer

| 向活动运行注入指导。别名：/tell`。参阅引导 |

verbose / trace / fast / reasoning safety

/verbose 用于调试 — 正常使用时请保持关闭。
/trace 仅显示插件拥有的跟踪/调试行；正常的详细闲聊保持关闭。
/fast on|off 会持久化会话覆盖设置；使用会话 UI 中的 inherit 选项来清除它。
/fastOpenAI 特定于提供商：OpenAI/Codex 将其映射到 service_tier=priorityAnthropic；直接的 Anthropic 请求将其映射到 service_tier=auto 或 standard_only。
/reasoning、/verbose 和 /trace 在群组设置中有风险 — 它们可能会泄露内部推理或插件诊断信息。在群聊中请保持关闭。

模型切换详情

/model 会立即将新模型持久化到会话中。
如果代理处于空闲状态，下次运行将立即使用它。
如果运行处于活动状态，切换将被标记为待处理，并在下一个干净的重试点应用。

发现和状态

命令	描述
`/help`	显示简短的帮助摘要
`/commands`	显示生成的命令目录
`/tools [compact\|verbose]`	显示当前 Agent 现在可以使用的内容
`/status`	显示执行/运行时状态、Gateway(网关) 和系统运行时间，以及提供商使用情况/配额
`/goal [status\|start\|pause\|resume\|complete\|block\|clear] ...`	管理当前会话的持久 goal
`/diagnostics [note]`	仅限所有者的支持报告流程。每次都请求执行批准
`/crestodian

Skills、允许列表、批准

命令	描述
`/skill

| 解决执行或插件批准提示 | |/btw

| 提一个附带问题而不更改会话上下文。别名：/side`。参见 BTW |

子代理和 ACP

命令	描述
`/subagents list\|log\|info`	检查当前会话的子代理运行情况
`/acp spawn\|cancel\|steer\|close\|sessions\|status\|set-mode\|set\|cwd\|permissions\|timeout\|model\|reset-options\|doctor\|install\|help`	管理 ACP 会话和运行时选项
`/focus

仅限所有者写入和管理

| 命令 | 需要 | 描述 | | --- | --- | --- | | /config show\|get\|set\|unset | commands.config: true | 读取或写入 openclaw.json。仅限所有者 | | /mcp show\|get\|set\|unset | commands.mcp: true | 读取或写入 OpenClaw 管理的 MCP 服务器配置。仅限所有者 | | /plugins list\|inspect\|show\|get\|install\|enable\|disable | commands.plugins: true | 检查或修改插件状态。写入仅限所有者。别名：/plugin | | /debug show\|set\|unset\|reset | commands.debug: true | 仅运行时配置覆盖。仅限所有者 | | /restart | commands.restart: true（默认） | 重启 OpenClaw | | /send on\|off\|inherit | owner | 设置发送策略 |

语音、TTS、渠道控制

命令	描述
`/tts on\|off\|status\|chat\|latest\|provider\|limit\|summary\|audio\|help`	控制 TTS。参见 TTS
`/activation mention\|always`	设置群组激活模式
`/bash

| 运行主机 Shell 命令。别名：!

Dock 命令

Dock 命令将活动会话的回复路由切换到另一个链接渠道。有关设置和故障排除，请参阅渠道对接。

由支持原生命令的渠道插件生成：

/dock-discord（别名：/dock_discord）
/dock-mattermost（别名：/dock_mattermost）
/dock-slack（别名：/dock_slack）
/dock-telegram（别名：/dock_telegram）

Dock 命令需要 session.identityLinks。源发送者和目标对等方必须在同一个身份组中。

捆绑插件命令

命令	描述
`/dreaming [on\|off\|status\|help]`	切换记忆梦境。请参阅梦境
`/pair [qr\|status\|pending\|approve\|cleanup\|notify]`	管理设备配对。请参阅配对
`/phone status\|arm ...\|disarm`	临时启用高风险电话节点命令
`/voice status\|list\|set <voiceId>`	管理 Talk 语音配置。Discord 原生名称：Discord`/talkvoice`
`/card ...`	发送 LINE 富卡片预设。请参阅LINE
`/codex status\|models\|threads\|resume\|compact\|review\|diagnostics\|account\|mcp\|skills`	控制 Codex 应用服务器线束。请参阅Codex 线束

仅限 QQBot：/bot-ping、/bot-version、/bot-help、/bot-upgrade、/bot-logs

Skills 命令

用户可调用的技能以斜杠命令的形式公开：

/skill <name> [input] 始终作为通用入口点工作。
技能可以注册为直接命令（例如，针对 OpenProse 的 /proseOpenProse）。
原生技能命令注册由 commands.nativeSkills 和 channels.<provider>.commands.nativeSkills 控制。
名称被清理为 a-z0-9_（最多 32 个字符）；冲突将获得数字后缀。

Skill command dispatch

默认情况下，Skills 命令会作为普通请求路由到模型。

Skills 可以声明 command-dispatch: tool 以直接路由到工具（确定性的，不涉及模型）。示例：/prose (OpenProse 插件) — 参见 OpenProse。

Native command arguments

当缺少必需的参数时，Discord 会使用自动补全功能来显示动态选项和按钮菜单。Telegram 和 Slack 会为带有选择的命令显示按钮菜单。动态选择是针对目标会话模型解析的，因此特定于模型的选项（如 /think 级别）会遵循会话的 /model 覆盖设置。

`/tools` — 代理当前可用的内容

/tools 回答了一个运行时问题：此代理在此对话中此时此刻可以使用什么 — 而不是静态的配置目录。

/tools         # compact view
/tools verbose # with short descriptions

结果的作用域限定于会话。更改代理、渠道、线程、发送者授权或模型可能会改变输出。如需编辑配置文件和覆盖设置，请使用控制 UI 工具面板或配置界面。

`/model` — 模型选择

/model             # show model picker
/model list        # same
/model 3           # select by number from picker
/model openai/gpt-5.4
/model opus@anthropic:default
/model status      # detailed view with endpoint and API mode

在 Discord 上，/model 和 /models 会打开一个交互式选择器，其中包含提供商和模型下拉菜单。该选择器遵循 agents.defaults.models，包括 provider/* 条目。

`/config` — 磁盘配置写入

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

配置在写入前会经过验证。无效的更改将被拒绝。/config 更新在重启后依然保留。

`/mcp` — MCP 服务器配置

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

/mcp 将配置存储在 OpenClaw 配置中，而不是 embedded-agent 项目设置中。

`/debug` — 仅运行时覆盖

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

`/plugins` — 插件管理

/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
/plugins install ./path/to/plugin

/plugins enable|disable 更新插件配置并为新的智能体回合热重载 Gateway(网关) 插件运行时。/plugins install 会自动重启受管理的 Gateway，因为插件源模块发生了更改。

`/trace` — 插件跟踪输出

/trace          # show current trace state
/trace on
/trace off

/trace 在不启用完整详细模式的情况下，显示会话范围的插件跟踪/调试行。它不替代 /debug（运行时覆盖）或 /verbose（正常工具输出）。

`/btw` — 旁置问题

/btw 是关于当前会话上下文的快速旁置问题。别名：/side。

/btw what are we doing right now?
/side what changed while the main run continued?

与普通消息不同：

使用当前会话作为背景上下文。
在 Codex harness 会话中，作为临时 Codex 侧边线程运行。
不会更改未来的会话上下文。
不会写入到对话记录历史中。

有关完整行为，请参阅 BTW side questions。

Surface notes

Session scoping per surface

Text commands: 在正常聊天会话中运行（私信共享 mainDiscord，群组拥有各自的会话）。
Native Discord commands: `agent:

:discord:slash:

Slack - **Native Slack commands:** agent:

:slack:slash:

（前缀可通过 channels.slack.slashCommand.sessionPrefixTelegram 配置） - **Native Telegram commands:** telegram:slash:

（通过 CommandTargetSessionKey 定位聊天会话） - **/stop`** 定位活动聊天会话以中止当前运行。

SlackSlack specifics

channels.slack.slashCommand 支持单个 /openclaw 风格的命令。使用 commands.native: trueSlack，为每个内置命令创建一个 Slack 斜杠命令。注册 /agentstatus（而非 /statusSlack），因为 Slack 保留了 /status。文本 /statusSlack 在 Slack 消息中仍然有效。

Fast path and inline shortcuts

来自白名单发送者的纯命令消息会被立即处理（绕过队列 + 模型）。
内联快捷方式（/help、/commands、/status、/whoami）也可以嵌入在普通消息中工作，并在模型看到剩余文本之前被剥离。
未授权的纯命令消息将被静默忽略；内联 /... 标记将被视为纯文本。

参数说明

命令接受命令和参数之间的可选 :（/think: high，/send: on）。
`/new

接受模型别名、provider/model或提供商名称（模糊匹配）；如果无匹配，文本将被视为消息正文。 -/allowlist add|remove需要commands.config: true并遵守渠道configWrites`。

提供商使用情况和状态

提供商使用/配额（例如，“Claude 剩余 80%”）在启用使用跟踪时会显示在 /status 中，针对当前模型提供商。
当实时会话快照稀疏时，/status 中的 Token/缓存行 可以回退到最新的转录本使用条目。
执行与运行时： /status 报告有效沙箱路径的 Execution 以及谁正在运行会话的 Runtime：OpenClaw Default、OpenAI CodexCLI、CLI 后端或 ACP 后端。
每次响应的 Token/成本： 由 /usage off|tokens|full 控制。
/model status 关乎模型/身份验证/端点，而非使用情况。