chore(i18n): refresh zh-CN translations

2026-04-10 21:21:44 +00:00 · 2026-04-10 21:21:44 +00:00 · 8a983d7da9
commit 8a983d7da9
parent 43d087f89f
2 changed files with 244 additions and 149 deletions
--- a/docs/zh-CN/plugins/codex-harness.md
+++ b/docs/zh-CN/plugins/codex-harness.md
@ -1,52 +1,52 @@
 ---
 read_when:
-    - 你想使用内置的 Codex app-server 测试工具
+    - 你想使用内置的 Codex app-server 运行支架
    - 你需要 Codex 模型引用和配置示例
    - 你想为仅使用 Codex 的部署禁用 PI 回退机制
-summary: 通过内置的 Codex app-server 测试工具运行 OpenClaw 嵌入式智能体轮次
-title: Codex 测试工具
+summary: 通过内置的 Codex app-server 运行支架运行 OpenClaw 嵌入式智能体轮次
+title: Codex 运行支架
 x-i18n:
-    generated_at: "2026-04-10T21:05:27Z"
+    generated_at: "2026-04-10T21:20:45Z"
    model: gpt-5.4
    provider: openai
-    source_hash: b1babe5b3498eb2a963f3e66a46975bd261886398499453d0d240e1fbc309bf4
+    source_hash: 7ba7e0eeb264f846a66a927baf6ded83438a7b4a3df86ee9fe562105f5bb05aa
    source_path: plugins/codex-harness.md
    workflow: 15
 ---

-# Codex 测试工具
+# Codex 运行支架

-内置的 `codex` 插件让 OpenClaw 通过 Codex app-server 运行嵌入式智能体轮次，而不是使用内置的 PI 测试工具。
+内置的 `codex` 插件让 OpenClaw 可以通过 Codex app-server 运行嵌入式智能体轮次，而不是使用内置的 PI 运行支架。

-当你希望由 Codex 接管底层智能体会话时使用此功能：模型发现、原生线程恢复、原生压缩，以及 app-server 执行。OpenClaw 仍然负责聊天渠道、会话文件、模型选择、工具、审批、媒体传输，以及可见的对话记录镜像。
+当你希望由 Codex 接管底层智能体会话时，可以使用它：模型发现、原生线程恢复、原生压缩，以及 app-server 执行。OpenClaw 仍然负责聊天渠道、会话文件、模型选择、工具、审批、媒体传递，以及可见的转录镜像。

-该测试工具默认关闭。只有在启用 `codex` 插件且解析后的模型是 `codex/*` 模型时，或者你显式强制设置 `embeddedHarness.runtime: "codex"` 或 `OPENCLAW_AGENT_RUNTIME=codex` 时，才会选用它。如果你从不配置 `codex/*`，现有的 PI、OpenAI、Anthropic、Gemini、本地和自定义提供商运行方式都会保持当前行为。
+该运行支架默认关闭。只有在启用 `codex` 插件且解析后的模型是 `codex/*` 模型时，或者你显式强制设置 `embeddedHarness.runtime: "codex"` 或 `OPENCLAW_AGENT_RUNTIME=codex` 时，才会选用它。如果你从未配置 `codex/*`，现有的 PI、OpenAI、Anthropic、Gemini、本地和自定义提供商运行都会保持当前行为。

 ## 选择正确的模型前缀

-OpenClaw 为 OpenAI 和 Codex 风格的访问提供了不同的路由：
+OpenClaw 为 OpenAI 访问和 Codex 形态的访问提供了不同路径：

-| 模型引用               | 运行时路径                                   | 适用场景                                                                |
-| ---------------------- | -------------------------------------------- | ----------------------------------------------------------------------- |
-| `openai/gpt-5.4`       | 通过 OpenClaw/PI 管道的 OpenAI 提供商路径    | 你希望使用 `OPENAI_API_KEY` 直接访问 OpenAI Platform API。              |
-| `openai-codex/gpt-5.4` | 通过 PI 的 OpenAI Codex OAuth 提供商路径     | 你希望使用 ChatGPT/Codex OAuth，但不使用 Codex app-server 测试工具。    |
-| `codex/gpt-5.4`        | 内置 Codex 提供商 + Codex 测试工具           | 你希望在嵌入式智能体轮次中使用原生 Codex app-server 执行。              |
+| 模型引用               | 运行时路径                                  | 适用场景 |
+| ---------------------- | ------------------------------------------- | -------- |
+| `openai/gpt-5.4`       | 通过 OpenClaw/PI 管线的 OpenAI 提供商路径   | 你想通过 `OPENAI_API_KEY` 直接访问 OpenAI Platform API。 |
+| `openai-codex/gpt-5.4` | 通过 PI 的 OpenAI Codex OAuth 提供商路径    | 你想使用 ChatGPT/Codex OAuth，但不使用 Codex app-server 运行支架。 |
+| `codex/gpt-5.4`        | 内置 Codex 提供商加 Codex 运行支架          | 你希望嵌入式智能体轮次使用原生 Codex app-server 执行。 |

-Codex 测试工具只接管 `codex/*` 模型引用。现有的 `openai/*`、`openai-codex/*`、Anthropic、Gemini、xAI、本地和自定义提供商引用都会继续走各自的正常路径。
+Codex 运行支架只会接管 `codex/*` 模型引用。现有的 `openai/*`、`openai-codex/*`、Anthropic、Gemini、xAI、本地和自定义提供商引用会继续走其常规路径。

 ## 要求

- OpenClaw，且内置的 `codex` 插件可用。
+- OpenClaw，并且可用内置的 `codex` 插件。
 - Codex app-server `0.118.0` 或更高版本。
