@zalo-platforms/openclaw-zaloclawbot 插件连接到 Zalo ClawBot。登录使用 Zalo Mini App 二维码；配置中的插件 ID 是 openclaw-zaloclawbot。
兼容性
| 插件版本 | OpenClaw 版本 | npm dist-tag | 状态 |
|---|---|---|---|
| 0.1.4 | >=2026.4.10 | latest | 活跃 / Beta |
前置条件
- Node.js >= 22
- 已安装 OpenClaw（
openclawCLI 可用） - 移动设备上的 Zalo 账号，用于扫描登录二维码
使用 onboard 安装（推荐）
手动安装
要将该渠道添加到已完成新手引导的 Gateway 网关：1. 安装插件
2. 在配置中启用插件
3. 生成二维码并登录
4. 重启 Gateway 网关
工作原理
标准 Zalo 渠道需要注册你自己的 Zalo Official Account（OA）并配置静态开发者凭证；与之不同，Zalo ClawBot 是共享官方基础设施上的绑定所有者的个人助手：- **新手引导：**二维码会解析到一个 Zalo Mini App，它会在共享官方 OA 下预置一个新的私有 Bot，并直接绑定到你的 Zalo 用户 ID。
- **绑定所有者的隐私：**该 Bot 只与其所有者通信。来自其他用户的消息会在平台层被丢弃。
- **官方 API 路径：**该插件使用 Zalo Bot Platform API，而不是浏览器或 Web 会话自动化。
底层机制
该插件通过持久长轮询循环（getUpdates）与 Zalo 通信。对于本地桌面/终端 Gateway 网关运行，Webhooks 默认禁用。消息在客户端处理，并映射到你的本地 Agent Runtimes。
该插件在 OpenClaw 状态目录下管理 Bot 凭证。请将该目录视为敏感目录，并将其纳入与其余 OpenClaw 状态相同的访问控制和备份策略。
该插件的运行时完全位于外部 @zalo-platforms/openclaw-zaloclawbot 包中；下方安装/配置之外的行为细节来自插件维护者报告，尚未根据 OpenClaw 核心源代码验证。
故障排查
- **二维码登录超时：**出于安全原因，登录令牌（
zbsk）会在 5 分钟后过期。如果二维码在你扫描之前过期，请重新运行登录命令以生成新的二维码。 - **Gateway 网关加载失败：**确认你的 OpenClaw 主机版本为
2026.4.10或更高。旧版本不支持此 ID 所需的外部 npm 插件安装台账。