OpenClaw 通过目录中列出的外部 @zalo-platforms/openclaw-zaloclawbot 插件连接到 Zalo ClawBot。登录使用 Zalo Mini App 二维码;配置中的插件 ID 为 openclaw-zaloclawbot。¶
Note
此插件的运行时完全位于外部 @zalo-platforms/openclaw-zaloclawbot 包中。本页面中除安装与配置之外的行为细节均依据插件维护者的说明,并未对照 OpenClaw 核心源码进行验证。
兼容性¶
| 插件版本 | OpenClaw 版本 | npm dist-tag | 状态 |
|---|---|---|---|
| 0.1.4 | >=2026.4.10 | latest |
活跃 / Beta |
前提条件¶
- Node.js >= 22
- 已安装 OpenClaw(
openclawCLI 可用) - 一台移动设备上的 Zalo 账号,用于扫描登录二维码
通过 onboard 安装(推荐)¶
从渠道菜单中选择 Zalo ClawBot。向导会从官方目录安装插件(已完成完整性校验),在终端中渲染登录二维码,当你用 Zalo 应用扫描后即完成渠道配置。
手动安装¶
要将渠道添加到已完成 onboard 的网关:
1. 安装插件¶
使用精确固定的版本号,以便 OpenClaw 在安装时对照目录完整性哈希校验该包。
2. 启用插件¶
登录前先查看应用结果。重新安装会保留你明确禁用的插件。
3. 生成二维码并登录¶
使用 Zalo 移动应用扫描终端中渲染的二维码,在 Zalo Mini App 内接受使用条款,并授权会话。
4. 验证渠道¶
如果 Gateway 处于离线状态,请将其启动。配置更改遵循热重载。如果运行中的渠道尚未载入已保存的登录信息,请运行 openclaw plugins reload openclaw-zaloclawbot,然后再次检查其状态。
工作原理¶
与标准 Zalo 渠道不同(后者要求注册你自己的 Zalo 官方账号(OA)并配置静态开发者凭据),Zalo ClawBot 是共享官方基础设施上的与所有者绑定的个人助手:
- 接入(Onboarding): 二维码解析到一个 Zalo Mini App,该应用会将共享官方 OA 下新建的私有机器人直接绑定到你的 Zalo 用户 ID。
- 所有者绑定隐私: 机器人仅与其所有者通信。来自其他用户的消息会在平台层被丢弃。
- 官方 API 路径: 插件使用 Zalo Bot Platform API,而非浏览器或 Web 会话自动化。
实现细节¶
插件通过持久的长轮询循环(getUpdates)与 Zalo 通信。对于本地桌面/终端网关运行,Webhook 在默认情况下处于禁用状态。消息在客户端处理并映射到你的本地 Agent 运行时。
插件在 OpenClaw 状态目录下管理机器人凭据。请将该目录视为敏感数据,并将其纳入与 OpenClaw 其他状态相同的访问控制和备份策略中。
故障排查¶
- 二维码登录超时: 出于安全考虑,登录令牌(
zbsk)会在 5 分钟后过期。如果二维码在扫描前已过期,请重新运行登录命令以生成新的二维码。 - Gateway 加载失败: 确认你的 OpenClaw 主机版本为
2026.4.10或更高。旧版本不支持此 ID 所需的外部 npm 插件安装账本。
相关链接¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw