Zalo Personal

首先，你需要给你的电脑助手安装一个叫“Zalo Personal”的小工具，它就像一个特别的插件。安装方法是在电脑的命令行里输入 openclaw plugins install @openclaw/zalouser。如果你有这个小工具的源代码，也可以用 openclaw plugins install ./extensions/zalouser 来安装。装好之后，电脑助手自己就能处理Zalo消息，不需要再找别的帮手程序了。

重要提醒：这个方法不是Zalo官方认可的，可能会让你的Zalo账号遇到麻烦，比如被暂停使用，所以你要自己决定要不要用。

安装好小工具后，我们开始设置：

1. 第一步：登录你的Zalo账号。 这一步是让电脑助手认识你的Zalo。在命令行输入 openclaw channels login --channel zalouser，然后你的电脑屏幕上会出现一个二维码。你需要用手机上的Zalo应用扫描这个二维码，就像平时在电脑上登录Zalo一样。
2. 第二步：打开这个聊天通道。 你需要告诉电脑助手：“我允许你用Zalo了！” 方法是修改一个叫“配置”的文件。在里面找到 channels 部分，加上关于 zalouser 的这几行设置，并把 enabled 改成 true。
3. 第三步：重启电脑助手。 改好设置后，需要重启一下电脑助手（或者完成新手引导），新的设置才会生效。
4. 第四步：批准好友聊天。 第一次有朋友通过这个电脑助手给你发消息时，你需要输入一个配对码来批准。默认的设置 dmPolicy: "pairing" 就是这个意思。

这个工具是怎么工作的呢？它就像一个藏在电脑助手肚子里的小程序（zca-js），能直接听到Zalo的新消息，也能直接帮你回复文字、图片或链接。它主要是给个人账号用的，因为个人账号不能用Zalo官方的机器人接口。

怎么找到朋友和群组的号码（ID）？ 你可以用一些命令来查看。比如，openclaw directory self --channel zalouser 可以看你自己；openclaw directory peers list --channel zalouser 可以列出朋友；openclaw directory groups list --channel zalouser 可以列出群组。后面的 --query 就像搜索关键词，可以帮你找名字里带某个词的人或群。

一些限制和要注意的事：

• 一次发送的文字不能太长，最多大约2000个字，因为Zalo客户端本身有这个限制。
• 默认情况下，不能使用“流式”聊天（一种连续对话的模式）。
• 你可以控制谁可以给你发私信。除了默认的“配对”模式，还可以设置成“只允许名单里的人”（allowlist）、“所有人都可以”（open）或者“完全禁止私信”（disabled）。名单写在 allowFrom 后面，可以写用户的ID或者名字。
• 对于群聊，默认是允许的（groupPolicy: "open"）。你也可以设置只允许某些特定的群，或者完全禁止机器人响应群消息。在允许的群里，你还可以设置是否必须@提到机器人，它才会回复。
• 你甚至可以添加多个Zalo账号，让电脑助手同时管理你的“工作号”和“生活号”。

如果遇到问题怎么办？

• 如果登录状态没保存住，可以试试先用 openclaw channels logout --channel zalouser 退出，再重新登录。
• 如果你在名单里写了名字但没效果，最好直接使用数字ID，或者确保名字写得完全正确。
• 如果你以前用过别的方法连接Zalo，现在请忘掉它们，这个新方法不需要任何外部的命令行工具了。