chore(i18n): refresh zh-CN translations

2026-05-01 11:04:00 +00:00 · 2026-05-01 11:04:00 +00:00 · 6938490b6e
commit 6938490b6e
parent 17f9cf4354
2 changed files with 381 additions and 371 deletions
--- a/docs/zh-CN/channels/discord.md
+++ b/docs/zh-CN/channels/discord.md
--- a/docs/zh-CN/gateway/config-channels.md
+++ b/docs/zh-CN/gateway/config-channels.md
@ -1,27 +1,27 @@
 ---
 read_when:
-    - 配置渠道插件（身份验证、访问控制、多账户）
-    - 排查各渠道配置键
+    - 配置渠道插件（身份验证、访问控制、多账号）
+    - 各渠道配置键名的故障排除
    - 审计私信策略、群组策略或提及门控
-summary: 渠道配置：Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 等的访问控制、配对和各渠道密钥
+summary: 渠道配置：访问控制、配对，以及涵盖 Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 等的每渠道密钥
 title: 配置 — 渠道
 x-i18n:
-    generated_at: "2026-05-01T03:00:03Z"
+    generated_at: "2026-05-01T11:02:00Z"
    model: gpt-5.5
    provider: openai
-    source_hash: ce1571d51e026182d49b935780a986780a90b05afc0acca027b2541b80a1aac2
+    source_hash: bcdc5ba7dd6633749eccf27fa20f8933049061e5f11efbf315c31cd2512e055d
    source_path: gateway/config-channels.md
    workflow: 16
 ---

-`channels.*` 下的各渠道配置键。涵盖私信和群组访问、多账号设置、提及门控，以及 Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 和其他内置渠道插件的各渠道键。
+`channels.*` 下的每渠道配置键。涵盖私信和群组访问、多账号设置、提及门控，以及 Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 和其他内置渠道插件的每渠道键。

-对于智能体、工具、Gateway 网关运行时和其他顶级键，请参阅
+对于智能体、工具、Gateway 网关运行时和其他顶层键，请参阅
 [配置参考](/zh-CN/gateway/configuration-reference)。

 ## 渠道

-每个渠道会在其配置段存在时自动启动（除非设置了 `enabled: false`）。
+每个渠道会在其配置段存在时自动启动（除非 `enabled: false`）。

 ### 私信和群组访问

@ -30,7 +30,7 @@ x-i18n:
 | 私信策略            | 行为                                                        |
 | ------------------- | --------------------------------------------------------------- |
 | `pairing`（默认） | 未知发送者会收到一次性配对码；所有者必须批准 |
-| `allowlist`         | 仅允许 `allowFrom`（或已配对允许存储）中的发送者             |
+| `allowlist`         | 仅允许 `allowFrom` 中的发送者（或已配对的允许存储）             |
 | `open`              | 允许所有入站私信（需要 `allowFrom: ["*"]`）             |
 | `disabled`          | 忽略所有入站私信                                          |

@ -42,13 +42,13 @@ x-i18n:

 <Note>
 `channels.defaults.groupPolicy` 会在提供商的 `groupPolicy` 未设置时设置默认值。
-配对码会在 1 小时后过期。待处理的私信配对请求上限为 **每个渠道 3 个**。
+配对码会在 1 小时后过期。待处理的私信配对请求上限为**每个渠道 3 个**。
 如果提供商块完全缺失（不存在 `channels.<provider>`），运行时群组策略会回退到 `allowlist`（故障关闭），并在启动时发出警告。
 </Note>

 ### 渠道模型覆盖

-使用 `channels.modelByChannel` 将特定渠道 ID 固定到某个模型。值接受 `provider/model` 或已配置的模型别名。当会话尚未有模型覆盖时（例如通过 `/model` 设置），会应用渠道映射。
+使用 `channels.modelByChannel` 将特定渠道 ID 固定到某个模型。值接受 `provider/model` 或已配置的模型别名。当会话尚未有模型覆盖（例如通过 `/model` 设置）时，会应用渠道映射。

 ```json5
 {
@ -71,7 +71,7 @@ x-i18n:

 ### 渠道默认值和 Heartbeat

-使用 `channels.defaults` 为各提供商设置共享的群组策略和 Heartbeat 行为：
+使用 `channels.defaults` 为各提供商配置共享的群组策略和 Heartbeat 行为：

 ```json5
 {
@ -89,15 +89,15 @@ x-i18n:
 }
 ```

- `channels.defaults.groupPolicy`：提供商级 `groupPolicy` 未设置时的备用群组策略。
- `channels.defaults.contextVisibility`：所有渠道的默认补充上下文可见性模式。值：`all`（默认，包含所有引用/话题串/历史上下文）、`allowlist`（仅包含来自允许列表发送者的上下文）、`allowlist_quote`（与允许列表相同，但保留显式引用/回复上下文）。按渠道覆盖：`channels.<channel>.contextVisibility`。
+- `channels.defaults.groupPolicy`：当提供商级 `groupPolicy` 未设置时使用的回退群组策略。
+- `channels.defaults.contextVisibility`：所有渠道的默认补充上下文可见性模式。取值：`all`（默认，包含所有引用/线程/历史上下文）、`allowlist`（仅包含来自允许列表发送者的上下文）、`allowlist_quote`（与允许列表相同，但保留显式引用/回复上下文）。每渠道覆盖：`channels.<channel>.contextVisibility`。
 - `channels.defaults.heartbeat.showOk`：在 Heartbeat 输出中包含健康的渠道 Status。
 - `channels.defaults.heartbeat.showAlerts`：在 Heartbeat 输出中包含降级/错误 Status。
- `channels.defaults.heartbeat.useIndicator`：渲染紧凑指示器样式的 Heartbeat 输出。
+- `channels.defaults.heartbeat.useIndicator`：渲染紧凑的指示器式 Heartbeat 输出。

 ### WhatsApp

-WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已链接会话时，它会自动启动。
+WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已链接会话时会自动启动。

 ```json5
 {
@ -155,10 +155,10 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已
 }
 ```

- 出站命令默认使用 `default` 账号（如果存在）；否则使用第一个已配置账号 ID（排序后）。
- 可选的 `channels.whatsapp.defaultAccount` 会在匹配已配置账号 ID 时覆盖该备用默认账号选择。
- 旧版单账号 Baileys 凭证目录会由 `openclaw doctor` 迁移到 `whatsapp/default`。
- 按账号覆盖：`channels.whatsapp.accounts.<id>.sendReadReceipts`、`channels.whatsapp.accounts.<id>.dmPolicy`、`channels.whatsapp.accounts.<id>.allowFrom`。
+- 出站命令默认使用账号 `default`（如果存在）；否则使用第一个已配置的账号 ID（排序后）。
+- 可选的 `channels.whatsapp.defaultAccount` 会在匹配某个已配置账号 ID 时覆盖该回退默认账号选择。
+- 旧版单账号 Baileys 身份验证目录会由 `openclaw doctor` 迁移到 `whatsapp/default`。
+- 每账号覆盖：`channels.whatsapp.accounts.<id>.sendReadReceipts`、`channels.whatsapp.accounts.<id>.dmPolicy`、`channels.whatsapp.accounts.<id>.allowFrom`。

 </Accordion>

@ -217,14 +217,14 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已
 }
 ```

