斜杠命令

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 — 立即运行，并在模型看到剩余文本前被移除。仅限已授权的发送者。

指令行为详情

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

配置

{
  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,
  },
}

boolean

默认值:"true"

启用对聊天消息中 /... 的解析。在没有原生命令的界面（WhatsApp、WebChat、Signal、iMessage、Google Chat、Microsoft Teams）上，即使设置为 false，文本命令也能正常工作。

boolean | "auto"

默认值:"\"auto\""

注册原生命令。自动模式：为 Discord/Telegram 启用；为 Slack 禁用；对不支持原生命令的提供商忽略此项。可通过 channels.<provider>.commands.native 按渠道覆盖。在 Discord 上，false 会跳过斜杠命令注册；之前注册的命令在移除前可能仍然可见。

boolean | "auto"

默认值:"\"auto\""

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

boolean

默认值:"false"

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

number

默认值:"2000"

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

boolean

默认值:"false"

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

boolean

默认值:"false"

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

boolean

默认值:"false"

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

boolean

默认值:"false"

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

boolean

默认值:"true"

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

string[]

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

boolean

默认值:"false"

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

"raw" | "hash"

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

string

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

object

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

命令列表

命令来自三个来源：

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

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

核心命令

会话和运行

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

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

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

模型和运行控制

命令	说明
`/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>`	管理活动运行的队列行为。请参阅队列和队列引导
`/steer <message>`	向活动运行注入指导。别名：`/tell`。请参阅 Steer

详细输出 / 跟踪 / 快速模式 / 推理安全

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

模型切换详情

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

发现和状态

命令	说明
`/help`	显示简短的帮助摘要
`/commands`	显示生成的命令目录
`/tools [compact\|verbose]`	显示当前智能体现在可以使用的内容
`/status`	显示执行/运行时状态、Gateway 网关和系统运行时间、插件健康状况，以及提供商用量/配额
`/status plugins`	显示详细的插件健康状况：加载错误、隔离状态、渠道插件故障、依赖问题、兼容性通知。需要 `commands.plugins: true`
`/goal [status\|start\|edit\|pause\|resume\|complete\|block\|clear] ...`	管理当前会话的持久目标
`/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` 会清除会话覆盖，以重新继承已配置的默认值），或输出本地成本摘要

Skills、允许列表、审批

命令	说明
`/skill <name> [input]`	按名称运行 Skill
`/learn [request]`	根据当前对话或指定来源，通过 Skill Workshop 起草一项可供审查的 Skill
`/allowlist [list\|add\|remove] ...`	管理允许列表条目。仅限文本
`/approve <id> <decision>`	处理 Exec 或插件审批提示
`/btw <question>`	在不更改会话上下文的情况下提出附带问题。别名：`/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 会话和运行时选项。运行时控制需要外部所有者或内部 Gateway 网关管理员身份
`/focus <target>`	将当前 Discord 话题串或 Telegram 话题绑定到会话目标
`/unfocus`	移除当前话题串绑定
`/agents`	列出当前会话中绑定到话题串的智能体

仅所有者可写和管理

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

语音、TTS、渠道控制

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

停靠命令

停靠命令会将活动会话的回复路由切换到另一个已关联渠道。有关设置和故障排除，请参阅渠道停靠。由支持原生命令的渠道插件生成：

/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
`/pair [qr\|status\|pending\|approve\|cleanup\|notify]`	管理设备配对。请参阅配对
`/phone status\|arm ...\|disarm`	临时启用高风险节点命令（摄像头/屏幕/计算机/写入）。请参阅计算机使用
`/voice status\|list\|set <voiceId>`	管理 Talk 语音配置。Discord 原生名称：`/talkvoice`
`/card ...`	发送 LINE 富卡片预设。请参阅 LINE
`/codex <action> ...`	绑定、引导和检查 Codex app-server harness（状态、话题串、恢复、模型、快速模式、权限、压缩、审查、MCP、Skills 等）。请参阅 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 个字符）；发生冲突时会添加数字后缀。

Skill 命令分派

默认情况下，Skill 命令会作为普通请求路由到模型。Skills 可以声明 command-dispatch: tool，以直接路由到工具（确定性执行，不涉及模型）。示例：/prose（OpenProse 插件） — 请参阅 OpenProse。

原生命令参数

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

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

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

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

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

`/model`：模型选择

/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`：磁盘配置写入

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

/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 服务器配置

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

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

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

`/debug`：仅运行时覆盖

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

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

`/plugins`：插件管理

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

/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`：插件跟踪输出

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

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

`/btw`：附带问题

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

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

与普通消息不同：

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

有关完整行为，请参阅 BTW 附带问题。

界面说明

各界面的会话作用域

**文本命令：**在普通聊天会话中运行（私信共享 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 定位活动聊天会话，以中止当前运行。

Slack 详细说明

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

快速路径和内联快捷方式

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

参数说明

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

提供商用量和状态

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

Skills

技能斜杠命令的注册和访问控制方式。

创建技能

构建一个注册自身斜杠命令的技能。

BTW

在不更改会话上下文的情况下提出附带问题。

Steer

使用 /steer 在智能体运行期间对其进行引导。

概览

Plugins

扩展

Building plugins

技能

自动化与任务

内置工具

代理协作

三种命令类型

命令

指令

内联快捷方式

配置

命令列表

核心命令

停靠命令

内置插件命令

Skill 命令

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

`/model`：模型选择

`/config`：磁盘配置写入

`/mcp`：MCP 服务器配置

`/debug`：仅运行时覆盖

`/plugins`：插件管理

`/trace`：插件跟踪输出

`/btw`：附带问题

界面说明

提供商用量和状态

相关内容

Skills

创建技能

BTW

Steer

​三种命令类型

命令

指令

内联快捷方式

​配置

​命令列表

​核心命令

​停靠命令

​内置插件命令

​Skill 命令

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

​/model：模型选择

​/config：磁盘配置写入

​/mcp：MCP 服务器配置

​/debug：仅运行时覆盖

​/plugins：插件管理

​/trace：插件跟踪输出

​/btw：附带问题

​界面说明

​提供商用量和状态

​相关内容

Skills

创建技能

BTW

Steer

三种命令类型

配置

命令列表

核心命令

停靠命令

内置插件命令

Skill 命令

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

`/model`：模型选择

`/config`：磁盘配置写入

`/mcp`：MCP 服务器配置

`/debug`：仅运行时覆盖

`/plugins`：插件管理

`/trace`：插件跟踪输出

`/btw`：附带问题

界面说明

提供商用量和状态

相关内容