Zalo 是越南最流行的即时通讯应用，拥有超过 7000 万用户。OpenClaw 通过 Zalo Bot API 接入，支持私信和群组消息，适合面向越南用户的客服和通知场景。
状态：实验性支持。私信已稳定；群组功能可用但需要显式配置群组策略。
安装插件
bash
openclaw plugins install @openclaw/zalo或在 onboarding 时选择 Zalo，确认安装提示即可。
快速配置
第一步：获取 Bot Token
- 访问 Zalo Bot Platform 并登录
- 创建新 Bot，配置基本信息
- 复制 Bot Token（格式：
12345689:abc-xyz）
第二步：配置 OpenClaw
最简配置：
json
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz",
"dmPolicy": "pairing"
}
}
}或使用环境变量（仅默认账号）：
bash
export ZALO_BOT_TOKEN="12345689:abc-xyz"第三步：重启 Gateway
bash
openclaw gateway restartDM 访问默认使用配对模式，首次有用户联系时审批配对码即可正常使用。
消息接收方式
长轮询（默认，推荐）
Zalo Bot 默认使用长轮询方式接收消息：Gateway 主动向 Zalo 服务器发起请求，等待新消息返回。
优势：无需暴露公网 Webhook URL，适合内网或动态 IP 部署。
Webhook 模式
若需要更低延迟，也可以配置 Webhook：
json
{
"channels": {
"zalo": {
"botToken": "12345689:abc-xyz",
"webhook": {
"enabled": true,
"path": "/zalo-webhook"
}
}
}
}需要将 Webhook URL 在 Zalo Bot Platform 中注册，并确保 Gateway 可以从公网访问。
访问控制
私信（DM）
| 策略 | 说明 |
|---|---|
pairing | 默认，未知用户需配对 |
open | 允许所有用户 |
allowlist | 仅允许 allowFrom 中的用户 |
配对审批：
bash
openclaw pairing list zalo
openclaw pairing approve zalo <CODE>群组（Group）
群组默认采用 fail-closed allowlist 策略（不在白名单内的群组不响应）：
json
{
"channels": {
"zalo": {
"groupPolicy": "open",
"groups": {
"*": { "requireMention": true }
}
}
}
}支持的消息类型
接收：
- ✅ 文字消息
- ✅ 图片（作为占位符处理）
- ✅ 贴纸
- ✅ 文件附件
发送：
- ✅ 文字消息
- ✅ 图片（通过 URL）
- ✅ 文件（通过 URL）
- ❌ 语音消息
主动发送消息（CLI/Cron）
bash
# 发送到用户
openclaw message send --channel zalo --target <zalo-user-id> --text "Hello"
# 发送到群组
openclaw message send --channel zalo --target group:<group-id> --text "通知内容"多账号支持
json
{
"channels": {
"zalo": {
"accounts": {
"support": {
"botToken": "token-1",
"name": "客服 Bot"
},
"notifications": {
"botToken": "token-2",
"name": "通知 Bot"
}
}
}
}
}限制说明
- Zalo Bot API 限制每秒消息发送频率，高频场景需注意限速
- 群组中消息内容可能因隐私策略有所限制
- 实验性版本，部分边缘功能可能不稳定
原文：Zalo - OpenClaw | 来源：OpenClaw 官方文档