Zalo 个人账号（插件）

适用范围

在以下情况使用本页：

• 您希望在 Clawdbot 中使用 Zalo 个人账号（非官方）支持
• 您正在配置或开发 zalouser 插件

通过插件为 Clawdbot 提供 Zalo 个人账号支持，使用 zca-cli 自动化普通 Zalo 用户账号。

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

命名说明

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

运行位置

此插件在 Gateway 进程内部运行。

如果您使用远程 Gateway，请在运行 Gateway 的机器上安装/配置它，然后重启 Gateway。

安装

选项 A：从 npm 安装

clawdbot plugins install @clawdbot/zalouser

之后重启 Gateway。

选项 B：从本地文件夹安装（开发）

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

之后重启 Gateway。

前置条件：zca-cli

Gateway 机器必须在 PATH 中有 zca：

zca --version

配置

渠道配置位于 channels.zalouser 下（而非 plugins.entries.*）：

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

CLI

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

Agent 工具

工具名称：zalouser

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