Skip to main content

​
Zalo Personal (plugin)

Zalo Personal support for OpenClaw via a plugin, using native zca-js to automate a normal Zalo user account.
Warning: Unofficial automation may lead to account suspension/ban. Use at your own risk.

​
Naming

Channel id is zalouser to make it explicit this automates a personal Zalo user account (unofficial). We keep zalo reserved for a potential future official Zalo API integration.

​
Where it runs

This plugin runs inside the Gateway process. If you use a remote Gateway, install/configure it on the machine running the Gateway, then restart the Gateway. No external zca/openzca CLI binary is required.

​
Install

​
Option A: install from npm

openclaw plugins install @openclaw/zalouser
Restart the Gateway afterwards.

​
Option B: install from a local folder (dev)

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install
Restart the Gateway afterwards.

​
Config

Channel config lives under channels.zalouser (not 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

Tool name: zalouser Actions: send, image, link, friends, groups, me, status Channel message actions also support react for message reactions.