Channels 导读

用个人 Zalo 账号做自动化,先扫二维码登录

这个 channel 通过 zca-js 模拟个人 Zalo 账号收发消息,不是官方 Bot API。首次使用必须用手机 Zalo 扫二维码登录,登录后默认开启“配对模式”——对方发第一条消息时你要在后台批准配对码,否则消息进不来。

先讲这一页到底在解决什么

用个人 Zalo 账号做自动化,先扫二维码登录

这个 channel 通过 zca-js 模拟个人 Zalo 账号收发消息,不是官方 Bot API。首次使用必须用手机 Zalo 扫二维码登录,登录后默认开启“配对模式”——对方发第一条消息时你要在后台批准配对码,否则消息进不来。

原文共 15 节,先看 Start Here 路径:/channels/zalouser 查看官方原文

第一站

⚠️ 先记住:这不是“官方机器人”,而是“让程序代替真人账号值班”

理解这一点,后面很多设计就顺了。

👤

个人号

它接的是你真人 Zalo 账号,不是官方 bot 身份。

🧪

实验性

官方明确写了 experimental,意思是“能用,但别把它当成铁板钉钉的正式通道”。

🚫

封号风险

这不是吓人,是实话。因为它并不是 Zalo 官方公开鼓励的机器人接法。

🧠

zca-js

这套集成是直接在进程里跑的,不需要额外安装外部 zca 命令行。

第二站

🪪 真正的登录动作,是“在 Gateway 那台机器上弹出二维码,再拿手机扫一下”

这部分最像真人值班交接,而不是传统 API 配 token。

openclaw plugins install @openclaw/zalouser

先把这条个人号通道装上,不然系统连二维码登录窗口都不会给你。

openclaw channels login --channel zalouser

这句像对门卫说“请把二维码登录机推出来”。

扫码

接着你要拿 Zalo 手机 App 扫码,就像把真人账号授权给 OpenClaw 临时代班。

enabled: true

扫码后还要把通道开关拨到开启,不然只是登录成功,还没正式营业。

第三站

📚 这页里最有用的几句命令,其实是在帮你“查这个人、这个群,到底对应哪个 ID”

因为个人号聊天里,很多时候你得先知道目标是谁,才能更稳地发消息和设规则。

openclaw directory self --channel zalouser

像先照镜子,看看“我自己这个账号现在是谁”。

directory peers list --query "name"

像翻联系人名册,从一堆人里找出你要的那位。

directory groups list --query "work"

像翻群聊花名册,把工作群、家人群这些房间号查出来。

为什么要查

因为后面的允许名单、定向发信、群操作,最好都用 ID,不要只靠模糊名字猜。

第四站

🎟️ 默认也是 pairing,这说明官方很清楚:个人号更该先守门

既然是真人账号代班,就更不应该一上来就完全敞开。

dmPolicy: "pairing"

陌生人先领配对码,再决定要不要放行。这是最稳的默认门卫模式。

allowFrom

这里可以放用户 ID 或名字。安装时插件会尽量帮你把名字认成 ID。

openclaw pairing list zalouser

这句像打开审批册,看看最近有哪些人正等着进门。

openclaw pairing approve zalouser <code>

这句像在门卫本上盖一个“准入”章,把某个配对码正式放行。

第五站

🎈 最后记一句:这条路适合“我只能用个人号”,不适合“我想找最稳最官方的方案”

如果你能走官方 bot 路线,通常还是优先看 /channels/zalo。这页更像没有官方门票时的替代通道。