chore(i18n): refresh zh-CN translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-04 17:22:31 +00:00
parent ac97da9b34
commit 24fcca87e6

View File

@ -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 账号**。
<Warning>
这是一个非官方集成,可能导致账号被暂停或封禁。使用风险自负
这是非官方集成,可能导致账号被暂停或封禁。使用风险由你自行承担
</Warning>
## 内置插件
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.<group>.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) — 访问模型和加固