Zalo Personal（插件）

通过插件为 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 命令

配置好你的小龙虾后，使用以下命令管理 Zalo 渠道：

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

支持的操作：send、image、link、friends、groups、me、status

渠道消息操作还支持 react 用于消息回应。