pairing
第一次来的人先领配对码，等你审核过，再正式开始聊天。
Channels 导读
Zalo 接入：先拿 token，再配配对
这页教你让 OpenClaw 网关连上 Zalo Bot API，实现 1 对 1 消息收发。最要紧的是先拿到 bot token（格式是 numeric_id:secret），然后配好 dmPolicy（默认 pairing 模式需要用户首次发消息时确认配对）。注意 Zalo 官方账号（OA）的 bot 走的是另一套接口，别混用。
先讲这一页到底在解决什么
Zalo 接入：先拿 token，再配配对
这页教你让 OpenClaw 网关连上 Zalo Bot API，实现 1 对 1 消息收发。最要紧的是先拿到 bot token（格式是 numeric_id:secret），然后配好 dmPolicy（默认 pairing 模式需要用户首次发消息时确认配对）。注意 Zalo 官方账号（OA）的 bot 走的是另一套接口，别混用。
第一站
🧩 这条路走的是“机器人票务窗口”，先拿到那张 bot token
没有 token，OpenClaw 就像还没领工牌的机器人，站在门口也进不去。
openclaw plugins install @openclaw/zalo先把 Zalo 插件装上，相当于给机器人装会说 Zalo 的语言包。
bot.zaloplatforms.com
这里像机器人办证大厅。你在这里创建 bot，最后拿到那串 数字:密钥 的 token。
ZALO_BOT_TOKEN=...这像把工牌先揣进环境变量口袋里，给默认账号用最方便。
botToken: "123456:abc"这则是把工牌直接写进配置账本里，适合多账号管理时逐个登记。
第二站
🚪 默认的 dmPolicy: "pairing"，其实就是“陌生人先领一张配对号码牌”
它不是多此一举，而是在帮你挡住一上来就乱敲门的陌生流量。
DM 场景
现在主打的是 1 对 1 私聊，不是复杂群聊编排。
Deterministic routing
回信会老老实实回到原来的 Zalo 聊天里，不让模型自己乱挑渠道。
能力边界
官方也说得很直白：这页对应的是 Marketplace bot 的当前能力，不要自动脑补成 OA 那套。
第三站
📡 长轮询像机器人不断去前台问“有新纸条吗”，webhook 则像别人主动按门铃
Zalo 这页不是逼你一定开 webhook，它默认可以先靠轮询跑起来。
Long-polling
像机器人隔一会儿就去前台窗口探头问一句：“有没有新消息给我？”
channels.zalo.webhookUrl如果你要切 webhook，这就像给外界一个固定门铃地址，让消息自己敲门进来。
2000 字切块
Zalo 发长文有长度上限，所以 OpenClaw 会把太长的回复切成几段，不是一口气硬塞。
媒体大小上限
mediaMaxMb 像快递柜尺寸限制，超过默认 5MB 就装不进去。
第四站
🛠️ 这一页最实用的配置，其实就是“工牌放哪儿、陌生人怎么审、要不要多账号”
看起来字段多，但真正常用的就那几格。
accounts.default.botToken默认机器人账号的工牌。先把这个填对，整条路才能亮起来。
多账号
如果你有多个 bot，就在 accounts 下面一个个开小抽屉分别放 token。
重启 Gateway
填完 token 后要重启，就像把新领的工牌刷进门禁系统。
🎈 最后记一句
Zalo 这页的中心思想很简单：领工牌、开门、先配对、再私聊。