# 斜杠命令

> 所有可用的斜杠命令、指令和内联快捷方式——包括配置、路由和各界面行为。

- 网址：https://funcoding.ai/agents/openclaw/tools/slash-commands/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/slash-commands

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

当对话绑定到 ACP 会话时，普通文本会路由到 ACP
harness。Gateway 网关管理命令仍在本地处理：`/acp ...` 始终由
OpenClaw 命令处理程序接收；只要该界面启用了命令处理，
`/status` 和 `/unfocus` 也会留在本地处理。

## 三种命令类型

**命令**

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

**指令**

`/think`、`/fast`、`/verbose`、`/trace`、`/reasoning`、`/elevated`、
`/exec`、`/model`、`/queue` — 在模型看到消息前从中移除。单独发送时
会持久化会话设置；与其他文本一起发送时
作为内联提示生效。

**内联快捷方式**

`/help`、`/commands`、`/status`、`/whoami` — 立即运行，并在模型看到
剩余文本前被移除。仅限已授权的发送者。

<details>
<summary>指令行为详情</summary>

- 指令会在模型看到消息前从中移除。
- 在**仅含指令**的消息中（消息内容只有指令），它们会
  持久化到会话并回复确认信息。
- 在包含其他文本的**普通聊天**消息中，它们作为内联提示生效，
  且**不会**持久化会话设置。
- 指令仅对**已授权的发送者**生效。如果设置了 `commands.allowFrom`，
  它将是唯一使用的允许列表；否则，授权来自
  渠道允许列表、配对以及始终启用的访问组强制规则。对于未授权的
  发送者，指令会被视为纯文本。

</details>

## 配置

```json5
{
  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.<provider>.commands.native` 按渠道覆盖。在 Discord 上，`false` 会跳过斜杠命令
注册；之前注册的命令在移除前可能仍然可见。

在支持时将技能命令注册为原生命令。自动模式：为
Discord/Telegram 启用；为 Slack 禁用。可通过
`channels.<provider>.commands.nativeSkills` 覆盖。

启用 `! <cmd>` 以运行主机 shell 命令（`/bash <cmd>` 是其别名）。需要
`tools.elevated` 允许列表。

bash 在切换到后台模式前等待的时长（`0` 会立即转入后台）。

启用 `/config`（读取/写入 `openclaw.json`）。仅限所有者。

启用 `/mcp`（读取/写入 `mcp.servers` 下由 OpenClaw 管理的 MCP 配置）。仅限所有者。

启用 `/plugins`（插件发现/状态，以及安装 + 启用/禁用）。写入操作仅限所有者。

启用 `/debug`（仅运行时配置覆盖）。仅限所有者。

启用 `/restart` 和外部 `SIGUSR1` 重启请求。

所有者专用命令界面的显式所有者允许列表。它与
`commands.allowFrom` 和私信配对访问权限相互独立。

按渠道设置：要求所有者专用命令使用所有者身份。当 `true` 时，
发送者必须匹配 `commands.ownerAllowFrom`，或拥有内部 `operator.admin`
权限范围。通配符 `allowFrom` 条目**并不足够**。

控制所有者 ID 在系统提示词中的显示方式。

当 `commands.ownerDisplay: "hash"` 时使用的 HMAC 密钥。

用于命令授权的按提供商允许列表。配置后，它将成为命令和指令的
**唯一**授权来源。使用 `"*"` 设置
全局默认值；提供商专用键会覆盖该值。

## 命令列表

命令来自三个来源：

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

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

### 核心命令

<details>
<summary>会话和运行</summary>

