Zalo 频道

Zalo 是越南主流消息应用，其 Bot API 支持 1:1 对话。当前为实验性状态，支持私信（DM）。Marketplace bot 不支持群组。

安装

openclaw plugins install @openclaw/zalo

最小配置

{
  channels: {
    zalo: {
      enabled: true,
      accounts: {
        default: {
          botToken: "12345689:abc-xyz",
          dmPolicy: "pairing",
        },
      },
    },
  },
}

获取 Bot Token

访问 https://bot.zaloplatforms.com 创建 bot
复制完整 bot token（格式：numeric_id:secret）

环境变量

ZALO_BOT_TOKEN（仅默认账号）

访问控制

DM 策略：pairing（默认）| allowlist | open | disabled

openclaw pairing list zalo
openclaw pairing approve zalo <CODE>

allowFrom 接受数字用户 ID（无用户名查找）。

消息限制

出站文本分块：2000 字符（Zalo API 限制）
媒体上限：mediaMaxMb（默认 5MB）
流式输出默认禁用（2000 字符限制使流式意义不大）

长轮询 vs Webhook

默认：长轮询（无需公网 URL）

Webhook 模式：

{
  channels: {
    zalo: {
      webhookUrl: "https://gateway.example.com/zalo",  // 需 HTTPS
      webhookSecret: "8-256字符的密钥",
    },
  },
}

注意：长轮询和 webhook 互斥，不能同时使用。

功能支持（Marketplace bot）

功能	状态
私信	支持
群组	不可用
图片（入站）	有限/需验证
纯文本 URL	支持
链接预览	不稳定
表情反应	不支持
流式输出	受限（2000 字符）

多账号

{
  channels: {
    zalo: {
      accounts: {
        default: { botToken: "token-a", dmPolicy: "pairing" },
        support: { botToken: "token-b", dmPolicy: "allowlist" },
      },
    },
  },
}

Wiki AI

目录