Zalo Personal（非官方�?

状态：实验性。此集成通过 zca-cli 自动�?个人 Zalo 账户*�?

*警告�? 这是一个非官方集成，可能导致账户暂�?封禁。使用风险自担�?

需要插�?

Zalo Personal 作为插件提供，不随核心安装一起打包�?

  • 通过 CLI 安装：openclaw plugins install @openclaw/zalouser
  • 或从源代码检出：openclaw plugins install ./extensions/zalouser
  • 详情：Plugins

前置条件：zca-cli

网关机器必须�?PATH 中有 zca 二进制文件�?

  • 验证：zca --version
  • 如果缺失，安�?zca-cli（参�?extensions/zalouser/README.md 或上�?zca-cli 文档）�?

快速设置（入门�?

  1. 安装插件（见上方）�?
  2. 登录（QR，在网关机器上）�?
    • openclaw channels login --channel zalouser
    • 使用 Zalo 移动应用在终端中扫描 QR 码�?
  3. 启用频道�?
{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}
  1. 重启网关（或完成入职）�?
  2. 私聊访问默认为配对；在首次联系时批准配对代码�?

它是什�?

  • 使用 zca listen 接收入站消息�?
  • 使用 zca msg ... 发送回复（文本/媒体/链接）�?
  • 专为无法使用 Zalo Bot API �?个人账户”用例设计�?

命名

频道 ID �?zalouser，以明确这是自动�?个人 Zalo 用户账户*（非官方）。我们保�?zalo 供将来潜在的官方 Zalo API 集成使用�?

查找 ID（目录）

使用目录 CLI 发现联系�?群组及其 ID�?

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

限制

  • 出站文本分块为约 2000 个字符（Zalo 客户端限制）�?
  • 默认阻止流式传输�?

访问控制（私聊）

channels.zalouser.dmPolicy 支持：pairing | allowlist | open | disabled（默认：pairing）�? channels.zalouser.allowFrom 接受用户 ID 或名称。向导在可用时通过 zca friend find 将名称解析为 ID�?

通过以下方式批准�?

  • openclaw pairing list zalouser
  • openclaw pairing approve zalouser <code>

群组访问（可选）

  • 默认：channels.zalouser.groupPolicy = "open"（允许群组）。使�?channels.defaults.groupPolicy 覆盖未设置时的默认值�?
  • 使用以下方式限制到允许列表：
    • channels.zalouser.groupPolicy = "allowlist"
    • channels.zalouser.groups（键是群�?ID 或名称）
  • 阻止所有群组：channels.zalouser.groupPolicy = "disabled"�?
  • 配置向导可以提示群组允许列表�?
  • 启动时，OpenClaw 解析允许列表中的群组/用户名称�?ID 并记录映射；未解析的条目保持原样�?

示例�?

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

多账�?

账户映射�?zca 配置。示例：

{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

故障排除

*找不�?zca�?

  • 安装 zca-cli 并确保它在网关进程的 PATH 中�?

登录不生效：

  • openclaw channels status --probe
  • 重新登录：openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser