Zalo 个人账号插件

概述

zalouser 插件通过原生 zca-js 库为 OpenClaw 提供 Zalo 个人账号（非官方）支持，自动化普通 Zalo 用户账号。Channel ID 为 zalouser，明确区分个人账号自动化（非官方）与未来可能的官方 Zalo API 集成（保留 zalo ID）。

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

核心功能

• 无需外部 CLI：不依赖 zca/openzca 二进制，直接在 Gateway 进程内运行
• QR 登录：通过 openclaw channels login --channel zalouser 扫码登录
• 消息操作：发送文本、图片、链接，支持消息反应（react）
• 联系人/群组查询：friends（好友列表）、groups（群组列表）、me（当前账号信息）
• Agent 工具：工具名 zalouser，操作：send、image、link、friends、groups、me、status

配置/使用

安装：

openclaw plugins install @openclaw/zalouser

配置（在 channels.zalouser 下，非 plugins.entries.*）：

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

CLI 操作：

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

相关页面

• concepts/plugin-building — 插件构建指南
• concepts/plugin-sdk-channel-plugins — Channel 插件 SDK
• concepts/tool-clawhub — ClawHub 插件注册表