Zalo 个人账号(插件)

通过插件为 OpenClaw 提供 Zalo 个人账号支持,使用原生 zca-js 自动化普通 Zalo 用户账号。

警告: 非官方自动化可能导致账号被封禁。风险自担。

命名

频道 ID 为 zalouser,明确表示这是对个人 Zalo 用户账号的非官方自动化。zalo 保留给未来可能的官方 Zalo API 集成。

运行位置

该插件运行在 Gateway 进程内部

如果使用远程 Gateway,在运行 Gateway 的机器上安装和配置,然后重启 Gateway。

不需要外部的 zca/openzca CLI 二进制文件。

安装

方式 A:从 npm 安装

openclaw plugins install @openclaw/zalouser

安装后重启 Gateway。

方式 B:从本地文件夹安装(开发用)

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install

安装后重启 Gateway。

配置

频道配置在 channels.zalouser 下(不是 plugins.entries.*):

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

CLI

openclaw channels login --channel zalouser
openclaw channels logout --channel zalouser
openclaw channels status --probe
openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"
openclaw directory peers list --channel zalouser --query "name"

Agent 工具

工具名:zalouser

动作:sendimagelinkfriendsgroupsmestatus

频道消息动作还支持 react 用于消息表情回应。