Plugin guides

Zalo personal plugin

The zalouser plugin adds unofficial Zalo Personal support to OpenClaw. It uses native zca-js to automate a normal Zalo user account. No external zca/openzca CLI binary is required.

Naming

Channel id is zalouser to make it explicit this automates a personal Zalo user account (unofficial). The separate zalo channel id is the official, bundled Zalo Bot/webhook integration - see Zalo.

Where it runs

This plugin runs inside the Gateway process. For a remote Gateway, install/configure it on that host. Installation applies to a running Gateway automatically; if it is offline, start it after configuration.

Install

From npm

bash
openclaw plugins install @openclaw/zalouser

Use the bare package to follow the current official release tag; pin an exact version only when you need a reproducible install. Check the installation's application result; see Apply changes and inspect.

From a local folder (dev)

bash
cd ./path/to/local/zalouser-pluginpnpm installopenclaw plugins install --link .

After subsequent source or manifest edits, run openclaw plugins reload zalouser.

Config

Channel config lives under channels.zalouser (not plugins.entries.*):

json5
{  channels: {    zalouser: {      enabled: true,      dmPolicy: "pairing",    },  },}

See Zalo personal channel config for DM/group access control, multi-account setup, environment variables, and troubleshooting.

CLI

bash
openclaw channels login --channel zalouseropenclaw channels login --channel zalouser --account <name>openclaw channels logout --channel zalouseropenclaw channels status --probeopenclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"openclaw directory self --channel zalouseropenclaw directory peers list --channel zalouser --query "name"openclaw directory groups list --channel zalouser --query "name"openclaw directory groups members --channel zalouser --group-id <id>

Agent tool

Tool name: zalouser

Actions: send, image, link, friends, groups, me, status

Channel message actions (not the agent tool) also support react for message reactions.

Was this useful?
On this page

On this page