- 机器人令牌：`channels.telegram.botToken` 或 `channels.telegram.tokenFile`（仅常规文件；拒绝符号链接），默认账号以 `TELEGRAM_BOT_TOKEN` 作为备用。
- `apiRoot` 只是 Telegram Bot API 根地址。使用 `https://api.telegram.org` 或你自托管/代理的根地址，而不是 `https://api.telegram.org/bot<TOKEN>`；`openclaw doctor --fix` 会移除意外的尾随 `/bot<TOKEN>` 后缀。
- 可选的 `channels.telegram.defaultAccount` 会在匹配已配置账号 ID 时覆盖默认账号选择。
- 在多账号设置（2 个以上账号 ID）中，设置显式默认值（`channels.telegram.defaultAccount` 或 `channels.telegram.accounts.default`）以避免备用路由；缺失或无效时，`openclaw doctor` 会发出警告。
- `configWrites: false` 会阻止由 Telegram 发起的配置写入（超级群组 ID 迁移、`/config set|unset`）。
- 带有 `type: "acp"` 的顶级 `bindings[]` 条目会为论坛话题配置持久 ACP 绑定（在 `match.peer.id` 中使用规范的 `chatId:topic:topicId`）。字段语义在 [ACP 智能体](/zh-CN/tools/acp-agents#channel-specific-settings) 中共享。
- Telegram 流式预览使用 `sendMessage` + `editMessageText`（适用于直接聊天和群聊）。
- 重试策略：参阅[重试策略](/zh-CN/concepts/retry)。
+- Bot token：`channels.telegram.botToken` 或 `channels.telegram.tokenFile`（仅限普通文件；拒绝符号链接），默认账号以 `TELEGRAM_BOT_TOKEN` 作为回退。
+- `apiRoot` 仅是 Telegram Bot API 根地址。使用 `https://api.telegram.org` 或你的自托管/代理根地址，而不是 `https://api.telegram.org/bot<TOKEN>`；`openclaw doctor --fix` 会移除意外尾随的 `/bot<TOKEN>` 后缀。
+- 可选的 `channels.telegram.defaultAccount` 会在匹配某个已配置账号 ID 时覆盖默认账号选择。
+- 在多账号设置（2 个以上账号 ID）中，设置显式默认值（`channels.telegram.defaultAccount` 或 `channels.telegram.accounts.default`）以避免回退路由；缺失或无效时，`openclaw doctor` 会发出警告。
+- `configWrites: false` 会阻止由 Telegram 发起的配置写入（超群组 ID 迁移、`/config set|unset`）。
+- 带有 `type: "acp"` 的顶层 `bindings[]` 条目会为论坛话题配置持久 ACP 绑定（在 `match.peer.id` 中使用规范的 `chatId:topic:topicId`）。字段语义在 [ACP Agents](/zh-CN/tools/acp-agents#channel-specific-settings) 中共享。
+- Telegram 流式预览使用 `sendMessage` + `editMessageText`（适用于私聊和群聊）。
+- 重试策略：请参阅[重试策略](/zh-CN/concepts/retry)。

 ### Discord

@ -302,6 +302,8 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
+        connectTimeoutMs: 30000,
+        reconnectGraceMs: 15000,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
@ -326,37 +328,39 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已
 }
 ```

- 令牌：`channels.discord.token`，默认账号的备用值为 `DISCORD_BOT_TOKEN`。
- 提供显式 Discord `token` 的直接出站调用会使用该令牌执行调用；账号重试/策略设置仍来自活动运行时快照中选定的账号。
- 可选的 `channels.discord.defaultAccount` 在匹配已配置账号 ID 时，会覆盖默认账号选择。
- 使用 `user:<id>`（私信）或 `channel:<id>`（服务器频道）作为投递目标；裸数字 ID 会被拒绝。
- 服务器 slug 为小写，并将空格替换为 `-`；频道键使用已 slug 化的名称（不含 `#`）。优先使用服务器 ID。
- 默认忽略机器人发送的消息。`allowBots: true` 会启用它们；使用 `allowBots: "mentions"` 可仅接受提及该机器人的机器人消息（仍会过滤自己的消息）。
- `channels.discord.guilds.<id>.ignoreOtherMentions`（以及频道覆盖）会丢弃提及其他用户或角色但未提及该机器人的消息（不包括 @everyone/@here）。
- `maxLinesPerMessage`（默认 17）即使在低于 2000 个字符时，也会拆分过高的消息。
+- 令牌：`channels.discord.token`，默认账号回退使用 `DISCORD_BOT_TOKEN`。
+- 提供显式 Discord `token` 的直接出站调用会使用该令牌执行调用；账号重试/策略设置仍来自活动运行时快照中的所选账号。
+- 可选的 `channels.discord.defaultAccount` 在匹配已配置账号 ID 时会覆盖默认账号选择。
+- 使用 `user:<id>`（私信）或 `channel:<id>`（服务器渠道）作为投递目标；裸数字 ID 会被拒绝。
+- 服务器短标识为小写，并将空格替换为 `-`；渠道键使用短标识化后的名称（不含 `#`）。优先使用服务器 ID。
+- 机器人发送的消息默认会被忽略。`allowBots: true` 会启用它们；使用 `allowBots: "mentions"` 仅接受提到该机器人的机器人消息（自身消息仍会被过滤）。
+- `channels.discord.guilds.<id>.ignoreOtherMentions`（以及渠道覆盖项）会丢弃那些提到了另一个用户或角色但未提到该机器人的消息（不包括 @everyone/@here）。
+- `maxLinesPerMessage`（默认 17）即使在低于 2000 字符时也会拆分过高的消息。
 - `channels.discord.threadBindings` 控制 Discord 线程绑定路由：
-  - `enabled`：用于线程绑定会话功能（`/focus`、`/unfocus`、`/agents`、`/session idle`、`/session max-age`，以及绑定投递/路由）的 Discord 覆盖项
-  - `idleHours`：Discord 的非活动自动取消聚焦覆盖项，单位为小时（`0` 表示禁用）
-  - `maxAgeHours`：Discord 的硬性最大时长覆盖项，单位为小时（`0` 表示禁用）
-  - `spawnSubagentSessions`：用于 `sessions_spawn({ thread: true })` 自动创建/绑定线程的选择性开关
- 顶层 `bindings[]` 条目中带 `type: "acp"` 的配置用于为渠道和线程配置持久 ACP 绑定（在 `match.peer.id` 中使用频道/线程 ID）。字段语义在 [ACP Agents](/zh-CN/tools/acp-agents#channel-specific-settings) 中共享。
+  - `enabled`：Discord 对线程绑定会话功能的覆盖项（`/focus`、`/unfocus`、`/agents`、`/session idle`、`/session max-age`，以及绑定投递/路由）
+  - `idleHours`：Discord 对非活动自动取消聚焦小时数的覆盖项（`0` 表示禁用）
+  - `maxAgeHours`：Discord 对硬性最大年龄小时数的覆盖项（`0` 表示禁用）
+  - `spawnSubagentSessions`：用于 `sessions_spawn({ thread: true })` 自动创建/绑定线程的选择加入开关
+- 顶层 `bindings[]` 条目带有 `type: "acp"` 时，会为渠道和线程配置持久 ACP 绑定（在 `match.peer.id` 中使用渠道/线程 ID）。字段语义在 [ACP 智能体](/zh-CN/tools/acp-agents#channel-specific-settings)中共享。
 - `channels.discord.ui.components.accentColor` 设置 Discord components v2 容器的强调色。
- `channels.discord.voice` 启用 Discord 语音频道对话，以及可选的自动加入 + LLM + TTS 覆盖项。
- `channels.discord.voice.model` 可选择覆盖用于 Discord 语音频道响应的 LLM 模型。
- `channels.discord.voice.daveEncryption` 和 `channels.discord.voice.decryptionFailureTolerance` 会透传给 `@discordjs/voice` DAVE 选项（默认分别为 `true` 和 `24`）。
- OpenClaw 还会在反复解密失败后，通过离开/重新加入语音会话来尝试恢复语音接收。
- `channels.discord.streaming` 是规范的流模式键。旧版 `streamMode` 和布尔型 `streaming` 值会自动迁移。
- `channels.discord.autoPresence` 将运行时可用性映射到机器人在线状态（healthy => online、degraded => idle、exhausted => dnd），并允许可选的状态文本覆盖。
- `channels.discord.dangerouslyAllowNameMatching` 会重新启用可变名称/标签匹配（破窗兼容模式）。
- `channels.discord.execApprovals`：Discord 原生 exec 审批投递和审批人授权。
-  - `enabled`：`true`、`false` 或 `"auto"`（默认）。在自动模式下，当可以从 `approvers` 或 `commands.ownerAllowFrom` 解析审批人时，会激活 exec 审批。
-  - `approvers`：允许批准 exec 请求的 Discord 用户 ID。省略时回退到 `commands.ownerAllowFrom`。
-  - `agentFilter`：可选的智能体 ID 允许列表。省略时转发所有智能体的审批。
-  - `sessionFilter`：可选的会话键模式（子字符串或正则表达式）。
-  - `target`：发送审批提示的位置。`"dm"`（默认）发送到审批人私信，`"channel"` 发送到来源频道，`"both"` 同时发送到两者。当目标包含 `"channel"` 时，按钮仅可由已解析的审批人使用。
+- `channels.discord.voice` 启用 Discord 语音渠道对话，以及可选的自动加入 + LLM + TTS 覆盖项。
+- `channels.discord.voice.model` 可选地覆盖用于 Discord 语音渠道响应的 LLM 模型。
+- `channels.discord.voice.daveEncryption` 和 `channels.discord.voice.decryptionFailureTolerance` 会透传到 `@discordjs/voice` DAVE 选项（默认分别为 `true` 和 `24`）。
+- `channels.discord.voice.connectTimeoutMs` 控制 `/vc join` 和自动加入尝试的初始 `@discordjs/voice` Ready 等待（默认 `30000`）。
+- `channels.discord.voice.reconnectGraceMs` 控制断开的语音会话在 OpenClaw 销毁它之前可进入重连信令的时长（默认 `15000`）。
+- OpenClaw 还会在重复解密失败后通过离开/重新加入语音会话来尝试恢复语音接收。
+- `channels.discord.streaming` 是规范流式传输模式键。旧版 `streamMode` 和布尔型 `streaming` 值会自动迁移。
+- `channels.discord.autoPresence` 将运行时可用性映射到机器人在线状态（healthy => online, degraded => idle, exhausted => dnd），并允许可选的状态文本覆盖项。
+- `channels.discord.dangerouslyAllowNameMatching` 重新启用可变名称/标签匹配（破窗兼容模式）。
+- `channels.discord.execApprovals`：Discord 原生 exec 审批投递和审批者授权。
+  - `enabled`：`true`、`false` 或 `"auto"`（默认）。在 auto 模式下，当可以从 `approvers` 或 `commands.ownerAllowFrom` 解析审批者时，exec 审批会激活。
+  - `approvers`：允许审批 exec 请求的 Discord 用户 ID。省略时回退到 `commands.ownerAllowFrom`。
+  - `agentFilter`：可选智能体 ID 允许列表。省略时转发所有智能体的审批。
+  - `sessionFilter`：可选会话键模式（子字符串或正则表达式）。
+  - `target`：审批提示的发送位置。`"dm"`（默认）发送到审批者私信，`"channel"` 发送到来源渠道，`"both"` 同时发送到两者。当目标包含 `"channel"` 时，按钮只能由解析出的审批者使用。
  - `cleanupAfterResolve`：为 `true` 时，在批准、拒绝或超时后删除审批私信。

-**反应通知模式：** `off`（无）、`own`（机器人的消息，默认）、`all`（所有消息）、`allowlist`（来自所有消息上的 `guilds.<id>.users`）。
+**表情回应通知模式：** `off`（无）、`own`（机器人的消息，默认）、`all`（所有消息）、`allowlist`（来自所有消息上的 `guilds.<id>.users`）。

 ### Google Chat

@ -389,9 +393,9 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已

 - 服务账号 JSON：内联（`serviceAccount`）或基于文件（`serviceAccountFile`）。
 - 也支持服务账号 SecretRef（`serviceAccountRef`）。
- 环境备用值：`GOOGLE_CHAT_SERVICE_ACCOUNT` 或 `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`。
+- 环境变量回退：`GOOGLE_CHAT_SERVICE_ACCOUNT` 或 `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`。
 - 使用 `spaces/<spaceId>` 或 `users/<userId>` 作为投递目标。
- `channels.googlechat.dangerouslyAllowNameMatching` 会重新启用可变邮箱主体匹配（破窗兼容模式）。
+- `channels.googlechat.dangerouslyAllowNameMatching` 重新启用可变电子邮件主体匹配（破窗兼容模式）。

 ### Slack

@ -463,35 +467,44 @@ WhatsApp 通过 Gateway 网关的 Web 渠道（Baileys Web）运行。存在已
 }
 ```

- **Socket 模式**需要同时提供 `botToken` 和 `appToken`（默认账号环境备用值为 `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`）。
- **HTTP 模式**需要 `botToken` 以及 `signingSecret`（位于根级别或每个账号中）。
- `socketMode` 会将 Slack SDK Socket Mode 传输调优透传给公开的 Bolt receiver API。仅在调查 ping/pong 超时或陈旧 websocket 行为时使用它。
- `botToken`、`appToken`、`signingSecret` 和 `userToken` 接受明文字符串或 SecretRef 对象。
- Slack 账号快照会公开每个凭证的来源/状态字段，例如 `botTokenSource`、`botTokenStatus`、`appTokenStatus`，以及在 HTTP 模式下的 `signingSecretStatus`。`configured_unavailable` 表示账号通过 SecretRef 配置，但当前命令/运行时路径无法解析密钥值。
- `configWrites: false` 会阻止由 Slack 发起的配置写入。
- 可选的 `channels.slack.defaultAccount` 在匹配已配置账号 ID 时，会覆盖默认账号选择。
- `channels.slack.streaming.mode` 是规范的 Slack 流模式键。`channels.slack.streaming.nativeTransport` 控制 Slack 的原生流式传输。旧版 `streamMode`、布尔型 `streaming` 和 `nativeStreaming` 值会自动迁移。
+- **Socket 模式**需要同时提供 `botToken` 和 `appToken`（默认账号环境变量回退使用 `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`）。
+- **HTTP 模式**需要 `botToken` 加 `signingSecret`（位于根级别或每账号配置）。
+- `socketMode` 会将 Slack SDK Socket Mode 传输调优透传到公共 Bolt 接收器 API。仅在调查 ping/pong 超时或过期 WebSocket 行为时使用它。
+- `botToken`、`appToken`、`signingSecret` 和 `userToken` 接受明文
+  字符串或 SecretRef 对象。
+- Slack 账号快照会暴露每个凭证的来源/状态字段，例如
+  `botTokenSource`、`botTokenStatus`、`appTokenStatus`，以及在 HTTP 模式下的
+  `signingSecretStatus`。`configured_unavailable` 表示账号已通过
+  SecretRef 配置，但当前命令/运行时路径无法
+  解析密钥值。
+- `configWrites: false` 阻止由 Slack 发起的配置写入。
+- 可选的 `channels.slack.defaultAccount` 在匹配已配置账号 ID 时会覆盖默认账号选择。
+- `channels.slack.streaming.mode` 是规范 Slack 流式传输模式键。`channels.slack.streaming.nativeTransport` 控制 Slack 的原生流式传输传输协议。旧版 `streamMode`、布尔型 `streaming` 和 `nativeStreaming` 值会自动迁移。
 - 使用 `user:<id>`（私信）或 `channel:<id>` 作为投递目标。

-**反应通知模式：** `off`、`own`（默认）、`all`、`allowlist`（来自 `reactionAllowlist`）。
+**表情回应通知模式：** `off`、`own`（默认）、`all`、`allowlist`（来自 `reactionAllowlist`）。

-**线程会话隔离：** `thread.historyScope` 是按线程（默认）或跨频道共享。`thread.inheritParent` 会将父频道转录复制到新线程。
+**线程会话隔离：** `thread.historyScope` 是每线程（默认）或在渠道内共享。`thread.inheritParent` 会将父渠道转录复制到新线程。

- Slack 原生流式传输以及 Slack 助手风格的 “is typing...” 线程状态需要回复线程目标。顶层私信默认保持非线程状态，因此它们会使用 `typingReaction` 或普通投递，而不是线程风格预览。
- `typingReaction` 会在回复运行期间向入站 Slack 消息添加临时反应，并在完成时移除它。使用 Slack emoji 短代码，例如 `"hourglass_flowing_sand"`。
- `channels.slack.execApprovals`：Slack 原生 exec 审批投递和审批人授权。架构与 Discord 相同：`enabled`（`true`/`false`/`"auto"`）、`approvers`（Slack 用户 ID）、`agentFilter`、`sessionFilter` 和 `target`（`"dm"`、`"channel"` 或 `"both"`）。
+- Slack 原生流式传输以及 Slack 助手风格的“正在输入...”线程状态需要一个回复线程目标。顶层私信默认保持在线程外，因此它们使用 `typingReaction` 或普通投递，而不是线程样式预览。
+- `typingReaction` 会在回复运行时向入站 Slack 消息添加临时表情回应，然后在完成时移除它。使用 Slack emoji 短代码，例如 `"hourglass_flowing_sand"`。
+- `channels.slack.execApprovals`：Slack 原生 exec 审批投递和审批者授权。架构与 Discord 相同：`enabled`（`true`/`false`/`"auto"`）、`approvers`（Slack 用户 ID）、`agentFilter`、`sessionFilter` 和 `target`（`"dm"`、`"channel"` 或 `"both"`）。

 | 操作组 | 默认值 | 备注                  |
 | ------------ | ------- | ---------------------- |
-| reactions    | 已启用 | 反应 + 列出反应 |
+| reactions    | 已启用 | 表情回应 + 列出表情回应 |
 | messages     | 已启用 | 读取/发送/编辑/删除  |
-| pins         | 已启用 | 置顶/取消置顶/列出         |
+| pins         | 已启用 | 固定/取消固定/列出         |
 | memberInfo   | 已启用 | 成员信息            |
 | emojiList    | 已启用 | 自定义 emoji 列表      |

 ### Mattermost

-Mattermost 在当前 OpenClaw 版本中作为内置插件发布。较旧版本或自定义构建可以使用 `openclaw plugins install @openclaw/mattermost` 安装当前 npm 包；如果 npm 报告 OpenClaw 拥有的包已弃用，请使用内置插件或本地检出，直到发布更新的 npm 包。
+Mattermost 在当前 OpenClaw 版本中作为内置插件发布。较旧或
+自定义构建可以使用
+`openclaw plugins install @openclaw/mattermost` 安装当前 npm 软件包；如果 npm 报告
+OpenClaw 所有的软件包已弃用，请使用内置插件或本地检出版本，
+直到发布更新的 npm 软件包。

 ```json5
 {
@ -521,18 +534,18 @@ Mattermost 在当前 OpenClaw 版本中作为内置插件发布。较旧版本
 }
 ```

-聊天模式：`oncall`（在 @-提及时响应，默认）、`onmessage`（每条消息）、`onchar`（以触发前缀开头的消息）。
+聊天模式：`oncall`（在 @ 提及时响应，默认）、`onmessage`（每条消息）、`onchar`（以触发前缀开头的消息）。

 启用 Mattermost 原生命令时：

- `commands.callbackPath` 必须是路径（例如 `/api/channels/mattermost/command`），而不是完整 URL。
- `commands.callbackUrl` 必须解析为 OpenClaw Gateway 网关端点，并且可由 Mattermost 服务器访问。
- 原生 slash 回调使用 Mattermost 在 slash 命令注册期间返回的每命令令牌进行认证。如果注册失败或没有激活命令，OpenClaw 会以 `Unauthorized: invalid command token.` 拒绝回调。
- 对于私有/tailnet/内部回调主机，Mattermost 可能要求 `ServiceSettings.AllowedUntrustedInternalConnections` 包含回调主机/域名。使用主机/域名值，而不是完整 URL。
+- `commands.callbackPath` 必须是路径（例如 `/api/channels/mattermost/command`），不能是完整 URL。
+- `commands.callbackUrl` 必须解析到 OpenClaw Gateway 网关端点，并且可从 Mattermost 服务器访问。
+- 原生斜杠回调使用 Mattermost 在注册斜杠命令期间返回的每命令令牌进行身份验证。如果注册失败或没有命令被激活，OpenClaw 会拒绝回调并返回 `Unauthorized: invalid command token.`
+- 对于私有、tailnet 或内部回调主机，Mattermost 可能要求 `ServiceSettings.AllowedUntrustedInternalConnections` 包含该回调主机/域名。请使用主机/域名值，而不是完整 URL。
 - `channels.mattermost.configWrites`：允许或拒绝由 Mattermost 发起的配置写入。
- `channels.mattermost.requireMention`：在频道中回复前要求 `@mention`。
- `channels.mattermost.groups.<channelId>.requireMention`：按频道的提及门控覆盖项（`"*"` 表示默认值）。
- 可选的 `channels.mattermost.defaultAccount` 在匹配已配置账号 ID 时，会覆盖默认账号选择。
+- `channels.mattermost.requireMention`：要求在渠道中回复前先出现 `@mention`。
+- `channels.mattermost.groups.<channelId>.requireMention`：按渠道覆盖提及门控（`"*"` 表示默认）。
+- 可选的 `channels.mattermost.defaultAccount` 在匹配已配置账户 ID 时会覆盖默认账户选择。

 ### Signal

@ -553,11 +566,11 @@ Mattermost 在当前 OpenClaw 版本中作为内置插件发布。较旧版本
 }
 ```

-**响应通知模式：** `off`、`own`（默认）、`all`、`allowlist`（来自 `reactionAllowlist`）。
+**反应通知模式：** `off`、`own`（默认）、`all`、`allowlist`（来自 `reactionAllowlist`）。

- `channels.signal.account`：将渠道启动固定到特定 Signal 账户身份。
+- `channels.signal.account`：将渠道启动固定到特定的 Signal 账户身份。
 - `channels.signal.configWrites`：允许或拒绝由 Signal 发起的配置写入。
- 可选的 `channels.signal.defaultAccount` 会在匹配已配置账户 ID 时覆盖默认账户选择。
+- 可选的 `channels.signal.defaultAccount` 在匹配已配置账户 ID 时会覆盖默认账户选择。

 ### BlueBubbles

@ -577,13 +590,13 @@ BlueBubbles 是推荐的 iMessage 路径（由插件支持，在 `channels.blueb
 ```

 - 此处涵盖的核心键路径：`channels.bluebubbles`、`channels.bluebubbles.dmPolicy`。
- 可选的 `channels.bluebubbles.defaultAccount` 会在匹配已配置账户 ID 时覆盖默认账户选择。
- 顶层 `bindings[]` 条目如果带有 `type: "acp"`，可将 BlueBubbles 对话绑定到持久 ACP 会话。在 `match.peer.id` 中使用 BlueBubbles 句柄或目标字符串（`chat_id:*`、`chat_guid:*`、`chat_identifier:*`）。共享字段语义：[ACP 智能体](/zh-CN/tools/acp-agents#channel-specific-settings)。
- 完整的 BlueBubbles 渠道配置记录在 [BlueBubbles](/zh-CN/channels/bluebubbles)。
+- 可选的 `channels.bluebubbles.defaultAccount` 在匹配已配置账户 ID 时会覆盖默认账户选择。
+- 顶层 `bindings[]` 条目带有 `type: "acp"` 时，可将 BlueBubbles 对话绑定到持久 ACP 会话。请在 `match.peer.id` 中使用 BlueBubbles handle 或目标字符串（`chat_id:*`、`chat_guid:*`、`chat_identifier:*`）。共享字段语义：[ACP Agents](/zh-CN/tools/acp-agents#channel-specific-settings)。
+- 完整的 BlueBubbles 渠道配置记录在 [BlueBubbles](/zh-CN/channels/bluebubbles) 中。

 ### iMessage

-OpenClaw 会启动 `imsg rpc`（通过 stdio 运行的 JSON-RPC）。不需要守护进程或端口。
+OpenClaw 会启动 `imsg rpc`（通过 stdio 的 JSON-RPC）。不需要守护进程或端口。

 ```json5
 {
@ -607,17 +620,17 @@ OpenClaw 会启动 `imsg rpc`（通过 stdio 运行的 JSON-RPC）。不需要
 }
 ```

- 可选的 `channels.imessage.defaultAccount` 会在匹配已配置账户 ID 时覆盖默认账户选择。
+- 可选的 `channels.imessage.defaultAccount` 在匹配已配置账户 ID 时会覆盖默认账户选择。

- 需要对 Messages DB 授予完整磁盘访问权限。
+- 需要对 Messages 数据库拥有 Full Disk Access。
 - 优先使用 `chat_id:<id>` 目标。使用 `imsg chats --limit 20` 列出聊天。
- `cliPath` 可以指向 SSH 包装器；设置 `remoteHost`（`host` 或 `user@host`）以通过 SCP 获取附件。
- `attachmentRoots` 和 `remoteAttachmentRoots` 会限制传入附件路径（默认：`/Users/*/Library/Messages/Attachments`）。
- SCP 使用严格主机密钥检查，因此请确保中继主机密钥已存在于 `~/.ssh/known_hosts` 中。
+- `cliPath` 可以指向 SSH 包装器；设置 `remoteHost`（`host` 或 `user@host`）用于通过 SCP 获取附件。
+- `attachmentRoots` 和 `remoteAttachmentRoots` 会限制入站附件路径（默认：`/Users/*/Library/Messages/Attachments`）。
+- SCP 使用严格的主机密钥检查，因此请确保中继主机密钥已存在于 `~/.ssh/known_hosts` 中。
 - `channels.imessage.configWrites`：允许或拒绝由 iMessage 发起的配置写入。
- 顶层 `bindings[]` 条目如果带有 `type: "acp"`，可将 iMessage 对话绑定到持久 ACP 会话。在 `match.peer.id` 中使用规范化句柄或显式聊天目标（`chat_id:*`、`chat_guid:*`、`chat_identifier:*`）。共享字段语义：[ACP 智能体](/zh-CN/tools/acp-agents#channel-specific-settings)。
+- 顶层 `bindings[]` 条目带有 `type: "acp"` 时，可将 iMessage 对话绑定到持久 ACP 会话。请在 `match.peer.id` 中使用规范化 handle 或显式聊天目标（`chat_id:*`、`chat_guid:*`、`chat_identifier:*`）。共享字段语义：[ACP Agents](/zh-CN/tools/acp-agents#channel-specific-settings)。

-<Accordion title="iMessage SSH 包装器示例">
+<Accordion title="iMessage SSH wrapper example">

 ```bash
 #!/usr/bin/env bash
@ -659,20 +672,20 @@ Matrix 由插件支持，并在 `channels.matrix` 下配置。
 ```

 - 令牌认证使用 `accessToken`；密码认证使用 `userId` + `password`。
- `channels.matrix.proxy` 会通过显式 HTTP(S) 代理路由 Matrix HTTP 流量。具名账户可以用 `channels.matrix.accounts.<id>.proxy` 覆盖它。
- `channels.matrix.network.dangerouslyAllowPrivateNetwork` 允许私有/内部 homeserver。`proxy` 和此网络选择加入是相互独立的控制项。
- `channels.matrix.defaultAccount` 会在多账户设置中选择首选账户。
- `channels.matrix.autoJoin` 默认为 `off`，因此受邀房间和新的私信风格邀请会被忽略，直到你设置带 `autoJoinAllowlist` 的 `autoJoin: "allowlist"` 或 `autoJoin: "always"`。
- `channels.matrix.execApprovals`：Matrix 原生 exec 审批投递和审批者授权。
-  - `enabled`：`true`、`false` 或 `"auto"`（默认）。在自动模式下，当可从 `approvers` 或 `commands.ownerAllowFrom` 解析审批者时，exec 审批会激活。
-  - `approvers`：允许批准 exec 请求的 Matrix 用户 ID（例如 `@owner:example.org`）。
-  - `agentFilter`：可选的智能体 ID 允许列表。省略则转发所有智能体的审批。
-  - `sessionFilter`：可选的会话键模式（子字符串或正则表达式）。
+- `channels.matrix.proxy` 会通过显式 HTTP(S) 代理路由 Matrix HTTP 流量。命名账户可使用 `channels.matrix.accounts.<id>.proxy` 覆盖它。
+- `channels.matrix.network.dangerouslyAllowPrivateNetwork` 允许私有/内部 homeserver。`proxy` 和此网络选择加入是彼此独立的控制项。
+- `channels.matrix.defaultAccount` 在多账户设置中选择首选账户。
+- `channels.matrix.autoJoin` 默认为 `off`，因此受邀房间和新的私信式邀请会被忽略，直到你设置 `autoJoin: "allowlist"` 并配置 `autoJoinAllowlist`，或设置 `autoJoin: "always"`。
+- `channels.matrix.execApprovals`：Matrix 原生 exec 审批投递和审批人授权。
+  - `enabled`：`true`、`false` 或 `"auto"`（默认）。在自动模式下，当可以从 `approvers` 或 `commands.ownerAllowFrom` 解析审批人时，exec 审批会激活。
+  - `approvers`：允许审批 exec 请求的 Matrix 用户 ID（例如 `@owner:example.org`）。
+  - `agentFilter`：可选智能体 ID 允许列表。省略则转发所有智能体的审批。
+  - `sessionFilter`：可选会话键模式（子字符串或正则表达式）。
  - `target`：发送审批提示的位置。`"dm"`（默认）、`"channel"`（来源房间）或 `"both"`。
  - 按账户覆盖：`channels.matrix.accounts.<id>.execApprovals`。
 - `channels.matrix.dm.sessionScope` 控制 Matrix 私信如何分组为会话：`per-user`（默认）按路由后的对等方共享，而 `per-room` 会隔离每个私信房间。
- Matrix Status 探测和实时目录查找使用与运行时流量相同的代理策略。
- 完整的 Matrix 配置、目标规则和设置示例记录在 [Matrix](/zh-CN/channels/matrix)。
+- Matrix Status 探针和实时目录查找使用与运行时流量相同的代理策略。
+- 完整的 Matrix 配置、目标选择规则和设置示例记录在 [Matrix](/zh-CN/channels/matrix) 中。

 ### Microsoft Teams

@ -692,7 +705,7 @@ Microsoft Teams 由插件支持，并在 `channels.msteams` 下配置。
 ```

 - 此处涵盖的核心键路径：`channels.msteams`、`channels.msteams.configWrites`。
- 完整的 Teams 配置（凭据、webhook、私信/群组策略、按团队/按频道覆盖）记录在 [Microsoft Teams](/zh-CN/channels/msteams)。
+- 完整的 Teams 配置（凭据、webhook、私信/群组策略、按团队/按渠道覆盖）记录在 [Microsoft Teams](/zh-CN/channels/msteams) 中。

 ### IRC

@ -718,8 +731,8 @@ IRC 由插件支持，并在 `channels.irc` 下配置。
 ```

 - 此处涵盖的核心键路径：`channels.irc`、`channels.irc.dmPolicy`、`channels.irc.configWrites`、`channels.irc.nickserv.*`。
- 可选的 `channels.irc.defaultAccount` 会在匹配已配置账户 ID 时覆盖默认账户选择。
- 完整的 IRC 渠道配置（主机/端口/TLS/频道/允许列表/提及门控）记录在 [IRC](/zh-CN/channels/irc)。
+- 可选的 `channels.irc.defaultAccount` 在匹配已配置账户 ID 时会覆盖默认账户选择。
+- 完整的 IRC 渠道配置（主机/端口/TLS/渠道/允许列表/提及门控）记录在 [IRC](/zh-CN/channels/irc) 中。

 ### 多账户（所有渠道）

@ -745,33 +758,33 @@ IRC 由插件支持，并在 `channels.irc` 下配置。
 ```

 - 省略 `accountId` 时会使用 `default`（CLI + 路由）。
- 环境变量令牌只应用于**默认**账户。
+- 环境令牌只适用于**默认**账户。
 - 基础渠道设置会应用于所有账户，除非按账户覆盖。
 - 使用 `bindings[].match.accountId` 将每个账户路由到不同的智能体。
- 如果你在仍使用单账户顶层渠道配置时，通过 `openclaw channels add`（或渠道新手引导）添加非默认账户，OpenClaw 会先将账户范围的顶层单账户值提升到渠道账户映射中，让原始账户继续工作。大多数渠道会将它们移动到 `channels.<channel>.accounts.default`；Matrix 可以改为保留现有的匹配具名/默认目标。
- 现有仅渠道绑定（没有 `accountId`）会继续匹配默认账户；账户范围绑定仍然是可选的。
- `openclaw doctor --fix` 也会通过将账户范围的顶层单账户值移动到为该渠道选择的提升账户来修复混合形态。大多数渠道使用 `accounts.default`；Matrix 可以改为保留现有的匹配具名/默认目标。
+- 如果你通过 `openclaw channels add`（或渠道新手引导）添加非默认账户，同时仍在使用单账户顶层渠道配置，OpenClaw 会先将账户范围的顶层单账户值提升到渠道账户映射中，让原始账户继续工作。大多数渠道会将它们移入 `channels.<channel>.accounts.default`；Matrix 则可以保留现有匹配的命名/默认目标。
+- 现有仅渠道绑定（没有 `accountId`）会继续匹配默认账户；账户范围绑定仍是可选的。
+- `openclaw doctor --fix` 也会通过将账户范围的顶层单账户值移动到为该渠道选择的已提升账户中，修复混合形状。大多数渠道使用 `accounts.default`；Matrix 则可以保留现有匹配的命名/默认目标。

 ### 其他插件渠道

-许多插件渠道配置为 `channels.<id>`，并记录在其专用渠道页面中（例如 Feishu、Matrix、LINE、Nostr、Zalo、Nextcloud Talk、Synology Chat 和 Twitch）。
-查看完整渠道索引：[渠道](/zh-CN/channels)。
+许多插件渠道配置为 `channels.<id>`，并在各自专用的渠道页面中记录（例如 Feishu、Matrix、LINE、Nostr、Zalo、Nextcloud Talk、Synology Chat 和 Twitch）。
+请查看完整渠道索引：[Channels](/zh-CN/channels)。

 ### 群聊提及门控

-群组消息默认**需要提及**（元数据提及或安全正则表达式模式）。适用于 WhatsApp、Telegram、Discord、Google Chat 和 iMessage 群聊。
+群组消息默认**要求提及**（元数据提及或安全的正则表达式模式）。适用于 WhatsApp、Telegram、Discord、Google Chat 和 iMessage 群聊。

-可见回复单独控制。群组/频道房间默认为 `messages.groupChat.visibleReplies: "message_tool"`：OpenClaw 仍会处理该轮次，但普通最终回复保持私密，可见房间输出需要 `message(action=send)`。仅当你想要旧行为，也就是普通回复会发布回房间时，才设置为 `"automatic"`。如果也要对直接聊天应用相同的仅工具可见回复行为，请设置 `messages.visibleReplies: "message_tool"`。
+可见回复由单独的设置控制。群组/渠道房间默认为 `messages.groupChat.visibleReplies: "message_tool"`：OpenClaw 仍会处理该轮对话，但普通最终回复会保持私密，而可见的房间输出需要 `message(action=send)`。仅当你希望使用旧版行为，即普通回复被发回房间时，才设置为 `"automatic"`。若要将同样的仅工具可见回复行为也应用到直接聊天，请设置 `messages.visibleReplies: "message_tool"`。

-如果消息工具在当前工具策略下不可用，OpenClaw 会回退到自动可见回复，而不是静默抑制响应。`openclaw doctor` 会对此不匹配发出警告。
+如果消息工具在当前活跃的工具策略下不可用，OpenClaw 会回退到自动可见回复，而不是静默抑制响应。`openclaw doctor` 会对此不匹配发出警告。

-Gateway 网关会在文件保存后热重载 `messages` 配置。仅当部署中禁用文件监听或配置重载时才需要重启。
+文件保存后，Gateway 网关会热重载 `messages` 配置。只有在部署中禁用文件监听或配置重载时才需要重启。

 **提及类型：**

- **元数据提及**：原生平台 @ 提及。在 WhatsApp 自聊模式中会被忽略。
+- **元数据提及**：原生平台 @-mentions。在 WhatsApp 自聊模式中会被忽略。
 - **文本模式**：`agents.list[].groupChat.mentionPatterns` 中的安全正则表达式模式。无效模式和不安全的嵌套重复会被忽略。
- 仅在可以检测时（原生提及或至少一个模式）强制执行提及门控。
+- 仅当可以检测时（原生提及或至少一个模式），才会强制执行提及门控。

 ```json5
 {
@ -788,9 +801,9 @@ Gateway 网关会在文件保存后热重载 `messages` 配置。仅当部署中
 }
 ```

-`messages.groupChat.historyLimit` 设置全局默认值。渠道可以用 `channels.<channel>.historyLimit`（或按账户）覆盖。设置为 `0` 可禁用。
+`messages.groupChat.historyLimit` 设置全局默认值。渠道可以用 `channels.<channel>.historyLimit`（或按账号）覆盖。设为 `0` 可禁用。

-`messages.visibleReplies` 是全局来源轮次默认值；`messages.groupChat.visibleReplies` 会为群组/频道来源轮次覆盖它。渠道允许列表和提及门控仍会决定是否处理某个轮次。
+`messages.visibleReplies` 是全局来源轮次默认值；`messages.groupChat.visibleReplies` 会为群组/渠道来源轮次覆盖它。渠道允许列表和提及门控仍会决定是否处理某个轮次。

 #### 私信历史限制

@ -861,32 +874,32 @@ Gateway 网关会在文件保存后热重载 `messages` 配置。仅当部署中
 }
 ```

-<Accordion title="命令详情">
+<Accordion title="Command details">

- 此块配置命令入口。当前内置 + 捆绑命令目录见[斜杠命令](/zh-CN/tools/slash-commands)。
- 本页面是**配置键参考**，不是完整命令目录。渠道/插件拥有的命令，例如 QQ Bot `/bot-ping` `/bot-help` `/bot-logs`、LINE `/card`、设备配对 `/pair`、记忆 `/dreaming`、手机控制 `/phone` 和 Talk `/voice`，记录在各自的渠道/插件页面以及[斜杠命令](/zh-CN/tools/slash-commands)中。
- 文本命令必须是以 `/` 开头的**独立**消息。
- `native: "auto"` 会为 Discord/Telegram 启用原生命令，Slack 保持关闭。
- `nativeSkills: "auto"` 会为 Discord/Telegram 启用原生 Skills 命令，Slack 保持关闭。
- 按渠道覆盖：`channels.discord.commands.native`（布尔值或 `"auto"`）。`false` 会清除此前注册的命令。
- 使用 `channels.<provider>.commands.nativeSkills` 按渠道覆盖原生 Skills 注册。
+- 此块配置命令表面。当前内置 + 捆绑命令目录见 [Slash Commands](/zh-CN/tools/slash-commands)。
+- 本页是**配置键参考**，不是完整命令目录。由渠道/插件拥有的命令，例如 QQ Bot `/bot-ping` `/bot-help` `/bot-logs`、LINE `/card`、设备配对 `/pair`、记忆 `/dreaming`、手机控制 `/phone` 和 Talk `/voice`，记录在各自的渠道/插件页面以及 [Slash Commands](/zh-CN/tools/slash-commands) 中。
+- 文本命令必须是带前导 `/` 的**独立**消息。
+- `native: "auto"` 会为 Discord/Telegram 启用原生命令，并让 Slack 保持关闭。
+- `nativeSkills: "auto"` 会为 Discord/Telegram 启用原生 Skills 命令，并让 Slack 保持关闭。
+- 按渠道覆盖：`channels.discord.commands.native`（布尔值或 `"auto"`）。`false` 会清除之前注册的命令。
+- 用 `channels.<provider>.commands.nativeSkills` 按渠道覆盖原生 Skills 注册。
 - `channels.telegram.customCommands` 会添加额外的 Telegram 机器人菜单项。
- `bash: true` 为宿主 shell 启用 `! <cmd>`。需要 `tools.elevated.enabled`，且发送者在 `tools.elevated.allowFrom.<channel>` 中。
- `config: true` 启用 `/config`（读取/写入 `openclaw.json`）。对于 Gateway 网关 `chat.send` 客户端，持久化 `/config set|unset` 写入还需要 `operator.admin`；只读 `/config show` 仍可供普通写作用域的操作方客户端使用。
- `mcp: true` 为 `mcp.servers` 下由 OpenClaw 管理的 MCP 服务器配置启用 `/mcp`。
- `plugins: true` 为插件发现、安装以及启用/禁用控制启用 `/plugins`。
- `channels.<provider>.configWrites` 按渠道限制配置变更（默认：true）。
- 对于多账号渠道，`channels.<provider>.accounts.<id>.configWrites` 也会限制针对该账号的写入（例如 `/allowlist --config --account <id>` 或 `/config set channels.<provider>.accounts.<id>...`）。
+- `bash: true` 会为主机 shell 启用 `! <cmd>`。需要 `tools.elevated.enabled`，且发送者在 `tools.elevated.allowFrom.<channel>` 中。
+- `config: true` 会启用 `/config`（读取/写入 `openclaw.json`）。对于 Gateway 网关 `chat.send` 客户端，持久化 `/config set|unset` 写入还需要 `operator.admin`；只读 `/config show` 仍可供普通写入范围的操作员客户端使用。
+- `mcp: true` 会为 `mcp.servers` 下由 OpenClaw 管理的 MCP 服务器配置启用 `/mcp`。
+- `plugins: true` 会为插件发现、安装和启用/禁用控制启用 `/plugins`。
+- `channels.<provider>.configWrites` 会按渠道管控配置变更（默认值：true）。
+- 对于多账号渠道，`channels.<provider>.accounts.<id>.configWrites` 也会管控面向该账号的写入（例如 `/allowlist --config --account <id>` 或 `/config set channels.<provider>.accounts.<id>...`）。
 - `restart: false` 会禁用 `/restart` 和 Gateway 网关重启工具操作。默认值：`true`。
- `ownerAllowFrom` 是仅限所有者命令/工具的显式所有者允许列表。它独立于 `allowFrom`。
- `ownerDisplay: "hash"` 会在系统提示词中对所有者 ID 做哈希处理。设置 `ownerDisplaySecret` 可控制哈希。
- `allowFrom` 按提供商设置。设置后，它是**唯一**授权来源（渠道允许列表/配对和 `useAccessGroups` 会被忽略）。
+- `ownerAllowFrom` 是仅所有者命令/工具的显式所有者允许列表。它与 `allowFrom` 分离。
+- `ownerDisplay: "hash"` 会在系统提示中哈希所有者 ID。设置 `ownerDisplaySecret` 可控制哈希。
+- `allowFrom` 按提供商配置。设置后，它是**唯一**授权来源（渠道允许列表/配对和 `useAccessGroups` 都会被忽略）。
 - 当未设置 `allowFrom` 时，`useAccessGroups: false` 允许命令绕过访问组策略。
 - 命令文档映射：
-  - 内置 + 捆绑目录：[斜杠命令](/zh-CN/tools/slash-commands)
-  - 渠道特定命令入口：[渠道](/zh-CN/channels)
+  - 内置 + 捆绑目录：[Slash Commands](/zh-CN/tools/slash-commands)
+  - 渠道特定命令表面：[Channels](/zh-CN/channels)
  - QQ Bot 命令：[QQ Bot](/zh-CN/channels/qqbot)
-  - 配对命令：[配对](/zh-CN/channels/pairing)
+  - 配对命令：[Pairing](/zh-CN/channels/pairing)
  - LINE 卡片命令：[LINE](/zh-CN/channels/line)
  - 记忆 Dreaming：[Dreaming](/zh-CN/concepts/dreaming)

@ -894,7 +907,7 @@ Gateway 网关会在文件保存后热重载 `messages` 配置。仅当部署中

 ---

-## 相关
+## 相关内容

 - [配置参考](/zh-CN/gateway/configuration-reference) — 顶层键
 - [配置 — 智能体](/zh-CN/gateway/config-agents)