diff --git a/docs/zh-CN/tools/slash-commands.md b/docs/zh-CN/tools/slash-commands.md index 5d59e4608..62e41633d 100644 --- a/docs/zh-CN/tools/slash-commands.md +++ b/docs/zh-CN/tools/slash-commands.md @@ -2,13 +2,13 @@ read_when: - 使用或配置聊天命令 - 调试命令路由或权限 -summary: 斜杠命令：文本与原生、配置以及支持的命令 +summary: 斜杠命令：文本与原生、配置，以及受支持的命令 title: 斜杠命令 x-i18n: - generated_at: "2026-04-21T08:24:16Z" + generated_at: "2026-04-21T15:19:44Z" model: gpt-5.4 provider: openai - source_hash: d90ddee54af7c05b7fdf486590561084581d750e42cd14674d43bbdc0984df5d + source_hash: 26923608329ba2aeece2d4bc8edfa40ae86e03719a9f590f26ff79f57d97521d source_path: tools/slash-commands.md workflow: 15 --- @@ -22,13 +22,13 @@ x-i18n: - **命令**：独立的 `/...` 消息。 - **指令**：`/think`、`/fast`、`/verbose`、`/trace`、`/reasoning`、`/elevated`、`/exec`、`/model`、`/queue`。 - - 在模型看到消息之前，指令会从消息中移除。 - - 在普通聊天消息中（不是仅包含指令的消息），它们会被视为“内联提示”，并且**不会**持久化会话设置。 - - 在仅包含指令的消息中（消息只包含指令），它们会持久化到会话中，并回复一条确认信息。 - - 指令只会对**已授权发送者**生效。如果设置了 `commands.allowFrom`，它就是唯一使用的允许列表；否则授权来自渠道允许列表/配对以及 `commands.useAccessGroups`。 - 未授权发送者看到的指令会被当作普通文本处理。 + - 指令会在模型看到消息之前被移除。 + - 在普通聊天消息中（不是仅包含指令的消息），它们会被当作“内联提示”，并且**不会**持久化会话设置。 + - 在仅包含指令的消息中（消息只包含指令），它们会持久化到会话，并回复一条确认消息。 + - 指令只会对**已授权的发送者**生效。如果设置了 `commands.allowFrom`，它就是唯一使用的允许列表；否则授权来自渠道允许列表/配对以及 `commands.useAccessGroups`。 + 未授权的发送者会看到这些指令被当作普通文本处理。 -还有一些**内联快捷方式**（仅限已列入允许列表/已授权的发送者）：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。 +还有少数几个**内联快捷方式**（仅允许列表中的/已授权的发送者可用）：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。 它们会立即运行，在模型看到消息前被移除，剩余文本继续按正常流程处理。 ## 配置 @@ -59,85 +59,86 @@ x-i18n: ``` - `commands.text`（默认 `true`）启用在聊天消息中解析 `/...`。 - - 在不支持原生命令的界面上（WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams），即使你将其设为 `false`，文本命令仍然可用。 + - 在没有原生命令的界面上（WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams），即使你将其设置为 `false`，文本命令仍然可用。 - `commands.native`（默认 `"auto"`）注册原生命令。 - - Auto：在 Discord/Telegram 上开启；在 Slack 上关闭（直到你添加斜杠命令）；对不支持原生命令的提供商会忽略。 + - 自动：对 Discord/Telegram 开启；对 Slack 关闭（直到你添加斜杠命令）；对不支持原生命令的提供商会被忽略。 - 设置 `channels.discord.commands.native`、`channels.telegram.commands.native` 或 `channels.slack.commands.native` 可按提供商覆盖（布尔值或 `"auto"`）。 - - `false` 会在启动时清除之前在 Discord/Telegram 上注册的命令。Slack 命令在 Slack 应用中管理，不会自动移除。 -- `commands.nativeSkills`（默认 `"auto"`）在支持时以原生方式注册 **skill** 命令。 - - Auto：在 Discord/Telegram 上开启；在 Slack 上关闭（Slack 要求为每个 skill 单独创建一个斜杠命令）。 + - `false` 会在启动时清除之前已在 Discord/Telegram 上注册的命令。Slack 命令由 Slack 应用管理，不会自动移除。 +- `commands.nativeSkills`（默认 `"auto"`）在支持时原生注册 **skill** 命令。 + - 自动：对 Discord/Telegram 开启；对 Slack 关闭（Slack 需要为每个 skill 单独创建一个斜杠命令）。 - 设置 `channels.discord.commands.nativeSkills`、`channels.telegram.commands.nativeSkills` 或 `channels.slack.commands.nativeSkills` 可按提供商覆盖（布尔值或 `"auto"`）。 -- `commands.bash`（默认 `false`）启用 `! ` 来运行主机 shell 命令（`/bash ` 是别名；需要 `tools.elevated` 允许列表）。 -- `commands.bashForegroundMs`（默认 `2000`）控制 bash 在切换到后台模式前等待多久（`0` 表示立即转入后台）。 +- `commands.bash`（默认 `false`）启用 `! ` 运行主机 shell 命令（`/bash ` 是别名；需要 `tools.elevated` 允许列表）。 +- `commands.bashForegroundMs`（默认 `2000`）控制 bash 在切换到后台模式之前等待多长时间（`0` 表示立即转入后台）。 - `commands.config`（默认 `false`）启用 `/config`（读取/写入 `openclaw.json`）。 - `commands.mcp`（默认 `false`）启用 `/mcp`（读取/写入 `mcp.servers` 下由 OpenClaw 管理的 MCP 配置）。 - `commands.plugins`（默认 `false`）启用 `/plugins`（插件发现/状态，以及安装 + 启用/禁用控制）。 - `commands.debug`（默认 `false`）启用 `/debug`（仅运行时覆盖）。 - `commands.restart`（默认 `true`）启用 `/restart` 以及 Gateway 网关重启工具操作。 -- `commands.ownerAllowFrom`（可选）为仅所有者可用的命令/工具界面设置显式所有者允许列表。这与 `commands.allowFrom` 分开。 +- `commands.ownerAllowFrom`（可选）为仅限所有者的命令/工具界面设置显式所有者允许列表。这与 `commands.allowFrom` 是分开的。 - `commands.ownerDisplay` 控制所有者 id 在系统提示中的显示方式：`raw` 或 `hash`。 - `commands.ownerDisplaySecret` 可选设置当 `commands.ownerDisplay="hash"` 时使用的 HMAC 密钥。 -- `commands.allowFrom`（可选）为命令授权设置按提供商区分的允许列表。配置后，它会成为命令和指令的唯一授权来源（渠道允许列表/配对和 `commands.useAccessGroups` 会被忽略）。使用 `"*"` 作为全局默认值；提供商专属键会覆盖它。 +- `commands.allowFrom`（可选）为命令授权设置按提供商划分的允许列表。配置后，它将成为命令和指令的唯一授权来源（渠道允许列表/配对以及 `commands.useAccessGroups` 会被忽略）。使用 `"*"` 作为全局默认值；提供商专用键会覆盖它。 - `commands.useAccessGroups`（默认 `true`）在未设置 `commands.allowFrom` 时，对命令强制执行允许列表/策略。 ## 命令列表 -当前事实来源： +当前唯一可信来源： - 核心内置命令来自 `src/auto-reply/commands-registry.shared.ts` - 生成的 dock 命令来自 `src/auto-reply/commands-registry.data.ts` - 插件命令来自插件的 `registerCommand()` 调用 -- 你的 Gateway 网关上实际可用的命令仍取决于配置标志、渠道界面以及已安装/已启用的插件 +- 你的 Gateway 网关上实际可用的命令仍取决于配置标志、渠道界面，以及已安装/启用的插件 ### 核心内置命令 当前可用的内置命令： -- `/new [model]` 启动一个新会话；`/reset` 是重置别名。 +- `/new [model]` 开始一个新会话；`/reset` 是重置别名。 +- `/reset soft [message]` 保留当前转录记录，丢弃复用的 CLI 后端会话 id，并原地重新运行启动/系统提示加载。 - `/compact [instructions]` 压缩会话上下文。参见 [/concepts/compaction](/zh-CN/concepts/compaction)。 - `/stop` 中止当前运行。 - `/session idle ` 和 `/session max-age ` 管理线程绑定过期时间。 -- `/think ` 设置思考级别。可选项来自当前模型的提供商配置文件；常见级别有 `off`、`minimal`、`low`、`medium` 和 `high`，也支持某些自定义级别，如 `xhigh`、`adaptive`、`max`，或仅在支持时可用的二元 `on`。别名：`/thinking`、`/t`。 +- `/think ` 设置思考级别。可选项来自活动模型的提供商配置文件；常见级别有 `off`、`minimal`、`low`、`medium` 和 `high`，也可能包括仅在某些情况下支持的自定义级别，如 `xhigh`、`adaptive`、`max`，或仅二元的 `on`。别名：`/thinking`、`/t`。 - `/verbose on|off|full` 切换详细输出。别名：`/v`。 -- `/trace on|off` 为当前会话切换插件跟踪输出。 +- `/trace on|off` 为当前会话切换插件追踪输出。 - `/fast [status|on|off]` 显示或设置快速模式。 - `/reasoning [on|off|stream]` 切换推理可见性。别名：`/reason`。 - `/elevated [on|off|ask|full]` 切换提升模式。别名：`/elev`。 - `/exec host= security= ask= node=` 显示或设置 exec 默认值。 - `/model [name|#|status]` 显示或设置模型。 -- `/models [provider] [page] [limit=|size=|all]` 列出提供商或某个提供商的模型。 -- `/queue ` 管理队列行为（`steer`、`interrupt`、`followup`、`collect`、`steer-backlog`），以及如 `debounce:2s cap:25 drop:summarize` 之类的选项。 +- `/models [provider] [page] [limit=|size=|all]` 列出提供商，或列出某个提供商的模型。 +- `/queue ` 管理队列行为（`steer`、`interrupt`、`followup`、`collect`、`steer-backlog`），以及如 `debounce:2s cap:25 drop:summarize` 这样的选项。 - `/help` 显示简短帮助摘要。 - `/commands` 显示生成的命令目录。 -- `/tools [compact|verbose]` 显示当前智能体此刻可以使用什么。 +- `/tools [compact|verbose]` 显示当前智能体现在可以使用什么。 - `/status` 显示运行时状态，包括可用时的提供商使用量/配额。 -- `/tasks` 列出当前会话的活动/最近后台任务。 -- `/context [list|detail|json]` 说明上下文是如何组装的。 +- `/tasks` 列出当前会话的活动/近期后台任务。 +- `/context [list|detail|json]` 解释上下文是如何组装的。 - `/export-session [path]` 将当前会话导出为 HTML。别名：`/export`。 - `/whoami` 显示你的发送者 id。别名：`/id`。 - `/skill [input]` 按名称运行一个 skill。 - `/allowlist [list|add|remove] ...` 管理允许列表条目。仅文本。 - `/approve ` 处理 exec 审批提示。 -- `/btw ` 在不改变未来会话上下文的情况下提出旁支问题。参见 [/tools/btw](/zh-CN/tools/btw)。 +- `/btw ` 提出一个侧边问题，而不改变未来的会话上下文。参见 [/tools/btw](/zh-CN/tools/btw)。 - `/subagents list|kill|log|info|send|steer|spawn` 管理当前会话的子智能体运行。 - `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` 管理 ACP 会话和运行时选项。 -- `/focus ` 将当前 Discord 线程或 Telegram 话题/会话绑定到一个会话目标。 +- `/focus ` 将当前 Discord 线程或 Telegram 主题/会话绑定到某个会话目标。 - `/unfocus` 移除当前绑定。 - `/agents` 列出当前会话中线程绑定的智能体。 -- `/kill ` 中止一个或全部正在运行的子智能体。 -- `/steer ` 向正在运行的子智能体发送引导信息。别名：`/tell`。 +- `/kill ` 中止一个或所有正在运行的子智能体。 +- `/steer ` 向正在运行的子智能体发送引导。别名：`/tell`。 - `/config show|get|set|unset` 读取或写入 `openclaw.json`。仅所有者。需要 `commands.config: true`。 - `/mcp show|get|set|unset` 读取或写入 `mcp.servers` 下由 OpenClaw 管理的 MCP 服务器配置。仅所有者。需要 `commands.mcp: true`。 - `/plugins list|inspect|show|get|install|enable|disable` 检查或修改插件状态。`/plugin` 是别名。写操作仅所有者可用。需要 `commands.plugins: true`。 -- `/debug show|set|unset|reset` 管理仅运行时配置覆盖。仅所有者。需要 `commands.debug: true`。 -- `/usage off|tokens|full|cost` 控制每次响应的使用量页脚，或打印本地成本摘要。 +- `/debug show|set|unset|reset` 管理仅运行时的配置覆盖。仅所有者。需要 `commands.debug: true`。 +- `/usage off|tokens|full|cost` 控制每次响应的用量页脚，或打印本地成本摘要。 - `/tts on|off|status|provider|limit|summary|audio|help` 控制 TTS。参见 [/tools/tts](/zh-CN/tools/tts)。 - `/restart` 在启用时重启 OpenClaw。默认：启用；设置 `commands.restart: false` 可禁用。 - `/activation mention|always` 设置群组激活模式。 - `/send on|off|inherit` 设置发送策略。仅所有者。 -- `/bash ` 运行主机 shell 命令。仅文本。别名：`! `。需要 `commands.bash: true` 以及 `tools.elevated` 允许列表。 -- `!poll [sessionId]` 检查后台 bash 作业。 -- `!stop [sessionId]` 停止后台 bash 作业。 +- `/bash ` 运行主机 shell 命令。仅文本。别名：`! `。需要 `commands.bash: true`，并且在 `tools.elevated` 允许列表中。 +- `!poll [sessionId]` 检查一个后台 bash 作业。 +- `!stop [sessionId]` 停止一个后台 bash 作业。 ### 生成的 dock 命令 @@ -150,14 +151,14 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： ### 内置插件命令 -内置插件可以添加更多斜杠命令。此仓库中当前的内置命令： +内置插件可以添加更多斜杠命令。此仓库中当前的内置命令有： - `/dreaming [on|off|status|help]` 切换记忆 Dreaming。参见 [Dreaming](/zh-CN/concepts/dreaming)。 - `/pair [qr|status|pending|approve|cleanup|notify]` 管理设备配对/设置流程。参见 [Pairing](/zh-CN/channels/pairing)。 - `/phone status|arm [duration]|disarm` 临时启用高风险手机节点命令。 - `/voice status|list [limit]|set ` 管理 Talk 语音配置。在 Discord 上，原生命令名称是 `/talkvoice`。 - `/card ...` 发送 LINE 富卡片预设。参见 [LINE](/zh-CN/channels/line)。 -- `/codex status|models|threads|resume|compact|review|account|mcp|skills` 检查并控制内置的 Codex app-server harness。参见 [Codex Harness](/zh-CN/plugins/codex-harness)。 +- `/codex status|models|threads|resume|compact|review|account|mcp|skills` 检查并控制内置 Codex 应用服务器 harness。参见 [Codex Harness](/zh-CN/plugins/codex-harness)。 - 仅 QQ Bot 命令： - `/bot-ping` - `/bot-version` @@ -167,71 +168,71 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： ### 动态 skill 命令 -用户可调用的 Skills 也会作为斜杠命令公开： +用户可调用的 Skills 也会以斜杠命令形式暴露： - `/skill [input]` 始终可作为通用入口点使用。 -- 当 skill/插件注册了它们时，Skills 也可能显示为直接命令，例如 `/prose`。 +- 当 skill/插件注册它们时，skills 也可能显示为像 `/prose` 这样的直接命令。 - 原生 skill 命令注册由 `commands.nativeSkills` 和 `channels..commands.nativeSkills` 控制。 -注意： +说明： -- 命令支持在命令与参数之间可选添加 `:`（例如 `/think: high`、`/send: on`、`/help:`）。 -- `/new ` 接受模型别名、`provider/model`，或提供商名称（模糊匹配）；如果没有匹配项，则该文本会被视为消息正文。 -- 如需完整的提供商用量明细，请使用 `openclaw status --usage`。 +- 命令接受命令与参数之间可选的 `:`（例如 `/think: high`、`/send: on`、`/help:`）。 +- `/new ` 接受模型别名、`provider/model` 或提供商名称（模糊匹配）；如果没有匹配，文本会被当作消息正文。 +- 如需完整的提供商用量明细，使用 `openclaw status --usage`。 - `/allowlist add|remove` 需要 `commands.config=true`，并遵循渠道的 `configWrites`。 - 在多账号渠道中，面向配置目标的 `/allowlist --account ` 和 `/config set channels..accounts....` 也会遵循目标账号的 `configWrites`。 -- `/usage` 控制每次响应的使用量页脚；`/usage cost` 会从 OpenClaw 会话日志打印本地成本摘要。 +- `/usage` 控制每次响应的用量页脚；`/usage cost` 会根据 OpenClaw 会话日志输出本地成本摘要。 - `/restart` 默认启用；设置 `commands.restart: false` 可禁用它。 - `/plugins install ` 接受与 `openclaw plugins install` 相同的插件规格：本地路径/归档、npm 包，或 `clawhub:`。 -- `/plugins enable|disable` 会更新插件配置，并可能提示你重启。 -- 仅 Discord 原生命令：`/vc join|leave|status` 控制语音频道（需要 `channels.discord.voice` 和原生命令；文本形式不可用）。 -- Discord 线程绑定命令（`/focus`、`/unfocus`、`/agents`、`/session idle`、`/session max-age`）要求有效启用线程绑定（`session.threadBindings.enabled` 和/或 `channels.discord.threadBindings.enabled`）。 +- `/plugins enable|disable` 会更新插件配置，并且可能提示你重启。 +- 仅 Discord 原生命令：`/vc join|leave|status` 用于控制语音频道（需要 `channels.discord.voice` 和原生命令；不支持文本方式）。 +- Discord 线程绑定命令（`/focus`、`/unfocus`、`/agents`、`/session idle`、`/session max-age`）要求已启用有效线程绑定（`session.threadBindings.enabled` 和/或 `channels.discord.threadBindings.enabled`）。 - ACP 命令参考和运行时行为： [ACP Agents](/zh-CN/tools/acp-agents)。 - `/verbose` 用于调试和额外可见性；正常使用时请保持**关闭**。 -- `/trace` 比 `/verbose` 更窄：它只显示插件拥有的 trace/debug 行，并保持普通详细工具输出关闭。 -- `/fast on|off` 会持久化一个会话覆盖。使用会话 UI 中的 `inherit` 选项可清除它并回退到配置默认值。 -- `/fast` 是提供商相关的：OpenAI/OpenAI Codex 在原生 Responses 端点上会将其映射到 `service_tier=priority`，而直接发往 `api.anthropic.com` 的公开 Anthropic 请求（包括使用 OAuth 身份验证的流量）会将其映射到 `service_tier=auto` 或 `standard_only`。参见 [OpenAI](/zh-CN/providers/openai) 和 [Anthropic](/zh-CN/providers/anthropic)。 -- 当相关时，工具失败摘要仍会显示，但详细失败文本只会在 `/verbose` 为 `on` 或 `full` 时包含。 -- `/reasoning`、`/verbose` 和 `/trace` 在群组场景中有风险：它们可能暴露你本无意公开的内部推理、工具输出或插件诊断信息。建议保持关闭，尤其是在群聊中。 +- `/trace` 比 `/verbose` 更窄：它只显示插件拥有的 trace/debug 行，并保持普通的详细工具输出关闭。 +- `/fast on|off` 会持久化一个会话覆盖。使用 Sessions UI 的 `inherit` 选项可清除它，并回退到配置默认值。 +- `/fast` 具有提供商特定行为：OpenAI/OpenAI Codex 会在原生 Responses 端点上将其映射为 `service_tier=priority`，而直接发往 `api.anthropic.com` 的公共 Anthropic 请求（包括经 OAuth 认证的流量）则会映射为 `service_tier=auto` 或 `standard_only`。参见 [OpenAI](/zh-CN/providers/openai) 和 [Anthropic](/zh-CN/providers/anthropic)。 +- 相关情况下仍会显示工具失败摘要，但详细失败文本仅在 `/verbose` 为 `on` 或 `full` 时才会包含。 +- `/reasoning`、`/verbose` 和 `/trace` 在群组环境中存在风险：它们可能暴露你无意公开的内部推理、工具输出或插件诊断信息。建议保持关闭，尤其是在群聊中。 - `/model` 会立即持久化新的会话模型。 - 如果智能体处于空闲状态，下一次运行会立即使用它。 -- 如果某次运行已经处于活动状态，OpenClaw 会将实时切换标记为待处理，并只会在一个干净的重试点重启到新模型。 -- 如果工具活动或回复输出已经开始，待处理切换可能会一直排队到后续某个重试机会，或下一个用户回合。 -- **快速路径：** 来自允许列表发送者的仅命令消息会立即处理（绕过队列 + 模型）。 -- **群组提及门控：** 来自允许列表发送者的仅命令消息会绕过提及要求。 +- 如果某次运行已经处于活动状态，OpenClaw 会将实时切换标记为待处理，并且只会在合适的重试点重启到新模型。 +- 如果工具活动或回复输出已经开始，这个待处理切换可能会一直排队，直到稍后的重试机会或下一次用户轮次。 +- **快速路径：** 来自允许列表发送者的纯命令消息会被立即处理（绕过队列 + 模型）。 +- **群组提及门控：** 来自允许列表发送者的纯命令消息会绕过提及要求。 - **内联快捷方式（仅允许列表发送者）：** 某些命令在嵌入普通消息时也能工作，并会在模型看到剩余文本前被移除。 - - 示例：`hey /status` 会触发一条状态回复，剩余文本继续按正常流程处理。 + - 示例：`hey /status` 会触发一条状态回复，剩余文本继续走正常流程。 - 当前包括：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。 -- 未授权的仅命令消息会被静默忽略，内联 `/...` 标记会被视为普通文本。 -- **skill 命令：** `user-invocable` 的 Skills 也会作为斜杠命令公开。名称会被清理为 `a-z0-9_`（最多 32 个字符）；冲突项会附加数字后缀（例如 `_2`）。 - - `/skill [input]` 按名称运行一个 skill（当原生命令限制阻止按 skill 单独生成命令时，这很有用）。 +- 未授权的纯命令消息会被静默忽略，而内联 `/...` 标记会被当作普通文本处理。 +- **skill 命令：** `user-invocable` 的 Skills 也会作为斜杠命令暴露。名称会被规范化为 `a-z0-9_`（最长 32 个字符）；冲突时会加上数字后缀（例如 `_2`）。 + - `/skill [input]` 按名称运行一个 skill（当原生命令限制导致无法为每个 skill 单独创建命令时，这很有用）。 - 默认情况下，skill 命令会作为普通请求转发给模型。 - - Skills 可选择声明 `command-dispatch: tool`，将命令直接路由到某个工具（确定性、无模型）。 + - Skills 也可以选择声明 `command-dispatch: tool`，将命令直接路由到工具（确定性，无模型）。 - 示例：`/prose`（OpenProse 插件）——参见 [OpenProse](/zh-CN/prose)。 -- **原生命令参数：** Discord 对动态选项使用自动补全（当你省略必需参数时，也会使用按钮菜单）。Telegram 和 Slack 则会在某个命令支持可选项且你省略参数时显示按钮菜单。 +- **原生命令参数：** Discord 对动态选项使用自动补全（当你省略必填参数时也会显示按钮菜单）。Telegram 和 Slack 会在某个命令支持可选项且你省略参数时显示按钮菜单。 ## `/tools` -`/tools` 回答的是一个运行时问题，而不是配置问题：**这个智能体现在在这段对话中可以使用什么**。 +`/tools` 回答的是一个运行时问题，而不是配置问题：**这个智能体现在在这段对话中能使用什么**。 - 默认的 `/tools` 是紧凑模式，针对快速浏览进行了优化。 -- `/tools verbose` 会添加简短描述。 -- 支持参数的原生命令界面会以 `compact|verbose` 提供相同的模式切换。 -- 结果是会话作用域的，因此更改智能体、渠道、线程、发送者授权或模型，都可能改变输出。 -- `/tools` 包含在运行时真正可达的工具，包括核心工具、已连接的插件工具以及渠道自有工具。 +- `/tools verbose` 会添加简短说明。 +- 支持参数的原生命令界面会以 `compact|verbose` 的形式暴露同样的模式切换。 +- 结果是会话作用域的，因此更改智能体、渠道、线程、发送者授权或模型都可能改变输出。 +- `/tools` 包含运行时实际可达的工具，包括核心工具、已连接的插件工具以及渠道自有工具。 -对于配置文件和覆盖编辑，请使用控制 UI 的工具面板或配置/目录界面，而不要将 `/tools` 当作静态目录。 +对于配置文件和覆盖项编辑，请使用 Control UI 的 Tools 面板或配置/目录界面，而不要把 `/tools` 当作静态目录。 -## 使用量界面（哪些内容显示在哪里） +## 用量界面（各处显示的内容） -- **提供商用量/配额**（例如：“Claude 还剩 80%”）会在启用用量跟踪时显示在当前模型提供商的 `/status` 中。OpenClaw 会将提供商窗口统一规范为“剩余百分比”；对于 MiniMax，仅返回剩余百分比字段时会在显示前反转，而 `model_remains` 响应会优先采用聊天模型条目，并附带一个带模型标签的套餐标签。 -- 当实时会话快照较稀疏时，`/status` 中的**token/缓存行**可以回退到最新转录使用量条目。现有的非零实时值仍然优先，转录回退还可以在存储总量缺失或更小时恢复当前活动运行时模型标签以及一个更偏向提示词的更大总量。 -- **每次响应的 token/成本** 由 `/usage off|tokens|full` 控制（附加在正常回复后）。 -- `/model status` 关注的是**模型/凭证/端点**，而不是使用量。 +- **提供商用量/配额**（例如：“Claude 剩余 80%”）会在启用用量跟踪时显示在当前模型提供商的 `/status` 中。OpenClaw 会将提供商窗口统一规范为“剩余百分比”；对于 MiniMax，只有剩余量的百分比字段会在显示前取反，而 `model_remains` 响应会优先使用聊天模型条目以及带模型标记的套餐标签。 +- `/status` 中的 **token/cache 行** 在实时会话快照信息较少时，可以回退到最近的转录记录用量条目。已有的非零实时值仍然优先；当存储总量缺失或较小时，转录记录回退也可以恢复当前运行时模型标签以及一个更大的、面向提示词的总量。 +- **每次响应的 token/成本** 由 `/usage off|tokens|full` 控制（附加到普通回复中）。 +- `/model status` 关注的是**模型/凭证/端点**，而不是用量。 ## 模型选择（`/model`） -`/model` 被实现为一个指令。 +`/model` 是作为指令实现的。 示例： @@ -244,16 +245,16 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /model status ``` -注意： +说明： - `/model` 和 `/model list` 会显示一个紧凑的编号选择器（模型家族 + 可用提供商）。 -- 在 Discord 上，`/model` 和 `/models` 会打开一个交互式选择器，其中包含提供商和模型下拉菜单，以及提交步骤。 -- `/model <#>` 会从该选择器中进行选择（并在可能时优先当前提供商）。 -- `/model status` 会显示详细视图，包括已配置的提供商端点（`baseUrl`）和 API 模式（`api`），如果可用的话。 +- 在 Discord 上，`/model` 和 `/models` 会打开一个交互式选择器，其中包含提供商和模型下拉菜单以及提交步骤。 +- `/model <#>` 会从该选择器中进行选择（并尽可能优先使用当前提供商）。 +- `/model status` 会显示详细视图，包括已配置的提供商端点（`baseUrl`）以及 API 模式（`api`，如果可用）。 ## 调试覆盖 -`/debug` 让你设置**仅运行时**配置覆盖（内存中，不写磁盘）。仅所有者可用。默认禁用；通过 `commands.debug: true` 启用。 +`/debug` 允许你设置**仅运行时**的配置覆盖（内存中，不写磁盘）。仅所有者可用。默认禁用；通过 `commands.debug: true` 启用。 示例： @@ -265,14 +266,14 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /debug reset ``` -注意： +说明： -- 覆盖会立即应用到新的配置读取，但**不会**写入 `openclaw.json`。 -- 使用 `/debug reset` 清除所有覆盖并返回磁盘上的配置。 +- 覆盖会立即应用于新的配置读取，但**不会**写入 `openclaw.json`。 +- 使用 `/debug reset` 清除所有覆盖，并恢复到磁盘上的配置。 -## 插件 trace 输出 +## 插件追踪输出 -`/trace` 让你在不开启完整详细模式的情况下切换**会话作用域的插件 trace/debug 行**。 +`/trace` 允许你切换**会话作用域的插件 trace/debug 行**，而无需开启完整详细模式。 示例： @@ -282,14 +283,14 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /trace off ``` -注意： +说明： - 不带参数的 `/trace` 会显示当前会话的 trace 状态。 -- `/trace on` 会为当前会话启用插件 trace 行。 +- `/trace on` 为当前会话启用插件 trace 行。 - `/trace off` 会再次禁用它们。 -- 插件 trace 行可能出现在 `/status` 中，也可能作为普通助手回复后的后续诊断消息出现。 -- `/trace` 不能替代 `/debug`；`/debug` 仍用于管理仅运行时配置覆盖。 -- `/trace` 不能替代 `/verbose`；普通详细工具/状态输出仍属于 `/verbose`。 +- 插件 trace 行可能显示在 `/status` 中，也可能作为普通助手回复后的后续诊断消息出现。 +- `/trace` 不能替代 `/debug`；`/debug` 仍用于管理仅运行时的配置覆盖。 +- `/trace` 也不能替代 `/verbose`；常规详细工具/状态输出仍属于 `/verbose`。 ## 配置更新 @@ -305,14 +306,14 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /config unset messages.responsePrefix ``` -注意： +说明： -- 配置会在写入前进行校验；无效更改会被拒绝。 +- 写入前会验证配置；无效更改会被拒绝。 - `/config` 更新会在重启后保留。 ## MCP 更新 -`/mcp` 会将 OpenClaw 管理的 MCP 服务器定义写入 `mcp.servers`。仅所有者可用。默认禁用；通过 `commands.mcp: true` 启用。 +`/mcp` 会将由 OpenClaw 管理的 MCP 服务器定义写入 `mcp.servers` 下。仅所有者可用。默认禁用；通过 `commands.mcp: true` 启用。 示例： @@ -323,14 +324,14 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /mcp unset context7 ``` -注意： +说明： - `/mcp` 将配置存储在 OpenClaw 配置中，而不是 Pi 拥有的项目设置中。 -- 运行时适配器决定哪些传输实际上可执行。 +- 运行时适配器决定哪些传输方式实际上可以执行。 ## 插件更新 -`/plugins` 允许操作员检查已发现的插件，并在配置中切换启用状态。只读流程可使用 `/plugin` 作为别名。默认禁用；通过 `commands.plugins: true` 启用。 +`/plugins` 允许操作员检查已发现的插件，并在配置中切换启用状态。只读流程可以使用 `/plugin` 作为别名。默认禁用；通过 `commands.plugins: true` 启用。 示例： @@ -342,36 +343,36 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合： /plugins disable context7 ``` -注意： +说明： -- `/plugins list` 和 `/plugins show` 会基于当前工作区和磁盘配置执行真实插件发现。 -- `/plugins enable|disable` 只更新插件配置；不会安装或卸载插件。 -- 启用/禁用变更后，重启 Gateway 网关以应用它们。 +- `/plugins list` 和 `/plugins show` 会针对当前工作区和磁盘配置执行真实的插件发现。 +- `/plugins enable|disable` 只会更新插件配置；它不会安装或卸载插件。 +- 启用/禁用更改后，请重启 Gateway 网关以应用更改。 ## 界面说明 -- **文本命令** 在普通聊天会话中运行（私信共享 `main`，群组有各自的会话）。 +- **文本命令** 在普通聊天会话中运行（私信共享 `main`，群组有各自独立会话）。 - **原生命令** 使用隔离会话： - Discord：`agent::discord:slash:` - Slack：`agent::slack:slash:`（前缀可通过 `channels.slack.slashCommand.sessionPrefix` 配置） - - Telegram：`telegram:slash:`（通过 `CommandTargetSessionKey` 定向到聊天会话） -- **`/stop`** 作用于当前活动聊天会话，因此它可以中止当前运行。 -- **Slack：** `channels.slack.slashCommand` 仍支持单个 `/openclaw` 风格命令。如果你启用 `commands.native`，则必须为每个内置命令创建一个 Slack 斜杠命令（名称与 `/help` 等相同）。Slack 的命令参数菜单通过临时 Block Kit 按钮传递。 - - Slack 原生命令例外：请注册 `/agentstatus`（而不是 `/status`），因为 Slack 保留了 `/status`。文本 `/status` 在 Slack 消息中仍然可用。 + - Telegram：`telegram:slash:`（通过 `CommandTargetSessionKey` 目标到聊天会话） +- **`/stop`** 以活动聊天会话为目标，因此它可以中止当前运行。 +- **Slack：** 仍然支持 `channels.slack.slashCommand`，用于单个 `/openclaw` 风格命令。如果你启用了 `commands.native`，则必须为每个内置命令分别创建一个 Slack 斜杠命令（名称与 `/help` 等相同）。Slack 的命令参数菜单以临时 Block Kit 按钮形式交付。 + - Slack 原生命令例外：请注册 `/agentstatus`（不是 `/status`），因为 Slack 保留了 `/status`。文本形式的 `/status` 在 Slack 消息中仍然可用。 -## BTW 旁支问题 +## BTW 侧边问题 -`/btw` 是一个关于当前会话的快速**旁支问题**。 +`/btw` 是一个关于当前会话的快捷**侧边问题**。 与普通聊天不同： - 它使用当前会话作为背景上下文， -- 它以单独的**无工具**一次性调用运行， +- 它作为一个独立的**无工具**一次性调用运行， - 它不会改变未来的会话上下文， -- 它不会写入转录历史， -- 它会作为实时旁支结果传递，而不是普通助手消息。 +- 它不会写入转录记录历史， +- 它会作为实时侧边结果交付，而不是普通助手消息。 -这使得 `/btw` 在你希望获得临时澄清、同时主任务继续推进时非常有用。 +这使得 `/btw` 在你想临时澄清某件事、同时主任务继续进行时非常有用。 示例：