11.6 Zalo个人插件

Zalo个人插件通过 zca-cli 实现非官方的Zalo个人账户自动化。

概述

Zalo个人插件是一个非官方工具,允许OpenClaw与Zalo个人账户进行交互。它在Gateway中运行,依赖于 zca-cli 工具。

安装

安装插件

# 从npm安装
openclaw plugins install @openclaw/zalouser

# 或从本地文件夹安装
openclaw plugins install ./path/to/zalouser-plugin

安装zca-cli

# 全局安装zca-cli
npm install -g zca-cli

# 或使用yarn
yarn global add zca-cli

# 验证安装
zca --version

配置

{
  "channels": {
    "zalouser": {
      "enabled": true,
      "accounts": [
        {
          "id": "my-zalo",
          "phoneNumber": "+84987654321"
        }
      ]
    }
  }
}

认证

首次使用需要进行身份验证:

# 启动认证流程
openclaw auth login zalouser

# 按照提示输入手机号和验证码
# 认证信息会保存在 ~/.openclaw/auth/zalouser.json

CLI命令

发送消息

# 发送文本消息
openclaw zalouser send <user-id> "你好"

# 发送到群组
openclaw zalouser send-group <group-id> "群消息"

发送图片

# 发送图片
openclaw zalouser image <user-id> /path/to/image.jpg

发送链接

# 发送链接
openclaw zalouser link <user-id> https://example.com

查询信息

# 获取好友列表
openclaw zalouser friends

# 获取群组列表
openclaw zalouser groups

# 获取个人信息
openclaw zalouser me

# 检查在线状态
openclaw zalouser status

代理工具

工具名称: zalouser

支持的操作

发送消息

{
  "tool": "zalouser",
  "action": "send",
  "to": "user-id",
  "message": "你好"
}

发送图片

{
  "tool": "zalouser",
  "action": "image",
  "to": "user-id",
  "imagePath": "/path/to/image.jpg"
}

发送链接

{
  "tool": "zalouser",
  "action": "link",
  "to": "user-id",
  "url": "https://example.com",
  "title": "链接标题"
}

获取好友列表

{
  "tool": "zalouser",
  "action": "friends"
}

获取群组列表

{
  "tool": "zalouser",
  "action": "groups"
}

获取个人信息

{
  "tool": "zalouser",
  "action": "me"
}

检查状态

{
  "tool": "zalouser",
  "action": "status"
}

使用场景

• 自动回复: 设置自动回复规则
• 消息转发: 在不同平台间转发消息
• 群组管理: 自动化群组消息管理
• 通知推送: 发送自动化通知
• 信息查询: 查询好友和群组信息

限制和注意事项

• 需要 zca 在PATH中可用
• 仅支持个人账户,不支持企业账户
• 可能受Zalo速率限制
• 认证会话可能过期,需要重新登录
• 功能依赖于 zca-cli 的更新

故障排除

认证失败

• 确认手机号格式正确
• 检查验证码是否过期
• 确认网络连接正常
• 尝试重新安装 zca-cli

发送消息失败

• 验证用户ID是否正确
• 检查认证状态
• 确认未触发速率限制
• 查看 zca-cli 日志

找不到zca命令

• 确认 zca-cli 已全局安装
• 检查PATH环境变量
• 尝试使用完整路径

安全建议

• 不要在生产环境使用主账户
• 使用专用测试账户
• 定期备份认证信息
• 监控账户活动
• 遵守Zalo使用规则
• 避免频繁发送消息

调试

# 启用调试模式
DEBUG=zalouser openclaw gateway

# 查看zca-cli日志
zca --debug

# 测试连接
openclaw zalouser status