From 24fcca87e639bdf57fecb2ba7427e8569379cc12 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 17:22:31 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/channels/zalouser.md | 78 ++++++++++++++++----------------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/docs/zh-CN/channels/zalouser.md b/docs/zh-CN/channels/zalouser.md index 1fddbd11e..03637f2bc 100644 --- a/docs/zh-CN/channels/zalouser.md +++ b/docs/zh-CN/channels/zalouser.md @@ -2,30 +2,28 @@ read_when: - 为 OpenClaw 设置 Zalo Personal - 调试 Zalo Personal 登录或消息流程 -summary: 通过原生 zca-js（二维码登录）提供 Zalo 个人账号支持、能力和配置 -title: Zalo 个人 +summary: 通过原生 zca-js（二维码登录）支持 Zalo 个人账号、能力和配置 +title: Zalo 个人版 x-i18n: - generated_at: "2026-05-02T21:57:11Z" + generated_at: "2026-05-04T17:22:02Z" model: gpt-5.5 provider: openai - source_hash: 0096775e0017e504130f2e19e05ab8114eadb873a9e11f79ea8f0dd91297567f + source_hash: 0f6d27f0ca502e6426abe21d609efd0a168a0b6b0fafe8d52d59f1a717da1ed5 source_path: channels/zalouser.md workflow: 16 --- -Status：实验性。此集成通过 OpenClaw 内部的原生 `zca-js` 自动化一个**个人 Zalo 账号**。 +Status：实验性。此集成通过 OpenClaw 内的原生 `zca-js` 自动化一个**个人 Zalo 账号**。 -这是一个非官方集成，可能导致账号被暂停或封禁。使用风险自负。 +这是非官方集成，可能导致账号被暂停或封禁。使用风险由你自行承担。 ## 内置插件 -Zalo Personal 在当前 OpenClaw 版本中作为内置插件提供，因此普通的 -打包构建不需要单独安装。 +Zalo Personal 在当前 OpenClaw 版本中作为内置插件提供，因此常规打包构建不需要单独安装。 -如果你使用的是较旧构建，或排除了 Zalo Personal 的自定义安装， -请直接安装 npm 包： +如果你使用的是较旧构建，或排除了 Zalo Personal 的自定义安装，请直接安装 npm 包： - 通过 CLI 安装：`openclaw plugins install @openclaw/zalouser` - 固定版本：`openclaw plugins install @openclaw/zalouser@2026.5.2` @@ -34,12 +32,12 @@ Zalo Personal 在当前 OpenClaw 版本中作为内置插件提供，因此普 不需要外部 `zca`/`openzca` CLI 二进制文件。 -## 快速设置（初学者） +## 快速设置（新手） 1. 确保 Zalo Personal 插件可用。 - - 当前打包的 OpenClaw 版本已内置该插件。 + - 当前打包版 OpenClaw 版本已经内置它。 - 较旧/自定义安装可以使用上面的命令手动添加。 -2. 登录（二维码，在 Gateway 网关机器上）： +2. 登录（QR，在 Gateway 网关机器上）： - `openclaw channels login --channel zalouser` - 使用 Zalo 移动应用扫描二维码。 3. 启用渠道： @@ -56,18 +54,18 @@ Zalo Personal 在当前 OpenClaw 版本中作为内置插件提供，因此普 ``` 4. 重启 Gateway 网关（或完成设置）。 -5. 私信访问默认采用配对；首次联系时批准配对代码。 +5. 私信访问默认使用配对；首次联系时批准配对代码。 ## 它是什么 - 完全通过 `zca-js` 在进程内运行。 -- 使用原生事件监听器接收入站消息。 -- 直接通过 JS API（文本/媒体/链接）发送回复。 -- 面向无法使用 Zalo Bot API 的“个人账号”使用场景而设计。 +- 使用原生事件监听器接收传入消息。 +- 直接通过 JS API 发送回复（文本/媒体/链接）。 +- 面向 Zalo Bot API 不可用的“个人账号”使用场景设计。 ## 命名 -渠道 ID 为 `zalouser`，用于明确表示这会自动化一个**个人 Zalo 用户账号**（非官方）。我们保留 `zalo`，用于未来可能的官方 Zalo API 集成。 +渠道 ID 是 `zalouser`，以明确表示它自动化的是一个**个人 Zalo 用户账号**（非官方）。我们保留 `zalo`，用于将来可能出现的官方 Zalo API 集成。 ## 查找 ID（目录） @@ -88,7 +86,9 @@ openclaw directory groups list --channel zalouser --query "work" `channels.zalouser.dmPolicy` 支持：`pairing | allowlist | open | disabled`（默认：`pairing`）。 -`channels.zalouser.allowFrom` 接受用户 ID 或名称。设置期间，会使用插件的进程内联系人查找将名称解析为 ID。 +`channels.zalouser.allowFrom` 应使用稳定的 Zalo 用户 ID。在交互式设置期间，输入的名称可以通过插件的进程内联系人查找解析为 ID。 + +如果配置中仍保留原始名称，启动时只有在启用 `channels.zalouser.dangerouslyAllowNameMatching: true` 后才会解析它。如果没有此选择加入，运行时发送者检查仅使用 ID，原始名称会被忽略，不用于授权。 通过以下命令批准： @@ -97,18 +97,18 @@ openclaw directory groups list --channel zalouser --query "work" ## 群组访问（可选） -- 默认：`channels.zalouser.groupPolicy = "open"`（允许群组）。未设置时，使用 `channels.defaults.groupPolicy` 覆盖默认值。 +- 默认：`channels.zalouser.groupPolicy = "open"`（允许群组）。使用 `channels.defaults.groupPolicy` 覆盖未设置时的默认值。 - 使用以下配置限制为允许列表： - `channels.zalouser.groupPolicy = "allowlist"` - - `channels.zalouser.groups`（键应为稳定的群组 ID；启动时会尽可能将名称解析为 ID） - - `channels.zalouser.groupAllowFrom`（控制允许的群组中哪些发送者可以触发机器人） + - `channels.zalouser.groups`（键应为稳定的群组 ID；只有在启用 `channels.zalouser.dangerouslyAllowNameMatching: true` 时，名称才会在启动时解析为 ID） + - `channels.zalouser.groupAllowFrom`（控制允许的群组中哪些发送者可以触发 bot） - 阻止所有群组：`channels.zalouser.groupPolicy = "disabled"`。 - 配置向导可以提示输入群组允许列表。 -- 启动时，OpenClaw 会将允许列表中的群组/用户名称解析为 ID，并记录映射。 -- 群组允许列表匹配默认仅按 ID 进行。未解析的名称不会用于认证，除非启用 `channels.zalouser.dangerouslyAllowNameMatching: true`。 -- `channels.zalouser.dangerouslyAllowNameMatching: true` 是一种应急兼容模式，会重新启用可变群组名称匹配。 +- 启动时，只有在启用 `channels.zalouser.dangerouslyAllowNameMatching: true` 时，OpenClaw 才会将允许列表中的群组/用户名称解析为 ID 并记录映射。 +- 默认情况下，群组允许列表匹配仅使用 ID。除非启用 `channels.zalouser.dangerouslyAllowNameMatching: true`，否则未解析的名称会被忽略，不用于身份验证。 +- `channels.zalouser.dangerouslyAllowNameMatching: true` 是一种应急兼容模式，会重新启用可变的启动时名称解析和运行时群组名称匹配。 - 如果未设置 `groupAllowFrom`，运行时会回退到 `allowFrom` 进行群组发送者检查。 -- 发送者检查同时适用于普通群组消息和控制命令（例如 `/new`、`/reset`）。 +- 发送者检查同时适用于普通群组消息和控制命令（例如 `/new`）。 示例： @@ -132,10 +132,10 @@ openclaw directory groups list --channel zalouser --query "work" - `channels.zalouser.groups..requireMention` 控制群组回复是否需要提及。 - 解析顺序：精确群组 ID/名称 -> 规范化群组 slug -> `*` -> 默认值（`true`）。 - 这同时适用于允许列表群组和开放群组模式。 -- 引用机器人消息会被视为用于群组激活的隐式提及。 +- 引用一条 bot 消息会算作群组激活的隐式提及。 - 已授权的控制命令（例如 `/new`）可以绕过提及门控。 - 当群组消息因需要提及而被跳过时，OpenClaw 会将其存储为待处理群组历史，并在下一条被处理的群组消息中包含它。 -- 群组历史限制默认使用 `messages.groupChat.historyLimit`（回退值为 `50`）。你可以使用 `channels.zalouser.historyLimit` 按账号覆盖。 +- 群组历史限制默认使用 `messages.groupChat.historyLimit`（回退值为 `50`）。你可以用 `channels.zalouser.historyLimit` 按账号覆盖。 示例： @@ -171,34 +171,34 @@ openclaw directory groups list --channel zalouser --query "work" } ``` -## 输入状态、回应和送达确认 +## 正在输入、表情回应和送达确认 -- OpenClaw 会在分发回复前发送输入状态事件（尽力而为）。 -- 渠道操作中 `zalouser` 支持消息回应操作 `react`。 - - 使用 `remove: true` 从消息中移除特定回应表情。 - - 回应语义：[回应](/zh-CN/tools/reactions) -- 对于包含事件元数据的入站消息，OpenClaw 会发送已送达 + 已读确认（尽力而为）。 +- OpenClaw 会在分发回复前发送正在输入事件（尽力而为）。 +- 渠道操作中，`zalouser` 支持消息表情回应操作 `react`。 + - 使用 `remove: true` 从消息中移除特定表情回应 emoji。 + - 表情回应语义：[表情回应](/zh-CN/tools/reactions) +- 对于包含事件元数据的传入消息，OpenClaw 会发送已送达 + 已读确认（尽力而为）。 ## 故障排除 -**登录无法保持：** +**登录没有保持：** - `openclaw channels status --probe` - 重新登录：`openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser` **允许列表/群组名称未解析：** -- 在 `allowFrom`/`groupAllowFrom`/`groups` 中使用数字 ID，或使用精确的好友/群组名称。 +- 在 `allowFrom`/`groupAllowFrom` 中使用数字 ID，并在 `groups` 中使用稳定的群组 ID。如果你确实需要精确的好友/群组名称，请启用 `channels.zalouser.dangerouslyAllowNameMatching: true`。 **从旧的基于 CLI 的设置升级：** - 移除任何旧的外部 `zca` 进程假设。 - 该渠道现在完全在 OpenClaw 内运行，不需要外部 CLI 二进制文件。 -## 相关内容 +## 相关 -- [渠道概览](/zh-CN/channels) — 所有受支持的渠道 -- [配对](/zh-CN/channels/pairing) — 私信认证和配对流程 +- [渠道概览](/zh-CN/channels) — 所有支持的渠道 +- [配对](/zh-CN/channels/pairing) — 私信身份验证和配对流程 - [群组](/zh-CN/channels/groups) — 群聊行为和提及门控 - [渠道路由](/zh-CN/channels/channel-routing) — 消息的会话路由 - [安全](/zh-CN/gateway/security) — 访问模型和加固