Zalo Personal (plugin)

Plugin hỗ trợ Zalo Personal cho OpenClaw, sử dụng zca-cli để tự động hóa tài khoản Zalo cá nhân thông thường.

Cảnh báo: Tự động hóa không chính thức có thể dẫn đến tài khoản bị khóa/cấm. Các bạn tự chịu trách nhiệm khi sử dụng nhé.

Đặt tên

Channel id là zalouser để làm rõ đây là tự động hóa tài khoản Zalo cá nhân (không chính thức). Mình giữ lại tên zalo cho khả năng tích hợp API Zalo chính thức trong tương lai.

Chạy ở đâu

Plugin này chạy bên trong tiến trình Gateway.

Nếu các bạn dùng Gateway từ xa, hãy cài đặt/cấu hình trên máy đang chạy Gateway, sau đó khởi động lại Gateway.

Cài đặt

Cách A: cài từ npm

openclaw plugins install @openclaw/zalouser

Khởi động lại Gateway sau khi cài xong.

Cách B: cài từ thư mục local (dev)

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install

Khởi động lại Gateway sau khi cài xong.

Yêu cầu: zca-cli

Máy chạy Gateway phải có zca trong PATH:

zca --version

Cấu hình

Cấu hình Channel nằm trong channels.zalouser (không phải 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"

Agent tool

Tên tool: zalouser

Các action: send, image, link, friends, groups, me, status