Zalouser

OpenClaw Zalo Personal Account plugin via native zca-js integration

openclaw plugins install clawhub:@openclaw/zalouser

{
  "builtWithOpenClawVersion": "2026.3.22",
  "minGatewayVersion": ">=2026.3.22",
  "pluginApiRange": ">=2026.3.22"
}

{
  "bundledSkills": [],
  "capabilityTags": [
    "executes-code",
    "channel:zalouser",
    "setup"
  ],
  "channels": [
    "zalouser"
  ],
  "commandNames": [],
  "configSchema": true,
  "configUiHints": false,
  "executesCode": true,
  "hooks": [],
  "httpRouteCount": 0,
  "materializesDependencies": false,
  "providers": [],
  "runtimeId": "zalouser",
  "serviceNames": [],
  "setupEntry": true,
  "toolNames": []
}

{
  "hasProvenance": false,
  "scanStatus": "not-run",
  "scope": "artifact-only",
  "sourceCommit": "c4420c03243bd691dc809cd4298bd744cb58d286",
  "sourceRepo": "openclaw/openclaw",
  "sourceTag": "refs/heads/main",
  "summary": "Validated package structure and linked the release to source metadata.",
  "tier": "source-linked"
}

{
  "latest": "2026.3.22"
}

@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

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install

Restart the Gateway after install.

Quick start

Login (QR)

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.