Zalo 是越南用户数量最多的即时通讯应用， 月活用户超过 7500 万，覆盖越南 70% 以上的智能手机用户。 OpenClaw 提供两种 Zalo 接入方式，满足不同场景需求。
两种接入模式
模式一：Zalo Bot API（官方企业 Bot）
适合：企业客服、公开服务 Bot
要求：在 Zalo Bot 平台注册，需审核
能力：私信、群组消息（需用户关注 Bot）
模式二：Zalo Personal（个人账号 QR 登录）
适合：个人助手、小团队使用
要求：一个 Zalo 个人账号（手机号）
能力：私信、好友消息（接受好友申请）
安装 Zalo 插件
bash
# Zalo Bot API 插件
openclaw plugins install @openclaw/zalo
# Zalo Personal 插件（个人账号模式）
openclaw plugins install @openclaw/zalouser
# 或在交互式配置时选择 Zalo，确认安装提示
openclaw onboard模式一：Zalo Bot API 配置
第一步：创建 Zalo Bot
1. 访问 https://developers.zalo.me/
2. 登录 Zalo 开发者平台
3. 创建新应用 → 选择「Official Account」类型
4. 在「Permissions」中申请消息发送权限
5. 审核通过后，进入应用设置 → 获取 Bot Token
第二步：配置 OpenClaw
json
{
"channels": {
"zalo": {
"enabled": true,
"accounts": {
"default": {
"botToken": "your-zalo-bot-token",
"dmPolicy": "pairing"
}
}
}
}
}也可以通过环境变量配置：
bash
export ZALO_BOT_TOKEN="your-zalo-bot-token"消息接收方式
Long-polling（默认，适合大多数场景）：
json
{ "polling": true }OpenClaw 主动向 Zalo 服务器轮询新消息，无需公网 IP。
Webhook（实时推送，需要公网地址）：
json
{
"webhook": {
"enabled": true,
"path": "/api/channels/zalo/webhook",
"callbackUrl": "https://your-gateway.com/api/channels/zalo/webhook"
}
}模式二：Zalo Personal（个人账号）
使用普通 Zalo 账号，通过 QR 码扫描登录：
json
{
"channels": {
"zalouser": {
"enabled": true,
"dmPolicy": "pairing",
"sessionPath": "./data/zalo-session"
}
}
}启动 Gateway 时会显示 QR 码，用手机 Zalo 扫码登录：
bash
openclaw gateway start
# 控制台输出 QR 码
# 用 Zalo 手机 App 扫码
# 扫码成功后，OpenClaw 以该账号身份运行⚠️ 个人账号模式（Zalo Personal）目前为实验性功能， 遵守 Zalo 使用条款，避免高频自动消息。
DM 权限控制
json
{
"zalo": {
"dmPolicy": "pairing",
"accounts": {
"default": {
"dmPolicy": "allowlist",
"allowedIds": ["zalo-user-id-1", "zalo-user-id-2"]
}
}
}
}"pairing"：用户首次发消息需完成配对确认"allowlist"：只有 allowedIds 中的用户可发消息"open"：任何人可以发消息（慎用）
群组消息处理
Bot 被拉入 Zalo 群组后：
json
{
"groups": {
"my-group-id": {
"requireMention": true,
"respondToAll": false
}
}
}requireMention: true：只有 @ Bot 才会触发回复respondToAll: false：不响应所有群消息（推荐）
支持的消息类型
| 消息类型 | 接收 | 发送 |
|---|---|---|
| 文字消息 | ✅ | ✅ |
| 图片 | ✅ | ✅ |
| 文件 | ✅ | ✅ |
| 位置 | ✅ | ⚠️（部分支持） |
| 语音 | ✅ | ❌ |
| 贴纸 | ✅ | ❌ |
越南市场典型场景
场景一：企业客服 Bot
Zalo Official Account + OpenClaw
→ 用户关注公众号后可咨询产品/下单/查物流
场景二：团队内部助手
Zalo Personal 账号
→ 团队成员添加好友后直接使用 AI 助手
场景三：跨境电商助手
处理越南买家的 Zalo 咨询
→ AI 自动回复常见问题（越南语支持）
→ 复杂问题转人工
来源：OpenClaw 官方文档 - docs.openclaw.ai/channels/zalo