Zalo personal plugin

Zalo Personal support for OmeniaClaw via a plugin, using native zca-js to automate a normal Zalo user account.

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

OmeniaClaw plugins install @OmeniaClaw/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.

Option B: install from a local folder (dev)

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

Restart the Gateway afterwards.

Config

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

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

CLI

OmeniaClaw channels login --channel zalouserOmeniaClaw channels logout --channel zalouserOmeniaClaw channels status --probeOmeniaClaw message send --channel zalouser --target <threadId> --message "Hello from OmeniaClaw"OmeniaClaw 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.

Related

• Building plugins
• ClawHub