Zalo 个人插件

通过插件为 OpenClaw 提供 Zalo Personal 支持，使用原生 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：从本地文件夹安装（开发）

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",
    },
  },
}

# CLI

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"

# 智能体工具

工具名称：zalouser

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

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

# 相关内容

• 构建插件
• 社区插件