跳转至

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(openclaw CLI 可用)
  • 一台移动设备上的 Zalo 账号,用于扫描登录二维码
openclaw onboard

从渠道菜单中选择 Zalo ClawBot。向导会从官方目录安装插件(已完成完整性校验),在终端中渲染登录二维码,当你用 Zalo 应用扫描后即完成渠道配置。

手动安装

要将渠道添加到已完成 onboard 的网关:

1. 安装插件

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

使用精确固定的版本号,以便 OpenClaw 在安装时对照目录完整性哈希校验该包。

2. 启用插件

openclaw plugins enable openclaw-zaloclawbot

登录前先查看应用结果。重新安装会保留你明确禁用的插件。

3. 生成二维码并登录

openclaw channels login --channel openclaw-zaloclawbot

使用 Zalo 移动应用扫描终端中渲染的二维码,在 Zalo Mini App 内接受使用条款,并授权会话。

4. 验证渠道

openclaw channels status --probe

如果 Gateway 处于离线状态,请将其启动。配置更改遵循热重载。如果运行中的渠道尚未载入已保存的登录信息,请运行 openclaw plugins reload openclaw-zaloclawbot,然后再次检查其状态。

工作原理

与标准 Zalo 渠道不同(后者要求注册你自己的 Zalo 官方账号(OA)并配置静态开发者凭据),Zalo ClawBot 是共享官方基础设施上的与所有者绑定的个人助手:

  1. 接入(Onboarding): 二维码解析到一个 Zalo Mini App,该应用会将共享官方 OA 下新建的私有机器人直接绑定到你的 Zalo 用户 ID。
  2. 所有者绑定隐私: 机器人仅与其所有者通信。来自其他用户的消息会在平台层被丢弃。
  3. 官方 API 路径: 插件使用 Zalo Bot Platform API,而非浏览器或 Web 会话自动化。

实现细节

插件通过持久的长轮询循环(getUpdates)与 Zalo 通信。对于本地桌面/终端网关运行,Webhook 在默认情况下处于禁用状态。消息在客户端处理并映射到你的本地 Agent 运行时。

插件在 OpenClaw 状态目录下管理机器人凭据。请将该目录视为敏感数据,并将其纳入与 OpenClaw 其他状态相同的访问控制和备份策略中。

故障排查

  • 二维码登录超时: 出于安全考虑,登录令牌(zbsk)会在 5 分钟后过期。如果二维码在扫描前已过期,请重新运行登录命令以生成新的二维码。
  • Gateway 加载失败: 确认你的 OpenClaw 主机版本为 2026.4.10 或更高。旧版本不支持此 ID 所需的外部 npm 插件安装账本。
  • 渠道概览 - 所有受支持的渠道
  • Zalo - 内置的 Zalo Bot Creator / Marketplace 渠道
  • 配对 - DM 认证与配对流程
  • 插件 - 安装与管理插件

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw