Zalo

首先，Zalo 是一个在越南很流行的聊天软件，就像微信一样。这页说明书教你如何让你的机器人通过 Zalo 的“机器人接口”去和人们聊天。这个功能还在测试中，但已经可以一对一聊天，也能在群里聊天，不过群聊需要你设置一些规则。

第一步：安装 Zalo 小插件 你的机器人一开始没有 Zalo 这个功能，需要先安装一个叫“插件”的小工具。你可以把它想成给机器人装一个新玩具。

1. 打开电脑的命令行（一个可以打字下命令的黑窗口）。
2. 输入这个命令来安装：openclaw plugins install @openclaw/zalo
3. 或者，如果你在第一次设置机器人时，直接选择 Zalo 这个选项，然后同意安装也可以。

第二步：拿到机器人的秘密口令 要让机器人在 Zalo 里工作，需要一个秘密口令，就像进家门的钥匙。

1. 打开一个网站：https://bot.zaloplatforms.com，然后登录。
2. 创建一个新的机器人，并设置好。
3. 复制机器人给你的口令，它看起来像这样：12345689:abc-xyz。

第三步：告诉机器人这个口令 现在，要把这个口令交给你的机器人。有两种方法：

• 方法一（环境变量）：在启动机器人的地方，设置一个叫 ZALO_BOT_TOKEN 的东西，把口令填进去。
• 方法二（配置文件）：在一个叫 config 的文件里，找到 channels.zalo.botToken 这一行，把口令写在引号里。

第四步：重启机器人 告诉机器人新口令后，你需要重启它，就像给玩具换上新电池后要重新打开开关一样。重启后，Zalo 功能就启动了。

怎么开始聊天？ 默认情况下，当有陌生人第一次给你的机器人发消息时，机器人会给他一个“配对码”。陌生人需要把这个码给你，你在电脑上输入命令 openclaw pairing approve zalo <配对码> 来批准，之后他们才能和机器人聊天。这个码一小时后就会失效哦。

一些重要的规矩和提醒

• 消息长度：机器人一次只能发 2000 个字，如果话太长，它会分成几段发。
• 图片大小：收发的图片不能太大，默认最大是 5 MB。
• 群聊控制：机器人可以进群聊天，但默认是“安全模式”，只允许你指定的朋友在群里@它。你需要设置 channels.zalo.groupPolicy 和 channels.zalo.groupAllowFrom 来控制。
• 两种工作方式：机器人通常是自己不停地问 Zalo “有新消息吗？”（这叫“长轮询”）。你也可以设置一个网址（webhookUrl），让 Zalo 有新消息时主动推送给机器人，但这需要你的网址是 https 开头的，并且要设置一个 8 到 256 个字符长的密码（webhookSecret）。注意，这两种方式只能选一种用。
• 能做什么：可以收发文字和图片。不能发表情包（贴纸）、不能点赞（反应）、不能投票、也不能用流式的方式一口气说很长的话。

如果出了问题怎么办？

• 机器人不理人：检查口令对不对（用命令 openclaw channels status --probe），看看发消息的人是不是被你批准了，再看看机器人的日志（openclaw logs --follow）。
• 网址收不到消息：确保你的网址是 https 开头，密码长度对，并且没有同时使用“自己问”的方式。