- app-server 进程可用的 Codex 认证信息。
+- app-server 进程可用的 Codex 身份验证。

-该插件会阻止较旧版本或未带版本信息的 app-server 握手。这可确保 OpenClaw 始终运行在它已测试过的协议接口上。
+该插件会阻止较旧或未带版本信息的 app-server 握手。这可以确保 OpenClaw 使用的是它已经测试过的协议接口。

-对于实时测试和 Docker 冒烟测试，认证通常来自 `OPENAI_API_KEY`，以及可选的 Codex CLI 文件，例如 `~/.codex/auth.json` 和 `~/.codex/config.toml`。请使用与你本地 Codex app-server 相同的认证材料。
+对于实时和 Docker 冒烟测试，身份验证通常来自 `OPENAI_API_KEY`，以及可选的 Codex CLI 文件，例如 `~/.codex/auth.json` 和 `~/.codex/config.toml`。请使用与你本地 Codex app-server 相同的身份验证材料。

 ## 最小配置

-使用 `codex/gpt-5.4`，启用内置插件，并强制使用 `codex` 测试工具：
+使用 `codex/gpt-5.4`，启用内置插件，并强制使用 `codex` 运行支架：

 ```json5
 {
@ -84,11 +84,11 @@ Codex 测试工具只接管 `codex/*` 模型引用。现有的 `openai/*`、`ope
 }
 ```

-将 `agents.defaults.model` 或某个智能体模型设置为 `codex/<model>` 也会自动启用内置的 `codex` 插件。显式添加插件条目在共享配置中仍然很有用，因为它能让部署意图更清晰。
+将 `agents.defaults.model` 或某个智能体模型设置为 `codex/<model>` 也会自动启用内置的 `codex` 插件。在共享配置中，显式的插件条目仍然很有用，因为它能让部署意图更加明确。

 ## 在不替换其他模型的情况下添加 Codex

-如果你希望 `codex/*` 模型使用 Codex，而其他所有模型仍使用 PI，请保持 `runtime: "auto"`：
+如果你希望 `codex/*` 模型使用 Codex，而其他一切仍使用 PI，请保留 `runtime: "auto"`：

 ```json5
 {
@ -120,16 +120,16 @@ Codex 测试工具只接管 `codex/*` 模型引用。现有的 `openai/*`、`ope
 }
 ```

-采用这种配置后：
+在这种配置下：

- `/model codex` 或 `/model codex/gpt-5.4` 会使用 Codex app-server 测试工具。
+- `/model codex` 或 `/model codex/gpt-5.4` 会使用 Codex app-server 运行支架。
 - `/model gpt` 或 `/model openai/gpt-5.4` 会使用 OpenAI 提供商路径。
 - `/model opus` 会使用 Anthropic 提供商路径。
- 如果选择的是非 Codex 模型，PI 仍然是兼容性测试工具。
+- 如果选择的是非 Codex 模型，PI 仍然作为兼容性运行支架。

 ## 仅使用 Codex 的部署

-如果你需要证明每个嵌入式智能体轮次都使用 Codex 测试工具，请禁用 PI 回退：
+如果你需要证明每一次嵌入式智能体轮次都使用 Codex 运行支架，请禁用 PI 回退：

 ```json5
 {
@ -145,7 +145,7 @@ Codex 测试工具只接管 `codex/*` 模型引用。现有的 `openai/*`、`ope
 }
 ```

-环境变量覆盖：
+环境覆盖：

 ```bash
 OPENCLAW_AGENT_RUNTIME=codex \
@ -155,7 +155,7 @@ openclaw gateway run

 禁用回退后，如果 Codex 插件被禁用、请求的模型不是 `codex/*` 引用、app-server 版本过旧，或者 app-server 无法启动，OpenClaw 都会尽早失败。

-## 按智能体使用 Codex
+## 按智能体配置 Codex

 你可以让某一个智能体仅使用 Codex，而默认智能体继续保持正常的自动选择：

@ -188,11 +188,11 @@ openclaw gateway run
 }
 ```

-使用常规会话命令切换智能体和模型。`/new` 会创建一个新的 OpenClaw 会话，而 Codex 测试工具会按需创建或恢复它对应的 sidecar app-server 线程。`/reset` 会清除该线程的 OpenClaw 会话绑定。
+使用常规会话命令来切换智能体和模型。`/new` 会创建一个新的 OpenClaw 会话，而 Codex 运行支架会按需创建或恢复其 sidecar app-server 线程。`/reset` 会清除该线程的 OpenClaw 会话绑定。

 ## 模型发现

-默认情况下，Codex 插件会向 app-server 请求可用模型。如果发现失败或超时，它会使用内置的回退目录：
+默认情况下，`codex` 插件会向 app-server 请求可用模型。如果发现失败或超时，它会使用内置的回退目录：

 - `codex/gpt-5.4`
 - `codex/gpt-5.4-mini`
@ -218,7 +218,7 @@ openclaw gateway run
 }
 ```

-如果你希望启动时避免探测 Codex，并始终使用回退目录，可以禁用发现：
+如果你希望启动时避免探测 Codex，并固定使用回退目录，可以禁用发现：

 ```json5
 {
@ -237,31 +237,128 @@ openclaw gateway run
 }
 ```

+## App-server 连接和策略
+
+默认情况下，插件会使用以下命令在本地启动 Codex：
+
+```bash
+codex app-server --listen stdio://
+```
+
+你可以保留这个默认值，只调整 Codex 原生策略：
+
+```json5
+{
+  plugins: {
+    entries: {
+      codex: {
+        enabled: true,
+        config: {
+          appServer: {
+            approvalPolicy: "on-request",
+            sandbox: "workspace-write",
+            serviceTier: "priority",
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+对于已在运行的 app-server，可以使用 WebSocket 传输：
+
+```json5
+{
+  plugins: {
+    entries: {
+      codex: {
+        enabled: true,
+        config: {
+          appServer: {
+            transport: "websocket",
+            url: "ws://127.0.0.1:39175",
+            authToken: "${CODEX_APP_SERVER_TOKEN}",
+            requestTimeoutMs: 60000,
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+支持的 `appServer` 字段：
+
+| 字段                | 默认值                                   | 含义 |
+| ------------------- | ---------------------------------------- | ---- |
+| `transport`         | `"stdio"`                                | `"stdio"` 会启动 Codex；`"websocket"` 会连接到 `url`。 |
+| `command`           | `"codex"`                                | 用于 stdio 传输的可执行文件。 |
+| `args`              | `["app-server", "--listen", "stdio://"]` | 用于 stdio 传输的参数。 |
+| `url`               | 未设置                                   | WebSocket app-server URL。 |
+| `authToken`         | 未设置                                   | WebSocket 传输的 Bearer token。 |
+| `headers`           | `{}`                                     | 额外的 WebSocket 标头。 |
+| `requestTimeoutMs`  | `60000`                                  | app-server 控制平面调用的超时时间。 |
+| `approvalPolicy`    | `"never"`                                | 发送给线程启动、恢复和轮次的原生 Codex 审批策略。 |
+| `sandbox`           | `"workspace-write"`                      | 发送给线程启动和恢复的原生 Codex 沙箱模式。 |
+| `approvalsReviewer` | `"user"`                                 | 使用 `"guardian_subagent"` 可让 Codex guardian 审查原生审批。 |
+| `serviceTier`       | 未设置                                   | 可选的 Codex 服务层级，例如 `"priority"`。 |
+
+较旧的环境变量在对应配置字段未设置时，仍然可以作为本地测试的回退方式使用：
+
+- `OPENCLAW_CODEX_APP_SERVER_BIN`
+- `OPENCLAW_CODEX_APP_SERVER_ARGS`
+- `OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY`
+- `OPENCLAW_CODEX_APP_SERVER_SANDBOX`
+- `OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1`
+
+对于可重复部署，优先使用配置。
+
+## Codex 命令
+
+内置插件将 `/codex` 注册为授权斜杠命令。它是通用的，可在任何支持 OpenClaw 文本命令的渠道中使用。
+
+常见形式：
+
+- `/codex status` 显示实时的 app-server 连接状态、模型、账户、速率限制、MCP 服务器和 Skills。
+- `/codex models` 列出实时的 Codex app-server 模型。
+- `/codex threads [filter]` 列出最近的 Codex 线程。
+- `/codex resume <thread-id>` 将当前 OpenClaw 会话附加到现有的 Codex 线程。
+- `/codex compact` 请求 Codex app-server 压缩已附加的线程。
+- `/codex review` 为已附加的线程启动 Codex 原生审查。
+- `/codex account` 显示账户和速率限制状态。
+- `/codex mcp` 列出 Codex app-server MCP 服务器状态。
+- `/codex skills` 列出 Codex app-server Skills。
+
+`/codex resume` 会写入与运行支架用于常规轮次相同的 sidecar 绑定文件。在下一条消息时，OpenClaw 会恢复该 Codex 线程，将当前选定的 OpenClaw `codex/*` 模型传递给 app-server，并保持启用扩展历史记录。
+
 ## 工具、媒体和压缩

-Codex 测试工具只会改变底层嵌入式智能体执行器。
+Codex 运行支架只改变底层的嵌入式智能体执行器。

-OpenClaw 仍然会构建工具列表，并从测试工具接收动态工具结果。文本、图像、视频、音乐、TTS、审批以及消息工具输出，都会继续通过正常的 OpenClaw 传输路径处理。
+OpenClaw 仍然会构建工具列表，并从运行支架接收动态工具结果。文本、图像、视频、音乐、TTS、审批和消息工具输出，都会继续通过正常的 OpenClaw 传递路径处理。

-当所选模型使用 Codex 测试工具时，原生线程压缩会委托给 Codex app-server。OpenClaw 会保留一份对话记录镜像，用于渠道历史、搜索、`/new`、`/reset`，以及未来的模型或测试工具切换。
+当所选模型使用 Codex 运行支架时，原生线程压缩会委托给 Codex app-server。OpenClaw 会继续保留转录镜像，用于渠道历史、搜索、`/new`、`/reset` 以及未来的模型或运行支架切换。

-媒体生成不依赖 PI。图像、视频、音乐、PDF、TTS 和媒体理解仍会继续使用匹配的提供商/模型设置，例如 `agents.defaults.imageGenerationModel`、`videoGenerationModel`、`pdfModel` 和 `messages.tts`。
+媒体生成不需要 PI。图像、视频、音乐、PDF、TTS 和媒体理解会继续使用相应的提供商/模型设置，例如 `agents.defaults.imageGenerationModel`、`videoGenerationModel`、`pdfModel` 和 `messages.tts`。

 ## 故障排除

-**Codex 没有出现在 `/model` 中：** 启用 `plugins.entries.codex.enabled`，设置一个 `codex/*` 模型引用，或检查 `plugins.allow` 是否排除了 `codex`。
+**`/model` 中没有出现 Codex：** 启用 `plugins.entries.codex.enabled`，设置一个 `codex/*` 模型引用，或者检查 `plugins.allow` 是否排除了 `codex`。

 **OpenClaw 回退到 PI：** 在测试时设置 `embeddedHarness.fallback: "none"` 或 `OPENCLAW_AGENT_HARNESS_FALLBACK=none`。

-**app-server 被拒绝：** 升级 Codex，使 app-server 握手报告的版本为 `0.118.0` 或更高。
+**app-server 被拒绝：** 升级 Codex，确保 app-server 握手报告的版本为 `0.118.0` 或更高。

-**模型发现速度很慢：** 降低 `plugins.entries.codex.config.discovery.timeoutMs`，或禁用发现。
+**模型发现很慢：** 降低 `plugins.entries.codex.config.discovery.timeoutMs`，或者禁用发现。

-**某个非 Codex 模型使用了 PI：** 这是预期行为。Codex 测试工具只接管 `codex/*` 模型引用。
+**WebSocket 传输立即失败：** 检查 `appServer.url`、`authToken`，并确认远端 app-server 使用的是相同版本的 Codex app-server 协议。
+
+**非 Codex 模型使用了 PI：** 这是预期行为。Codex 运行支架只会接管 `codex/*` 模型引用。

 ## 相关内容

- [智能体测试工具插件](/zh-CN/plugins/sdk-agent-harness)
+- [智能体运行支架插件](/zh-CN/plugins/sdk-agent-harness)
 - [模型提供商](/zh-CN/concepts/model-providers)
 - [配置参考](/zh-CN/gateway/configuration-reference)
 - [测试](/zh-CN/help/testing#live-codex-app-server-harness-smoke)
--- a/docs/zh-CN/tools/slash-commands.md
+++ b/docs/zh-CN/tools/slash-commands.md
@ -1,36 +1,35 @@
 ---
 read_when:
-    - 使用或配置聊天命令时
-    - 调试命令路由或权限时
-summary: 斜杠命令：文本与原生、配置以及支持的命令
+    - 使用或配置聊天命令
+    - 调试命令路由或权限
+summary: 斜杠命令：文本与原生、配置，以及支持的命令
 title: 斜杠命令
 x-i18n:
-    generated_at: "2026-04-08T05:13:52Z"
+    generated_at: "2026-04-10T21:20:39Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 4a7ee7f1a8012058279b9e632889b291d4e659e4ec81209ca8978afbb9ad4b96
+    source_hash: 2cc346361c3b1a63aae9ec0f28706f4cb0b866b6c858a3999101f6927b923b4a
    source_path: tools/slash-commands.md
    workflow: 15
 ---

 # 斜杠命令

-命令由 Gateway 网关处理。大多数命令都必须作为一条以 `/` 开头的**独立**消息发送。
-仅主机可用的 bash 聊天命令使用 `! <cmd>`（`/bash <cmd>` 是它的别名）。
+命令由 Gateway 网关处理。大多数命令必须作为以 `/` 开头的**独立**消息发送。
+仅限主机的 bash 聊天命令使用 `! <cmd>`（`/bash <cmd>` 是其别名）。

 这里有两个相关系统：

 - **命令**：独立的 `/...` 消息。
 - **指令**：`/think`、`/fast`、`/verbose`、`/reasoning`、`/elevated`、`/exec`、`/model`、`/queue`。
-  - 指令会在模型看到消息之前从消息中移除。
-  - 在普通聊天消息中（不是仅包含指令的消息），它们会被视为“内联提示”，并且**不会**持久化会话设置。
-  - 在仅包含指令的消息中（消息只包含指令），它们会持久化到会话中，并回复一条确认信息。
-  - 指令只会对**已授权的发送者**生效。如果设置了 `commands.allowFrom`，它就是唯一使用的
-    允许列表；否则授权来自渠道允许列表/配对，再加上 `commands.useAccessGroups`。
-    未授权的发送者看到的指令会被当作普通文本处理。
+  - 指令会在模型看到消息之前被剥离。
+  - 在普通聊天消息中（不是仅包含指令的消息），它们会被视为“内联提示”，**不会**持久化会话设置。
+  - 在仅包含指令的消息中（消息只包含指令），它们会持久化到会话，并回复一条确认信息。
+  - 指令只会对**已授权的发送者**生效。如果设置了 `commands.allowFrom`，它就是唯一使用的允许列表；否则授权来源于渠道允许列表/配对以及 `commands.useAccessGroups`。
+    未授权的发送者会看到指令被当作普通文本处理。

-还有少量**内联快捷方式**（仅限已列入允许列表/已授权的发送者）：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。
-它们会立即运行，在模型看到消息前被移除，剩余文本继续按正常流程处理。
+还有一些**内联快捷方式**（仅限允许列表/已授权发送者）：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。
+它们会立即运行，在模型看到消息前被剥离，剩余文本会继续走正常流程。

 ## 配置

@ -60,26 +59,26 @@ 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"`）注册原生命令。
-  - 自动：在 Discord/Telegram 上开启；在 Slack 上关闭（直到你添加斜杠命令）；对不支持原生命令的提供商会忽略。
+  - Auto：对 Discord/Telegram 开启；对 Slack 关闭（直到你添加 slash commands）；对不支持原生能力的提供商忽略。
  - 设置 `channels.discord.commands.native`、`channels.telegram.commands.native` 或 `channels.slack.commands.native` 可按提供商覆盖（布尔值或 `"auto"`）。
-  - `false` 会在启动时清除之前在 Discord/Telegram 上注册的命令。Slack 命令由 Slack 应用管理，不会自动移除。
+  - `false` 会在启动时清除之前在 Discord/Telegram 上注册的命令。Slack 命令由 Slack 应用管理，不会被自动移除。
 - `commands.nativeSkills`（默认 `"auto"`）在支持时以原生方式注册 **skill** 命令。
-  - 自动：在 Discord/Telegram 上开启；在 Slack 上关闭（Slack 需要为每个 skill 单独创建一个斜杠命令）。
+  - Auto：对 Discord/Telegram 开启；对 Slack 关闭（Slack 需要为每个 skill 创建一个 slash command）。
  - 设置 `channels.discord.commands.nativeSkills`、`channels.telegram.commands.nativeSkills` 或 `channels.slack.commands.nativeSkills` 可按提供商覆盖（布尔值或 `"auto"`）。
- `commands.bash`（默认 `false`）启用 `! <cmd>` 来运行主机 shell 命令（`/bash <cmd>` 是别名；需要 `tools.elevated` 允许列表）。
+- `commands.bash`（默认 `false`）启用 `! <cmd>` 以运行主机 shell 命令（`/bash <cmd>` 是别名；需要 `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.ownerDisplay` 控制所有者 id 在系统提示中如何显示：`raw` 或 `hash`。
- `commands.ownerDisplaySecret` 可选设置当 `commands.ownerDisplay="hash"` 时使用的 HMAC 密钥。
- `commands.allowFrom`（可选）为命令授权设置按提供商区分的允许列表。配置后，它会成为命令和指令的唯一授权来源（渠道允许列表/配对以及 `commands.useAccessGroups` 都会被忽略）。使用 `"*"` 作为全局默认值；提供商特定键会覆盖它。
- `commands.useAccessGroups`（默认 `true`）在未设置 `commands.allowFrom` 时，为命令强制执行允许列表/策略。
+- `commands.ownerAllowFrom`（可选）为仅限所有者的命令/工具界面设置显式所有者允许列表。这与 `commands.allowFrom` 分开。
+- `commands.ownerDisplay` 控制系统提示中所有者 id 的显示方式：`raw` 或 `hash`。
+- `commands.ownerDisplaySecret` 可选设置在 `commands.ownerDisplay="hash"` 时使用的 HMAC 密钥。
+- `commands.allowFrom`（可选）为命令授权设置按提供商划分的允许列表。配置后，它会成为命令和指令的唯一授权来源（渠道允许列表/配对和 `commands.useAccessGroups` 会被忽略）。使用 `"*"` 作为全局默认值；提供商特定键会覆盖它。
+- `commands.useAccessGroups`（默认 `true`）在未设置 `commands.allowFrom` 时，对命令强制执行允许列表/策略。

 ## 命令列表

@ -88,13 +87,13 @@ x-i18n:
 - 核心内置命令来自 `src/auto-reply/commands-registry.shared.ts`
 - 生成的 dock 命令来自 `src/auto-reply/commands-registry.data.ts`
 - 插件命令来自插件的 `registerCommand()` 调用
- 你的 Gateway 网关上实际可用的命令仍取决于配置标志、渠道界面以及已安装/已启用的插件
+- 你的 Gateway 网关上实际可用的命令仍取决于配置标志、渠道界面，以及已安装/已启用的插件

 ### 核心内置命令

 当前可用的内置命令：

- `/new [model]` 开始一个新会话；`/reset` 是重置别名。
+- `/new [model]` 启动一个新会话；`/reset` 是重置别名。
 - `/compact [instructions]` 压缩会话上下文。参见 [/concepts/compaction](/zh-CN/concepts/compaction)。
 - `/stop` 中止当前运行。
 - `/session idle <duration|off>` 和 `/session max-age <duration|off>` 管理线程绑定过期时间。
@ -106,36 +105,36 @@ x-i18n:
 - `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` 显示或设置 exec 默认值。
 - `/model [name|#|status]` 显示或设置模型。
 - `/models [provider] [page] [limit=<n>|size=<n>|all]` 列出提供商，或列出某个提供商的模型。
- `/queue <mode>` 管理队列行为（`steer`、`interrupt`、`followup`、`collect`、`steer-backlog`），以及如 `debounce:2s cap:25 drop:summarize` 这样的选项。
+- `/queue <mode>` 管理队列行为（`steer`、`interrupt`、`followup`、`collect`、`steer-backlog`），以及如 `debounce:2s cap:25 drop:summarize` 等选项。
 - `/help` 显示简短帮助摘要。
 - `/commands` 显示生成的命令目录。
- `/tools [compact|verbose]` 显示当前智能体此刻可以使用什么。
- `/status` 显示运行时状态，包括可用时的提供商用量/配额。
- `/tasks` 列出当前会话中活跃/最近的后台任务。
+- `/tools [compact|verbose]` 显示当前智能体此刻可用的内容。
+- `/status` 显示运行时状态，包括可用时的提供商使用量/配额。
+- `/tasks` 列出当前会话的活跃/最近后台任务。
 - `/context [list|detail|json]` 说明上下文是如何组装的。
 - `/export-session [path]` 将当前会话导出为 HTML。别名：`/export`。
 - `/whoami` 显示你的发送者 id。别名：`/id`。
 - `/skill <name> [input]` 按名称运行一个 skill。
 - `/allowlist [list|add|remove] ...` 管理允许列表条目。仅文本。
 - `/approve <id> <decision>` 处理 exec 审批提示。
- `/btw <question>` 在不改变未来会话上下文的情况下提出一个旁支问题。参见 [/tools/btw](/zh-CN/tools/btw)。
+- `/btw <question>` 提一个侧边问题，而不改变未来会话上下文。参见 [/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 <target>` 将当前 Discord 线程或 Telegram 话题/会话绑定到一个会话目标。
 - `/unfocus` 移除当前绑定。
 - `/agents` 列出当前会话中线程绑定的智能体。
- `/kill <id|#|all>` 中止一个或所有正在运行的子智能体。
- `/steer <id|#> <message>` 向一个正在运行的子智能体发送引导。别名：`/tell`。
+- `/kill <id|#|all>` 中止一个或全部正在运行的子智能体。
+- `/steer <id|#> <message>` 向正在运行的子智能体发送引导。别名：`/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` 控制每条回复的用量页脚，或打印本地成本摘要。
+- `/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` 控制每次响应的使用量页脚，或打印本地成本摘要。
 - `/tts on|off|status|provider|limit|summary|audio|help` 控制 TTS。参见 [/tools/tts](/zh-CN/tools/tts)。
- `/restart` 在启用时重启 OpenClaw。默认启用；设置 `commands.restart: false` 可禁用。
+- `/restart` 在启用时重启 OpenClaw。默认：启用；设置 `commands.restart: false` 可禁用。
 - `/activation mention|always` 设置群组激活模式。
 - `/send on|off|inherit` 设置发送策略。仅限所有者。
- `/bash <command>` 运行主机 shell 命令。仅文本。别名：`! <command>`。需要 `commands.bash: true` 以及 `tools.elevated` 允许列表。
+- `/bash <command>` 运行主机 shell 命令。仅文本。别名：`! <command>`。需要 `commands.bash: true`，并且需要 `tools.elevated` 允许列表。
 - `!poll [sessionId]` 检查一个后台 bash 作业。
 - `!stop [sessionId]` 停止一个后台 bash 作业。

@ -150,14 +149,15 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：

 ### 内置插件命令

-内置插件可以添加更多斜杠命令。此仓库中当前的内置命令有：
+内置插件可以添加更多斜杠命令。此仓库中当前的内置命令：

- `/dreaming [on|off|status|help]` 切换记忆梦境。参见 [Dreaming](/zh-CN/concepts/dreaming)。
+- `/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 <camera|screen|writes|all> [duration]|disarm` 临时启用高风险手机节点命令。
 - `/voice status|list [limit]|set <voiceId|name>` 管理 Talk 语音配置。在 Discord 上，原生命令名称是 `/talkvoice`。
 - `/card ...` 发送 LINE 富卡片预设。参见 [LINE](/zh-CN/channels/line)。
- 仅 QQ Bot 命令：
+- `/codex status|models|threads|resume|compact|review|account|mcp|skills` 检查并控制内置 Codex app-server harness。参见 [Codex Harness](/zh-CN/plugins/codex-harness)。
+- 仅限 QQ Bot 的命令：
  - `/bot-ping`
  - `/bot-version`
  - `/bot-help`
@ -166,72 +166,70 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：

 ### 动态 skill 命令

-用户可调用的 Skills 也会作为斜杠命令公开：
+用户可调用的 Skills 也会作为斜杠命令暴露：

- `/skill <name> [input]` 始终可作为通用入口点使用。
- skills 也可能在 skill/插件注册它们时，直接以 `/prose` 这样的命令出现。
+- `/skill <name> [input]` 始终可用，作为通用入口点。
+- 当 skill/插件注册它们时，Skills 也可能作为直接命令出现，例如 `/prose`。
 - 原生 skill 命令注册由 `commands.nativeSkills` 和 `channels.<provider>.commands.nativeSkills` 控制。

 说明：

- 命令在命令和参数之间可接受一个可选的 `:`（例如 `/think: high`、`/send: on`、`/help:`）。
- `/new <model>` 接受模型别名、`provider/model`，或提供商名称（模糊匹配）；如果没有匹配，文本会被视为消息正文。
- 如需完整的提供商用量明细，请使用 `openclaw status --usage`。
+- 命令支持在命令与参数之间可选添加 `:`（例如 `/think: high`、`/send: on`、`/help:`）。
+- `/new <model>` 接受模型别名、`provider/model` 或提供商名称（模糊匹配）；如果没有匹配项，该文本会被视为消息正文。
+- 如需完整的提供商使用量明细，请使用 `openclaw status --usage`。
 - `/allowlist add|remove` 需要 `commands.config=true`，并遵循渠道 `configWrites`。
 - 在多账号渠道中，面向配置目标的 `/allowlist --account <id>` 和 `/config set channels.<provider>.accounts.<id>...` 也会遵循目标账号的 `configWrites`。
- `/usage` 控制每条回复的用量页脚；`/usage cost` 会从 OpenClaw 会话日志中打印本地成本摘要。
+- `/usage` 控制每次响应的使用量页脚；`/usage cost` 会根据 OpenClaw 会话日志输出本地成本摘要。
 - `/restart` 默认启用；设置 `commands.restart: false` 可禁用。
- `/plugins install <spec>` 接受与 `openclaw plugins install` 相同的插件规格：本地路径/归档、npm 包，或 `clawhub:<pkg>`。
- `/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` 用于调试和提供更多可见性；正常使用时请保持**关闭**。
- `/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`）在群组环境中有风险：它们可能暴露你本不打算公开的内部推理或工具输出。建议保持关闭，尤其是在群聊中。
+- `/plugins install <spec>` 接受与 `openclaw plugins install` 相同的插件规格：本地路径/压缩包、npm 包，或 `clawhub:<pkg>`。
+- `/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` 用于调试和额外可见性；在正常使用中请保持其为**关闭**。
+- `/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`）在群组环境中存在风险：它们可能暴露你原本不打算公开的内部推理或工具输出。建议保持关闭，尤其是在群聊中。
 - `/model` 会立即持久化新的会话模型。
 - 如果智能体处于空闲状态，下一次运行会立即使用它。
- 如果某次运行已经处于活跃状态，OpenClaw 会将实时切换标记为待处理，并且只会在一个干净的重试点重启到新模型。
- 如果工具活动或回复输出已经开始，这个待处理切换可能会一直排队，直到后续某个重试机会或下一次用户轮次。
- **快速路径：**来自允许列表发送者的纯命令消息会被立即处理（绕过队列 + 模型）。
- **群组提及门控：**来自允许列表发送者的纯命令消息会绕过提及要求。
- **内联快捷方式（仅限允许列表发送者）：**某些命令在嵌入普通消息时也可使用，并会在模型看到剩余文本前被移除。
-  - 例如：`hey /status` 会触发一条状态回复，而剩余文本继续按正常流程处理。
+- 如果已有运行处于活跃状态，OpenClaw 会将实时切换标记为待处理，并且只会在一个干净的重试点重启到新模型。
+- 如果工具活动或回复输出已经开始，待处理切换可能会保持排队状态，直到后续重试机会或下一次用户回合。
+- **快速路径：** 来自允许列表发送者的纯命令消息会被立即处理（绕过队列 + 模型）。
+- **群组提及门控：** 来自允许列表发送者的纯命令消息会绕过提及要求。
+- **内联快捷方式（仅限允许列表发送者）：** 某些命令在嵌入普通消息时也可生效，并会在模型看到剩余文本前被剥离。
+  - 示例：`hey /status` 会触发状态回复，剩余文本继续走正常流程。
 - 当前包括：`/help`、`/commands`、`/status`、`/whoami`（`/id`）。
- 未授权的纯命令消息会被静默忽略，而内联 `/...` 令牌会被当作普通文本处理。
- **Skill 命令：**`user-invocable` skills 会作为斜杠命令公开。名称会被规范化为 `a-z0-9_`（最多 32 个字符）；冲突会追加数字后缀（例如 `_2`）。
-  - `/skill <name> [input]` 按名称运行一个 skill（当原生命令限制阻止按 skill 单独生成命令时，这很有用）。
+- 未授权的纯命令消息会被静默忽略，而内联 `/...` 标记会被视为普通文本。
+- **skill 命令：** `user-invocable` 的 Skills 也会作为斜杠命令暴露。名称会被清洗为 `a-z0-9_`（最多 32 个字符）；冲突时会添加数字后缀（例如 `_2`）。
+  - `/skill <name> [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` 是紧凑模式，并针对快速浏览进行了优化。
 - `/tools verbose` 会添加简短说明。
- 支持参数的原生命令界面会公开同样的模式切换：`compact|verbose`。
- 结果以会话为范围，因此更改智能体、渠道、线程、发送者授权或模型都可能改变输出。
- `/tools` 包含在运行时实际可达的工具，包括核心工具、已连接的插件工具以及渠道自有工具。
+- 支持参数的原生命令界面也会暴露相同的模式切换：`compact|verbose`。
+- 结果是作用于会话范围的，因此更改智能体、渠道、线程、发送者授权或模型，都可能改变输出。
+- `/tools` 包括在运行时实际可达的工具，包括核心工具、已连接的插件工具和渠道自有工具。

-对于配置文件和覆盖编辑，请使用 Control UI Tools 面板或配置/目录界面，
-而不要把 `/tools` 当作静态目录。
+如需编辑 profile 和 override，请使用 Control UI Tools 面板或配置/目录界面，而不要把 `/tools` 当作静态目录。

-## 用量界面（在哪里显示什么）
+## 使用量界面（哪些内容显示在哪里）

- **提供商用量/配额**（例如：“Claude 剩余 80%”）会在启用用量跟踪时出现在 `/status` 中，对应当前模型提供商。OpenClaw 会将提供商窗口统一为“剩余百分比”；对于 MiniMax，显示前会先反转仅剩余百分比字段，而 `model_remains` 响应会优先选择聊天模型条目以及带模型标签的计划名称。
- `/status` 中的**令牌/缓存行**在实时会话快照信息较少时，可能回退到最新的转录用量条目。现有的非零实时值仍然优先，而转录回退也可以在存储总量缺失或更小时，恢复当前活跃运行时模型标签以及一个更偏向提示的大总量值。
- **每条回复的令牌/成本** 由 `/usage off|tokens|full` 控制（附加到正常回复之后）。
- `/model status` 关注的是**模型/认证/端点**，而不是用量。
+- **提供商使用量/配额**（例如“Claude 剩余 80%”）会在启用使用量跟踪时显示在当前模型提供商的 `/status` 中。OpenClaw 会将提供商窗口统一为“剩余百分比”；对于 MiniMax，仅提供剩余百分比字段时会在显示前取反，而 `model_remains` 响应会优先选择 chat-model 条目以及带模型标签的套餐标签。
+- `/status` 中的**令牌/缓存行**，在实时会话快照内容较少时，可以回退到最近一次转录使用量条目。现有的非零实时值仍然优先，且当存储总量缺失或更小时，转录回退还可以恢复当前活跃运行时模型标签以及一个更大的、面向提示词的总量。
+- **每次响应的令牌/成本** 由 `/usage off|tokens|full` 控制（附加到正常回复后）。
+- `/model status` 关注的是**模型/认证/端点**，而不是使用量。

 ## 模型选择（`/model`）

-`/model` 是作为指令实现的。
+`/model` 被实现为一个指令。

 示例：

@ -247,13 +245,13 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：
 说明：

 - `/model` 和 `/model list` 会显示一个紧凑的编号选择器（模型家族 + 可用提供商）。
- 在 Discord 上，`/model` 和 `/models` 会打开一个交互式选择器，包含提供商和模型下拉框以及一个提交步骤。
- `/model <#>` 会从该选择器中进行选择（并在可能时优先使用当前提供商）。
+- 在 Discord 上，`/model` 和 `/models` 会打开一个交互式选择器，其中包含提供商和模型下拉菜单，以及一个提交步骤。
+- `/model <#>` 会从该选择器中进行选择（并尽可能优先当前提供商）。
 - `/model status` 会显示详细视图，包括已配置的提供商端点（`baseUrl`）和 API 模式（`api`），如果可用。

 ## 调试覆盖

-`/debug` 允许你设置**仅运行时**的配置覆盖（内存中，不写入磁盘）。仅限所有者。默认禁用；通过 `commands.debug: true` 启用。
+`/debug` 允许你设置**仅运行时**的配置覆盖（内存中，不写磁盘）。仅限所有者。默认禁用；通过 `commands.debug: true` 启用。

 示例：

@ -268,7 +266,7 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：
 说明：

 - 覆盖会立即应用于新的配置读取，但**不会**写入 `openclaw.json`。
- 使用 `/debug reset` 清除所有覆盖，并返回到磁盘上的配置。
+- 使用 `/debug reset` 清除所有覆盖，并返回磁盘上的配置。

 ## 配置更新

@ -286,12 +284,12 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：

 说明：

- 写入前会验证配置；无效更改会被拒绝。
- `/config` 更新会在重启后持久保留。
+- 配置会在写入前进行校验；无效更改会被拒绝。
+- `/config` 更新会在重启后保留。

 ## MCP 更新

-`/mcp` 会将 OpenClaw 管理的 MCP 服务器定义写入 `mcp.servers`。仅限所有者。默认禁用；通过 `commands.mcp: true` 启用。
+`/mcp` 会写入 `mcp.servers` 下由 OpenClaw 管理的 MCP 服务器定义。仅限所有者。默认禁用；通过 `commands.mcp: true` 启用。

 示例：

@ -304,12 +302,12 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：

 说明：

- `/mcp` 将配置存储在 OpenClaw 配置中，而不是 Pi 拥有的项目设置中。
+- `/mcp` 将配置存储在 OpenClaw 配置中，而不是 Pi 自有项目设置中。
 - 运行时适配器决定哪些传输实际上可执行。

 ## 插件更新

-`/plugins` 允许操作员检查已发现的插件并在配置中切换启用状态。只读流程可使用 `/plugin` 作为别名。默认禁用；通过 `commands.plugins: true` 启用。
+`/plugins` 允许操作员检查已发现的插件，并在配置中切换启用状态。只读流程可使用 `/plugin` 作为别名。默认禁用；通过 `commands.plugins: true` 启用。

 示例：

@ -323,34 +321,34 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：

 说明：

- `/plugins list` 和 `/plugins show` 会针对当前工作区和磁盘上的配置执行真实的插件发现。
- `/plugins enable|disable` 只更新插件配置；不会安装或卸载插件。
- 启用/禁用更改后，重启 Gateway 网关以应用它们。
+- `/plugins list` 和 `/plugins show` 会基于当前工作区加磁盘配置执行真实的插件发现。
+- `/plugins enable|disable` 仅更新插件配置；不会安装或卸载插件。
+- 在启用/禁用更改后，重启 gateway 以应用它们。

 ## 界面说明

- **文本命令** 在普通聊天会话中运行（私信共享 `main`，群组拥有各自的会话）。
+- **文本命令** 在正常聊天会话中运行（私信共享 `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` 仍然支持单个 `/openclaw` 风格的命令。如果你启用 `commands.native`，则必须为每个内置命令在 Slack 中创建一个斜杠命令（名称与 `/help` 相同）。Slack 的命令参数菜单会以临时 Block Kit 按钮的形式发送。
-  - Slack 原生命令例外：请注册 `/agentstatus`（而不是 `/status`），因为 Slack 保留了 `/status`。文本 `/status` 在 Slack 消息中仍然可用。
+  - Telegram：`telegram:slash:<userId>`（通过 `CommandTargetSessionKey` 指向聊天会话）
+- **`/stop`** 以活跃聊天会话为目标，因此它可以中止当前运行。
+- **Slack：** `channels.slack.slashCommand` 仍支持单个 `/openclaw` 风格命令。如果你启用 `commands.native`，则必须为每个内置命令创建一个 Slack slash command（名称与 `/help` 等相同）。Slack 的命令参数菜单会以临时 Block Kit 按钮的形式提供。
+  - Slack 原生命令例外：请注册 `/agentstatus`（不是 `/status`），因为 Slack 保留了 `/status`。文本 `/status` 在 Slack 消息中仍可使用。

-## BTW 旁支问题
+## BTW 侧边问题

-`/btw` 是一个关于当前会话的快速**旁支问题**。
+`/btw` 是一个关于当前会话的快捷**侧边问题**。

 与普通聊天不同：

- 它会将当前会话作为背景上下文，
- 它会作为一次单独的**无工具**单次调用运行，
+- 它会使用当前会话作为背景上下文，
+- 它会作为一个独立的**无工具**单次调用运行，
 - 它不会改变未来的会话上下文，
 - 它不会写入转录历史，
- 它会以实时旁支结果的形式传递，而不是普通的助手消息。
+- 它会作为实时侧边结果交付，而不是普通的助手消息。

-这使得 `/btw` 在你想要临时澄清、同时主任务继续进行时非常有用。
+这让 `/btw` 在你希望获得临时澄清、同时主任务继续进行时非常有用。

 示例：

@ -358,4 +356,4 @@ Dock 命令由支持原生命令的渠道插件生成。当前内置集合：
 /btw what are we doing right now?
 ```

-完整行为和客户端 UX 细节，请参见 [BTW Side Questions](/zh-CN/tools/btw)。
+完整行为和客户端 UX 细节请参见 [BTW Side Questions](/zh-CN/tools/btw)。