💬

Zalo 集成

将 OpenClaw 连接到 Zalo，让您的 AI 助手即时响应消息。

简要说明

✓ 前置条件：Node.js 22+，已安装 OpenClaw
✓ 配置：在 openclaw.json 中添加 Zalo 配置
✓ 耗时：约 10 分钟
✓ 需要：Zalo 账号 + OA (官方账号)

前置条件

1.

已安装 OpenClaw

如果您还没有安装，请先按照安装指南操作。
2.

Zalo 官方账号 (OA)

您需要在 oa.zalo.me 创建 Zalo 官方账号。
3.

Zalo API 凭据

从 Zalo OA 管理后台获取您的 OA ID 和 API 密钥。

设置步骤

步骤 1：创建 Zalo 官方账号

如果您还没有 OA：

访问 oa.zalo.me
注册官方账号（按照向导操作）
验证您的账号
从管理后台获取您的 OA ID

步骤 2：配置 openclaw.json

将 Zalo 配置添加到您的 openclaw.json 文件中：

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "您的_oa_id",
      "apiKey": "您的_api_key",
      "allowFrom": ["*"]
    }
  }
}

步骤 3：启动 OpenClaw

启动启用 Zalo 的 OpenClaw：

openclaw start

机器人将连接到 Zalo 并准备好接收消息。

步骤 4：测试您的 AI 助手

打开 Zalo 并搜索您的官方账号：

打开 Zalo 应用
搜索您的 OA 名称
发送消息开始对话

🎉 连接成功！您的 Zalo AI 助手已准备就绪。

高级配置

允许特定用户

限制谁可以与您的 AI 助手交互：

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "您的_oa_id",
      "apiKey": "您的_api_key",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Webhook 配置

对于高级功能，请在 Zalo OA 管理后台配置 webhook：

进入 OA 管理后台 → 高级设置 → Webhook
将 webhook URL 设置为您的 OpenClaw 服务器
启用您想要接收的事件

故障排除

API 密钥无效？

检查 Zalo OA 管理后台中的 API 密钥。确保您的账号已启用 API。

消息未收到？

验证您的 openclaw.json 中 Zalo 频道的 "enabled" 设置为 true，并检查日志。

OA 未找到？

确保您的官方账号已验证并处于活跃状态。新 OA 可能需要先审批。