Zalo是越南最广泛使用的即时通讯应用，拥有超过七千万用户，是越南市场不可或缺的沟通渠道。OpenClaw通过插件系统支持Zalo Official Account（OA）的接入，让你可以为越南用户提供AI驱动的智能客服和自动化服务。
前置准备
在开始配置之前，需要准备以下内容：
- OpenClaw实例已部署并正常运行
- 一个Zalo Official Account（需在Zalo OA管理平台注册）
- Zalo OA的App ID和Secret Key
- 一个公网可访问的webhook回调地址
创建Zalo Official Account
如果你还没有Zalo OA，需要先在 oa.zalo.me 注册创建。Zalo OA分为多种类型，对于AI机器人场景，创建一个普通的OA即可。注册时需要提供企业信息和联系方式。
创建完成后，进入OA管理后台的「设置」>「开发者」页面，可以找到App ID和Secret Key。同时需要在此页面配置webhook URL和订阅相关事件。
配置Zalo开发者设置
在Zalo OA的开发者设置中，你需要完成以下操作：
配置Webhook URL：将回调地址设置为OpenClaw实例的Zalo endpoint，格式为 https://your-domain.com/webhooks/zalo。
订阅事件：勾选「用户发送消息」事件类型，这样当用户向OA发送消息时，Zalo会将消息转发到你的webhook地址。
获取OA Access Token：通过OAuth流程获取长期有效的Access Token。Zalo的Access Token有有效期，需要定期使用Refresh Token刷新。OpenClaw的Zalo插件内置了Token自动刷新机制。
安装Zalo插件
通过OpenClaw插件系统安装：
openclaw plugin install zalo
使用交互式命令配置：
openclaw channels login zalo
按提示输入App ID、Secret Key和Access Token。
配置openclaw.json
手动配置方式：
{
"channels": {
"zalo": {
"enabled": true,
"appId": "your-app-id",
"secretKey": "your-secret-key",
"accessToken": "your-access-token",
"refreshToken": "your-refresh-token"
}
}
}
配置Refresh Token后，OpenClaw会在Access Token过期前自动使用Refresh Token获取新的令牌，确保服务不中断。
消息类型处理
Zalo OA支持多种消息类型。OpenClaw的Zalo插件可以处理以下类型的入站消息：
- 文本消息：最基本的交互方式，用户发送文字，AI回复文字
- 图片消息：用户发送的图片会被转换为描述文本或传递给多模态AI模型处理
- 贴纸和表情：这类消息通常会被忽略，不会触发AI回复
对于出站回复，插件主要使用文本消息格式。如果AI的回复中包含图片链接，可以配置为以图片消息格式发送。
Zalo OA的消息规则
Zalo对OA发送消息有一些重要的限制规则：
OA只能在用户主动发送消息后的48小时内回复。超过48小时后，如果需要主动联系用户，需要使用「主动推送」配额（每月有限制）。OpenClaw会自动追踪每个用户的最后消息时间，在48小时窗口内正常回复，超出窗口时会记录警告日志。
此外，Zalo要求OA发送的消息内容遵守平台政策，不能包含违规内容。
安全配置
使用allowlist控制可交互的用户范围：
{
"channels": {
"zalo": {
"allowlist": ["user_id_1", "user_id_2"]
}
}
}
由于Zalo OA本身就是一个关注制的模式——用户需要先关注OA才能发送消息，所以已经有了一层天然的过滤。结合OpenClaw的allowlist和私信配对功能，可以进一步收紧访问控制。
越南市场注意事项
在为越南用户部署AI服务时，需要注意以下几点。首先，AI模型需要能够良好地处理越南语，包括带声调符号的文字。其次，越南用户习惯使用贴纸和表情包交流，Bot应该能优雅地处理这些非文本消息。最后，Zalo在越南的使用高峰时段主要集中在上午和晚间，建议在这些时段确保服务的稳定性。
多频道共存
Zalo频道可以与OpenClaw的所有其他频道同时运行。如果你的业务同时面向越南和国际市场，可以用Zalo服务越南本地用户，同时用WhatsApp、Telegram等服务国际用户。所有频道共享同一个AI模型后端和知识库配置，大大降低了运维复杂度。