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

Regional platforms

Zalo ClawBot

OpenClaw connects to Zalo ClawBot through the catalog-listed external @zalo-platforms/openclaw-zaloclawbot plugin. Login uses a Zalo Mini App QR code; the plugin id in config is openclaw-zaloclawbot.

Compatibility

Plugin Version OpenClaw Version npm dist-tag Status
0.1.4 >=2026.4.10 latest Active / Beta

Prerequisites

  • Node.js >= 22
  • OpenClaw installed (openclaw CLI available)
  • A Zalo account on a mobile device to scan the login QR code

Install with onboard (recommended)

bash
openclaw onboard

Pick Zalo ClawBot from the channel menu. The wizard installs the plugin from the official catalog (integrity-verified), renders the login QR in the terminal, and finishes the channel once you scan it with the Zalo app.

Manual installation

To add the channel to an already-onboarded gateway:

1. Install the plugin

bash
openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

Use the exact pinned version so OpenClaw verifies the package against the catalog integrity hash during install.

2. Enable the plugin

bash
openclaw plugins enable openclaw-zaloclawbot

Check the application result before logging in. Reinstallation preserves a plugin you explicitly disabled.

3. Generate a QR code and log in

bash
openclaw channels login --channel openclaw-zaloclawbot

Scan the terminal-rendered QR code with the Zalo mobile app, accept the Terms of Use inside the Zalo Mini App, and authorize the session.

4. Verify the channel

bash
openclaw channels status --probe

Start the Gateway if it is offline. Config changes follow hot reload. If the running channel has not picked up the saved login, run openclaw plugins reload openclaw-zaloclawbot, then check its status again.

How it works

Unlike the standard Zalo channel, which requires registering your own Zalo Official Account (OA) and configuring static developer credentials, Zalo ClawBot is an owner-bound personal assistant on shared official infrastructure:

  1. Onboarding: the QR code resolves to a Zalo Mini App that binds a newly provisioned, private bot under a shared official OA directly to your Zalo user ID.
  2. Owner-bound privacy: the bot only communicates with its owner. Messages from other users are dropped at the platform level.
  3. Official API path: the plugin uses Zalo Bot Platform APIs, not browser or web-session automation.

Under the hood

The plugin communicates with Zalo via a persistent long-polling loop (getUpdates). Webhooks are disabled by default for local desktop/terminal gateway runs. Messages are processed client-side and mapped to your local agent runtime.

The plugin manages bot credentials under the OpenClaw state directory. Treat that directory as sensitive and cover it under the same access-control and backup policy as the rest of OpenClaw state.

Troubleshooting

  • QR login timeout: the login token (zbsk) expires after 5 minutes for security. If the QR code expires before you scan it, rerun the login command to generate a new one.
  • Gateway fails to load: confirm your OpenClaw host version is 2026.4.10 or higher. Older versions do not support the external npm-plugin installation ledger this ID requires.
  • Channels Overview - all supported channels
  • Zalo - the bundled Zalo Bot Creator / Marketplace channel
  • Pairing - DM authentication and pairing flow
  • Plugins - installing and managing plugins
Was this useful?
On this page

On this page