Zalo Personal (plugin)

通过 Plugin 为 OpenClaw 提供 Zalo Personal 支持，使用 zca-cli 自动化普通 Zalo 用户账号。

警告： 非官方自动化可能导致账号被暂停或封禁。使用风险自负。

命名

Channel id 是 zalouser，明确表示这是自动化个人 Zalo 用户账号（非官方）。我们保留 zalo 用于未来可能的官方 Zalo API 集成。

运行位置

这个 Plugin 运行在 Gateway 进程内部。

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

安装

方式 A：从 npm 安装

openclaw plugins install @openclaw/zalouser

安装后重启 Gateway。

方式 B：从本地文件夹安装（开发用）

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

安装后重启 Gateway。

前置要求：zca-cli

运行 Gateway 的机器必须在 PATH 中有 zca 命令：

zca --version

配置

Channel 配置位于 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 tool

Tool 名称：zalouser

操作：send、image、link、friends、groups、me、status