跳到正文
FunCoding

搜索

搜索文档、文章、Skill 和 MCP

Zalo Personal 插件

Zalo Personal 插件:通过原生 zca-js 实现二维码登录和消息传递(插件安装 + 渠道配置 + 工具)

通过使用原生 zca-js 的插件为 OpenClaw 提供 Zalo Personal 支持,以自动操作普通 Zalo 用户账户。无需外部 zca/openzca CLI 二进制文件。

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

命名

渠道 ID 为 zalouser,以明确表示它自动操作的是个人 Zalo 用户账户(非官方)。另一个 zalo 渠道 ID 对应官方内置的 Zalo Bot/webhook 集成——请参阅 Zalo。

运行位置

此插件在 Gateway 网关进程内运行。对于远程 Gateway 网关,请在该主机上安装并配置插件,然后重启 Gateway 网关。

安装

从 npm 安装

openclaw plugins install @openclaw/zalouser

使用不带版本号的软件包可跟随当前官方发布标签;仅在需要可复现安装时固定确切版本。之后重启 Gateway 网关。

从本地文件夹安装(开发)

PLUGIN_SRC=./path/to/local/zalouser-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install

之后重启 Gateway 网关。

配置

渠道配置位于 channels.zalouser 下(而非 plugins.entries.*):

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

有关私信/群组访问控制、多账户设置、环境变量和故障排查,请参阅 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 "来自 OpenClaw 的问候"
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "名称"
openclaw directory groups list --channel zalouser --query "名称"
openclaw directory groups members --channel zalouser --group-id <id>

智能体工具

工具名称:zalouser

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

渠道消息操作(不是智能体工具)还支持使用 react 进行消息表情回应。

相关内容