mirror of https://github.com/openclaw/openclaw.git synced 2026-05-12 20:09:47 +00:00

History

Peter Steinberger 25fae3d722 fix: unblock latest check lane		2026-04-07 09:02:26 +01:00
..
src	refactor: dedupe bluebubbles and zalouser readers	2026-04-07 08:40:34 +01:00
api.ts	refactor: clean bundled channel bootstrap boundaries	2026-04-05 18:18:59 +01:00
CHANGELOG.md	build(plugins): sync bundled versions to 2026.4.6	2026-04-06 17:05:30 +01:00
contract-api.ts	fix: preserve plugin auto-enable activation context	2026-04-06 22:28:45 +01:00
index.ts	refactor: clean bundled channel bootstrap boundaries	2026-04-05 18:18:59 +01:00
openclaw.plugin.json	refactor: resolve channel env vars from plugin manifests	2026-04-06 19:53:27 +01:00
package.json	chore(plugins): bulk add package boundary tsconfig rollout	2026-04-07 08:48:23 +01:00
README.md	refactor(plugins): decouple bundled plugin runtime loading	2026-03-29 09:10:38 +01:00
runtime-api.ts	refactor: centralize inbound mention policy	2026-04-07 07:51:00 +01:00
secret-contract-api.ts	fix: unblock latest check lane	2026-04-07 09:02:26 +01:00
setup-entry.ts	refactor: clean bundled channel bootstrap boundaries	2026-04-05 18:18:59 +01:00
test-api.ts	refactor: route zalouser payload mocks through test api	2026-03-27 13:46:17 +00:00
tsconfig.json	chore(plugins): bulk add package boundary tsconfig rollout	2026-04-07 08:48:23 +01:00

README.md

@openclaw/zalouser

OpenClaw extension for Zalo Personal Account messaging via native zca-js integration.

Warning: Using Zalo automation may result in account suspension or ban. Use at your own risk. This is an unofficial integration.

Features

Channel plugin integration with setup wizard + QR login
In-process listener/sender via zca-js (no external CLI)
Multi-account support
Agent tool integration (zalouser)
DM/group policy support

Prerequisites

OpenClaw Gateway
Zalo mobile app (for QR login)

No external zca, openzca, or zca-cli binary is required.

Install

Option A: npm

openclaw plugins install @openclaw/zalouser

Option B: local source checkout

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

Restart the Gateway after install.

Quick start

openclaw channels login --channel zalouser

Scan the QR code with the Zalo app on your phone.

Enable channel

channels:
  zalouser:
    enabled: true
    dmPolicy: pairing # pairing | allowlist | open | disabled

Send a message

openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"

Configuration

Basic:

channels:
  zalouser:
    enabled: true
    dmPolicy: pairing

Multi-account:

channels:
  zalouser:
    enabled: true
    defaultAccount: default
    accounts:
      default:
        enabled: true
        profile: default
      work:
        enabled: true
        profile: work

Useful commands

openclaw channels login --channel zalouser
openclaw channels login --channel zalouser --account work
openclaw channels status --probe
openclaw channels logout --channel zalouser

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"
openclaw directory groups members --channel zalouser --group-id <id>

Agent tool

The extension registers a zalouser tool for AI agents.

Available actions: send, image, link, friends, groups, me, status

Troubleshooting

Login not persisted: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser
Probe status: openclaw channels status --probe
Name resolution issues (allowlist/groups): use numeric IDs or exact Zalo names

Credits

Built on zca-js.