@zalo-platforms/openclaw-zaloclawbot
v0.1.4
Published
Zalo channel for OpenClaw — QR-onboarded personal bot
Readme
@zalo-platforms/openclaw-zaloclawbot
Official Zalo channel plugin for OpenClaw. Connect a personal Zalo bot to your OpenClaw agent with a QR-scan login — owner-bound, no webhook setup, no developer credentials.
Prerequisites
- Node.js >= 22
- OpenClaw CLI >= 2026.4.10 installed:
npm install -g openclaw@latest - A Zalo account on a mobile device (used to scan the login QR)
Install
Recommended: openclaw onboard
Run the OpenClaw onboarding wizard and pick Zalo ClawBot from the channel menu:
openclaw onboardThe wizard installs the plugin from the official catalog (integrity-verified), renders the login QR right in the terminal, and finishes the channel once you scan it with Zalo — no extra commands.
One-shot installer
If you just want to add the channel to an already-onboarded gateway:
npx -y @zalo-platforms/openclaw-zaloclawbot-cli installThis installs the plugin, enables it, restarts the gateway, and launches the QR login. See @zalo-platforms/openclaw-zaloclawbot-cli for options (e.g. OPENCLAW_BIN).
Manual install
# Use the exact pinned version so OpenClaw verifies the package against the
# official catalog integrity hash during install.
openclaw plugins install "@zalo-platforms/[email protected]"
openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true
openclaw channels login --channel openclaw-zaloclawbot
openclaw gateway restartFull instructions and troubleshooting: https://docs.openclaw.ai/channels/zaloclawbot
How it works
Unlike the developer Zalo channel (which needs your own Official Account and static credentials), Zalo ClawBot is an owner-bound personal assistant on official Zalo Bot Platform infrastructure:
- Secure onboarding — the QR binds a freshly provisioned private bot to your Zalo User ID.
- Owner-bound — the bot talks only to its owner; messages from others are dropped at the platform level.
- Ban-safe — it uses official Bot Platform APIs, with none of the suspension risk of unofficial web-spoof libraries.
License
MIT
