Zalo 个人插件

zalouser 插件为 OpenClaw 添加非官方的 Zalo Personal 支持。它使用原生 zca-js 来自动化一个普通 Zalo 用户账户。无需外部 zca/openzca CLI 二进制文件。

Warning

非官方自动化可能导致账户被暂停或封禁。风险自负。

命名¶

通道 ID 为 zalouser，以明确说明它自动化的是个人 Zalo 用户账户（非官方）。另一个 zalo 通道 ID 是官方内置的 Zalo Bot/webhook 集成 - 参见 Zalo。

运行位置¶

此插件运行在 Gateway 进程内部。对于远程 Gateway，请在那台主机上安装/配置它。安装会自动应用于正在运行的 Gateway；如果 Gateway 离线，请在配置完成后启动它。

安装¶

从 npm¶

openclaw plugins install @openclaw/zalouser

使用裸包名以跟随当前官方发布标签；只有在需要可复现安装时才固定确切版本。检查安装的应用结果；参见应用更改并检查。

从本地文件夹（开发）{#from-a-local-folder-dev}¶

cd ./path/to/local/zalouser-plugin
pnpm install
openclaw plugins install --link .

在后续修改源代码或 manifest 后，运行 openclaw plugins reload zalouser。

配置¶

通道配置位于 channels.zalouser 下（而不是 plugins.entries.*）：

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

有关 DM/群组访问控制、多账户设置、环境变量和故障排除，请参见 Zalo 个人通道配置。

CLI¶

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

Agent 工具¶

工具名称：zalouser

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

通道消息操作（不是 Agent 工具）还支持用于消息表情回应的 react。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw