Zalo ClawBot

OpenClaw 通过目录中列出的外部 @zalo-platforms/openclaw-zaloclawbot 插件连接到 Zalo ClawBot。登录使用 Zalo Mini App 二维码；配置中的插件 ID 为 openclaw-zaloclawbot。

兼容性¶

先决条件¶

• Node.js >= 22
• OpenClaw 已安装（openclaw CLI 可用）
• 移动设备上的 Zalo 账号，用于扫描登录二维码

使用 onboard 安装（推荐）¶

openclaw onboard

从频道菜单中选择 Zalo ClawBot。向导会从官方目录安装插件（经过完整性校验），在终端中渲染登录二维码，并在您使用 Zalo 应用扫描后完成频道配置。

手动安装¶

要将频道添加到已初始化的网关：

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 频道要求注册您自己的 Zalo 官方账号（OA）并配置静态开发者凭据，Zalo ClawBot 是共享官方基础设施上的绑定所有者的个人助理：

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

内部机制¶

该插件通过持久长轮询循环（getUpdates）与 Zalo 通信。对于本地桌面/终端网关运行，Webhooks 默认禁用。消息在客户端处理，并映射到您的本地代理运行时。

该插件在 OpenClaw 状态目录中管理机器人凭据。请将该目录视为敏感目录，并使其与 OpenClaw 状态的其他部分遵循相同的访问控制和备份策略。

故障排除¶

• 二维码登录超时： 出于安全考虑，登录令牌（zbsk）在 5 分钟后过期。如果二维码在您扫描前过期，请重新运行登录命令以生成新的二维码。
• Gateway 加载失败： 确认您的 OpenClaw 主机版本为 2026.4.10 或更高版本。旧版本不支持此 ID 所需的外部 npm 插件安装台账。

相关¶

• 频道概览 - 所有支持的频道
• Zalo - 内置的 Zalo Bot Creator / Marketplace 频道
• 配对 - DM 身份验证和配对流程
• 插件 - 安装和管理插件