OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Plugin guides

Zalo personal plugin

Zalo Personal support for OpenClaw via a plugin that 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, then restart the Gateway.

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. Restart the Gateway afterwards.

From a local folder (dev)

bash
PLUGIN_SRC=./path/to/local/zalouser-pluginopenclaw plugins install "$PLUGIN_SRC"cd "$PLUGIN_SRC" && pnpm install

Restart the Gateway afterwards.

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