| 命令 | 说明 |
| --- | --- |
| `/new [model]` | 归档当前会话并启动一个新会话 |
| `/reset [soft [message]]` | 原地重置当前会话。`soft` 会保留对话记录、丢弃重复使用的 CLI 后端会话 ID，并重新运行启动流程 |
| `/name <title>` | 命名或重命名当前会话。省略标题可查看当前名称和一个建议名称 |
| `/compact [instructions]` | 压缩会话上下文。请参阅[压缩](https://funcoding.ai/agents/openclaw/concepts/compaction/) |
| `/stop` | 中止当前运行 |
| `/session idle <duration\|off>` | 管理线程绑定的空闲到期时间 |
| `/session max-age <duration\|off>` | 管理线程绑定的最长存续期 |
| `/export-session [path]` | 仅限所有者。将当前会话导出为工作区内的 HTML。别名：`/export` |
| `/export-trajectory [path]` | 导出当前会话的 JSONL 轨迹包。别名：`/trajectory` |

显式指定的 `/export-session` 路径会替换工作区内的现有文件。
省略路径则会生成不会发生名称冲突的文件名。

<div class="callout callout-note">

Control UI 会拦截键入的 `/new`，以创建并切换到新的
控制面板会话；但当配置了 `session.dmScope: "main"`，
且当前父会话是该智能体的主会话时除外 — 此时 `/new`
会原地重置主会话。键入的 `/reset` 仍会执行 Gateway 网关的
原地重置。如果要清除固定的
会话模型选择，请使用 `/model default`。

</div>

</details>

<details>
<summary>模型和运行控制</summary>

| 命令 | 说明 |
| --- | --- |
| `/think <level\|default>` | 设置思考级别或清除会话覆盖。别名：`/thinking`、`/t` |
| `/verbose on\|off\|full` | 切换详细输出。别名：`/v` |
| `/trace on\|off` | 切换当前会话的插件跟踪输出 |
| `/fast [status\|auto\|on\|off\|default]` | 显示、设置或清除快速模式 |
| `/reasoning [on\|off\|stream]` | 切换推理可见性。别名：`/reason` |
| `/elevated [on\|off\|ask\|full]` | 切换提升权限模式。别名：`/elev` |
| `/exec host=<auto\|sandbox\|gateway\|node> security=<deny\|allowlist\|full> ask=<off\|on-miss\|always> node=<id>` | 显示或设置 Exec 默认值 |
| `/login [codex\|openai\|openai-codex]` | 从私聊或 Web UI 会话配对 Codex/OpenAI 登录。仅限所有者/管理员 |
| `/model [name\|#\|status]` | 显示或设置模型 |
| `/models [provider] [page] [limit=<n>\|all]` | 列出已配置或身份验证可用的提供商或模型 |
| `/queue <mode>` | 管理活动运行的队列行为。请参阅[队列](https://funcoding.ai/agents/openclaw/concepts/queue/)和[队列引导](https://funcoding.ai/agents/openclaw/concepts/queue-steering/) |
| `/steer <message>` | 向活动运行注入指导。别名：`/tell`。请参阅 [Steer](https://funcoding.ai/agents/openclaw/tools/steer/) |

<details>
<summary>详细输出 / 跟踪 / 快速模式 / 推理安全</summary>

- `/verbose` 用于调试 — 正常使用时请保持**关闭**。
- `/trace` 仅显示插件自身的跟踪/调试行；普通的详细输出仍保持关闭。
- `/fast auto|on|off` 会持久化会话覆盖；使用会话 UI 中的 `inherit` 选项可将其清除。
- `/fast` 因提供商而异：OpenAI/Codex 将其映射到 `service_tier=priority`；直接 Anthropic 请求将其映射到 `service_tier=auto` 或 `standard_only`。
- `/reasoning`、`/verbose` 和 `/trace` 在群组环境中存在风险 — 它们可能会泄露内部推理或插件诊断信息。请在群聊中保持关闭。

</details>

<details>
<summary>模型切换详情</summary>

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

</details>

</details>

<details>
<summary>发现和状态</summary>

| 命令 | 说明 |
| --- | --- |
| `/help` | 显示简短的帮助摘要 |
| `/commands` | 显示生成的命令目录 |
| `/tools [compact\|verbose]` | 显示当前智能体现在可以使用的内容 |
| `/status` | 显示执行/运行时状态、Gateway 网关和系统运行时间、插件健康状况，以及提供商用量/配额 |
| `/status plugins` | 显示详细的插件健康状况：加载错误、隔离状态、渠道插件故障、依赖问题、兼容性通知。需要 `commands.plugins: true` |
| `/goal [status\|start\|edit\|pause\|resume\|complete\|block\|clear] ...` | 管理当前会话的持久[目标](https://funcoding.ai/agents/openclaw/tools/goal/) |
| `/diagnostics [note]` | 仅限所有者的支持报告流程。每次都会请求 Exec 审批 |
| `/openclaw <request>` | 从所有者私信中运行 OpenClaw 设置和修复助手 |
| `/tasks` | 列出当前会话的活动/近期后台任务 |
| `/context [list\|detail\|map\|json]` | 说明上下文的组装方式 |
| `/whoami` | 显示你的发送者 ID。别名：`/id` |
| `/usage off\|tokens\|full\|reset\|cost` | 控制每条回复的用量页脚（`reset`/`inherit`/`clear`/`default` 会清除会话覆盖，以重新继承已配置的默认值），或输出本地成本摘要 |

</details>

<details>
<summary>Skills、允许列表、审批</summary>

| 命令 | 说明 |
| --- | --- |
| `/skill <name> [input]` | 按名称运行 Skill |
| `/learn [request]` | 根据当前对话或指定来源，通过 [Skill Workshop](https://funcoding.ai/agents/openclaw/tools/skill-workshop/) 起草一项可供审查的 Skill |
| `/allowlist [list\|add\|remove] ...` | 管理允许列表条目。仅限文本 |
| `/approve <id> <decision>` | 处理 Exec 或插件审批提示 |
| `/btw <question>` | 在不更改会话上下文的情况下提出附带问题。别名：`/side`。请参阅 [BTW](https://funcoding.ai/agents/openclaw/tools/btw/) |

</details>

<details>
<summary>子智能体和 ACP</summary>

| 命令 | 说明 |
| --- | --- |
| `/subagents list\|log\|info` | 检查当前会话的子智能体运行 |
| `/acp spawn\|cancel\|steer\|close\|sessions\|status\|set-mode\|set\|cwd\|permissions\|timeout\|model\|reset-options\|doctor\|install\|help` | 管理 ACP 会话和运行时选项。运行时控制需要外部所有者或内部 Gateway 网关管理员身份 |
| `/focus <target>` | 将当前 Discord 话题串或 Telegram 话题绑定到会话目标 |
| `/unfocus` | 移除当前话题串绑定 |
| `/agents` | 列出当前会话中绑定到话题串的智能体 |

</details>

<details>
<summary>仅所有者可写和管理</summary>

| 命令 | 要求 | 说明 |
| --- | --- | --- |
| `/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` | 所有者 | 设置发送策略 |

</details>

<details>
<summary>语音、TTS、渠道控制</summary>

| 命令 | 说明 |
| --- | --- |
| `/tts on\|off\|status\|chat\|latest\|provider\|limit\|summary\|audio\|help` | 控制 TTS。请参阅 [TTS](https://funcoding.ai/agents/openclaw/tools/tts/) |
| `/activation mention\|always` | 设置群组激活模式 |
| `/bash <command>` | 运行主机 shell 命令。别名：`! <command>`。需要 `commands.bash: true` |
| `!poll [sessionId]` | 检查后台 bash 任务 |
| `!stop [sessionId]` | 停止后台 bash 任务 |

</details>

### 停靠命令

停靠命令会将活动会话的回复路由切换到另一个已关联渠道。
有关设置和故障排除，请参阅[渠道停靠](https://docs.openclaw.ai/zh-CN/concepts/channel-docking)。

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

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

停靠命令需要 `session.identityLinks`。来源发送者和目标对等方
必须位于同一身份组中。

### 内置插件命令

| 命令                                                    | 说明                                                                                                                                                                                           |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/dreaming [on\|off\|status\|help]`                     | 切换记忆 Dreaming（所有者或 Gateway 网关管理员）。请参阅 [Dreaming](https://funcoding.ai/agents/openclaw/concepts/dreaming/)                                                                                                       |
| `/pair [qr\|status\|pending\|approve\|cleanup\|notify]` | 管理设备配对。请参阅[配对](https://funcoding.ai/agents/openclaw/channels/pairing/)                                                                                                                                                   |
| `/phone status\|arm ...\|disarm`                        | 临时启用高风险节点命令（摄像头/屏幕/计算机/写入）。请参阅[计算机使用](https://funcoding.ai/agents/openclaw/nodes/computer-use/)                                                                                                     |
| `/voice status\|list\|set <voiceId>`                    | 管理 Talk 语音配置。Discord 原生名称：`/talkvoice`                                                                                                                                       |
| `/card ...`                                             | 发送 LINE 富卡片预设。请参阅 [LINE](https://funcoding.ai/agents/openclaw/channels/line/)                                                                                                                                             |
| `/codex <action> ...`                                   | 绑定、引导和检查 Codex app-server harness（状态、话题串、恢复、模型、快速模式、权限、压缩、审查、MCP、Skills 等）。请参阅 [Codex harness](https://funcoding.ai/agents/openclaw/plugins/codex-harness/) |

仅限 QQ Bot：`/bot-ping`、`/bot-version`、`/bot-help`、`/bot-upgrade`、`/bot-logs`

### Skill 命令

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

- `/skill <name> [input]` 始终可用作通用入口点。
- Skills 可以注册为直接命令（例如 OpenProse 的 `/prose`）。
- 原生 Skill 命令注册由 `commands.nativeSkills` 和
  `channels.<provider>.commands.nativeSkills` 控制。
- 名称会被清理为 `a-z0-9_`（最多 32 个字符）；发生冲突时会添加数字后缀。

<details>
<summary>Skill 命令分派</summary>

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

Skills 可以声明 `command-dispatch: tool`，以直接路由到工具
（确定性执行，不涉及模型）。示例：`/prose`（OpenProse 插件）
— 请参阅 [OpenProse](https://funcoding.ai/agents/openclaw/prose/)。

</details>

<details>
<summary>原生命令参数</summary>

当省略必需参数时，Discord 会对动态选项使用自动补全和按钮菜单。
对于包含可选项的命令，Telegram 和 Slack 会显示按钮菜单。
动态选项会根据目标会话模型解析，因此 `/think` 级别等模型
特定选项会遵循会话的 `/model` 覆盖。

</details>

## `/tools`：智能体当前可使用的内容

`/tools` 回答的是一个运行时问题：**此智能体现在可以在此
对话中使用什么**，而不是静态配置目录。

```text
/tools         # 简洁视图
/tools verbose # 包含简短说明
```

结果以会话为作用域。更改智能体、渠道、话题串、发送者
授权或模型都可能改变输出。若要编辑配置文件和覆盖，
请使用 Control UI 的 Tools 面板或配置界面。

## `/model`：模型选择

```text
/model             # 显示模型选择器
/model list        # 同上
/model 3           # 按选择器中的编号选择
/model openai/gpt-5.4
/model opus@anthropic:default
/model default     # 清除会话模型选择
/model status      # 包含端点和 API 模式的详细视图
```

在 Discord 上，`/model` 和 `/models` 会打开一个包含提供商和
模型下拉列表的交互式选择器。该选择器遵循 `agents.defaults.modelPolicy.allow`，
包括 `provider/*` 条目。如果没有显式允许列表，模型条目和
别名不会限制选择。

## `/config`：磁盘配置写入

<div class="callout callout-note">

仅限所有者。默认禁用——使用 `commands.config: true` 启用。

</div>

```text
/config show
/config show channels.whatsapp.responsePrefix
/config get channels.whatsapp.responsePrefix
/config set channels.whatsapp.responsePrefix="[openclaw]"
/config unset channels.whatsapp.responsePrefix
```

写入前会验证配置。无效更改会被拒绝。`/config`
更新会在重启后保留。

## `/mcp`：MCP 服务器配置

<div class="callout callout-note">

仅限所有者。默认禁用——使用 `commands.mcp: true` 启用。

</div>

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

`/mcp` 将配置存储在 OpenClaw 配置中，而不是嵌入式智能体项目设置中。
`/mcp show` 会遮盖包含凭据的字段、可识别的凭据标志
值以及已知呈密钥形式的参数。从群组中运行时，
配置会私下发送给所有者；如果没有可用的所有者私聊路由，
命令将以关闭方式失败，并要求所有者在私聊中重试。

## `/debug`：仅运行时覆盖

<div class="callout callout-note">

仅限所有者。默认禁用——使用 `commands.debug: true` 启用。
覆盖会立即应用于新的配置读取，但**不会**写入磁盘。

</div>

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

## `/plugins`：插件管理

<div class="callout callout-note">

写入仅限所有者。默认禁用——使用 `commands.plugins: true` 启用。

</div>

```text
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
/plugins install clawhub:<package>
/plugins install npm:@openclaw/<official-package>
/plugins install npm:<package> --force
/plugins install git:<repository>@<ref> --force
```

`/plugins enable|disable` 会更新插件配置，并为新的智能体轮次热重载 Gateway 网关
插件运行时。`/plugins install` 会自动重启托管的
Gateway 网关，因为插件源模块已更改。受信任的 ClawHub
和官方目录安装不需要额外确认。任意 npm、
git、归档、`npm-pack:` 和本地路径来源会显示来源警告，并且
需要在审查来源后追加 `--force`。此标志表示确认
来源并允许替换现有安装；它不会绕过
`security.installPolicy` 或安装程序安全检查。带有
风险警告的 ClawHub 版本仍需要单独的仅限 shell
标志 `--acknowledge-clawhub-risk`。市场、链接和固定版本安装也
仍然仅限 shell。

## `/trace`：插件跟踪输出

```text
/trace          # 显示当前跟踪状态
/trace on
/trace off
```

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

## `/btw`：附带问题

`/btw` 用于快速询问有关当前会话上下文的附带问题。别名：`/side`。

```text
/btw 我们现在正在做什么？
/side 主运行继续期间发生了哪些变化？
```

与普通消息不同：

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

有关完整行为，请参阅 [BTW 附带问题](https://funcoding.ai/agents/openclaw/tools/btw/)。

## 界面说明

<details>
<summary>各界面的会话作用域</summary>

- **文本命令：**在普通聊天会话中运行（私信共享 `main`，群组拥有各自的会话）。
- **Discord 原生命令：**`agent:<agentId>:discord:slash:<userId>`
- **Slack 原生命令：**`agent:<agentId>:slack:slash:<userId>`（前缀可通过 `channels.slack.slashCommand.sessionPrefix` 配置）
- **Telegram 原生命令：**`telegram:slash:<userId>`（通过 `CommandTargetSessionKey` 定位聊天会话）
- **`/login codex`** 仅通过私聊或 Web UI 响应路径发送设备配对码。Telegram 群组/话题调用会要求所有者改为私信 Bot。
- **`/stop`** 定位活动聊天会话，以中止当前运行。

</details>

<details>
<summary>Slack 详细说明</summary>

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

</details>

<details>
<summary>快速路径和内联快捷方式</summary>

- 来自允许列表中发送者的纯命令消息会立即处理（绕过队列和模型）。
- 内联快捷方式（`/help`、`/commands`、`/status`、`/whoami`）也可嵌入普通消息中，并会在模型看到剩余文本前被移除。
- 未经授权的纯命令消息会被静默忽略；内联 `/...` 令牌会被视为纯文本。

</details>

<details>
<summary>参数说明</summary>

- 命令与参数之间可以有一个可选的 `:`（`/think: high`、`/send: on`）。
- `/new <model>` 接受模型别名、`provider/model` 或提供商名称（模糊匹配）；如果没有匹配项，该文本会被视为消息正文。
- `/allowlist add|remove` 要求 `commands.config: true`，并遵循渠道的 `configWrites`。

</details>

## 提供商用量和状态

- 启用用量跟踪后，当前模型提供商的**提供商用量/配额**（例如，“Claude 剩余 80%”）会显示在 `/status` 中。
- 当实时会话快照中的信息较少时，`/status` 中的**令牌/缓存行**可以回退到最新的对话记录用量条目。
- **执行与运行时：**`/status` 通过 `Execution` 报告实际生效的沙箱路径，并通过 `Runtime` 报告会话的运行方：`OpenClaw Default`、`OpenAI Codex`、CLI 后端或 ACP 后端。
- **每次响应的令牌数/成本：**由 `/usage off|tokens|full` 控制。
- `/model status` 涉及模型、身份验证和端点，而非用量。

## 相关内容

- [Skills](https://funcoding.ai/agents/openclaw/tools/skills/)：技能斜杠命令的注册和访问控制方式。
- [创建技能](https://funcoding.ai/agents/openclaw/tools/creating-skills/)：构建一个注册自身斜杠命令的技能。
- [BTW](https://funcoding.ai/agents/openclaw/tools/btw/)：在不更改会话上下文的情况下提出附带问题。
- [Steer](https://funcoding.ai/agents/openclaw/tools/steer/)：使用 `/steer` 在智能体运行期间对其进行引导。