个人号
它接的是你真人 Zalo 账号,不是官方 bot 身份。
Channels 导读
这个 channel 通过 zca-js 模拟个人 Zalo 账号收发消息,不是官方 Bot API。首次使用必须用手机 Zalo 扫二维码登录,登录后默认开启“配对模式”——对方发第一条消息时你要在后台批准配对码,否则消息进不来。
先讲这一页到底在解决什么
这个 channel 通过 zca-js 模拟个人 Zalo 账号收发消息,不是官方 Bot API。首次使用必须用手机 Zalo 扫二维码登录,登录后默认开启“配对模式”——对方发第一条消息时你要在后台批准配对码,否则消息进不来。
第一站
理解这一点,后面很多设计就顺了。
它接的是你真人 Zalo 账号,不是官方 bot 身份。
官方明确写了 experimental,意思是“能用,但别把它当成铁板钉钉的正式通道”。
这不是吓人,是实话。因为它并不是 Zalo 官方公开鼓励的机器人接法。
zca-js这套集成是直接在进程里跑的,不需要额外安装外部 zca 命令行。
第二站
这部分最像真人值班交接,而不是传统 API 配 token。
openclaw plugins install @openclaw/zalouser先把这条个人号通道装上,不然系统连二维码登录窗口都不会给你。
openclaw channels login --channel zalouser这句像对门卫说“请把二维码登录机推出来”。
接着你要拿 Zalo 手机 App 扫码,就像把真人账号授权给 OpenClaw 临时代班。
enabled: true扫码后还要把通道开关拨到开启,不然只是登录成功,还没正式营业。
第三站
因为个人号聊天里,很多时候你得先知道目标是谁,才能更稳地发消息和设规则。
openclaw directory self --channel zalouser像先照镜子,看看“我自己这个账号现在是谁”。
directory peers list --query "name"像翻联系人名册,从一堆人里找出你要的那位。
directory groups list --query "work"像翻群聊花名册,把工作群、家人群这些房间号查出来。
因为后面的允许名单、定向发信、群操作,最好都用 ID,不要只靠模糊名字猜。
第四站
既然是真人账号代班,就更不应该一上来就完全敞开。
dmPolicy: "pairing"陌生人先领配对码,再决定要不要放行。这是最稳的默认门卫模式。
allowFrom这里可以放用户 ID 或名字。安装时插件会尽量帮你把名字认成 ID。
openclaw pairing list zalouser这句像打开审批册,看看最近有哪些人正等着进门。
openclaw pairing approve zalouser <code>这句像在门卫本上盖一个“准入”章,把某个配对码正式放行。
第五站
如果你能走官方 bot 路线,通常还是优先看 /channels/zalo。这页更像没有官方门票时的替代通道。