Connect OpenClaw to Zalo using Official Account API. This guide covers OpenClaw v2026.2+, Zalo OA setup, API credentials configuration, message handling, and webhook integration for self-hosted AI assistants.

💬

Zalo Integration

Connect OpenClaw to Zalo and have your AI assistant respond to messages instantly.

Zalo OA API 10 min setup Vietnam popular

TL;DR

✓ Prerequisites: Node.js 22+, OpenClaw installed
✓ Configuration: Add Zalo section to openclaw.json
✓ Time: ~10 minutes
✓ Requires: Zalo account + OA (Official Account)

Prerequisites

1.

OpenClaw installed

Follow the installation guide if you haven't already.
2.

Zalo Official Account (OA)

You need to create a Zalo Official Account at oa.zalo.me.
3.

Zalo API credentials

Get your OA ID and API key from the Zalo OA dashboard.

Setup Steps

Step 1: Create Zalo Official Account

If you don't have an OA yet:

Visit oa.zalo.me
Register for a Official Account (follow the wizard)
Verify your account
Get your OA ID from the dashboard

Step 2: Configure openclaw.json

Add the Zalo configuration to your openclaw.json file:

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "your_oa_id",
      "apiKey": "your_api_key",
      "allowFrom": ["*"]
    }
  }
}

Step 3: Start OpenClaw

Start OpenClaw with Zalo enabled:

openclaw start

The bot will connect to Zalo and be ready to receive messages.

Step 4: Test Your AI Assistant

Open Zalo and search for your Official Account:

Open Zalo app
Search for your OA name
Send a message to start a conversation

🎉 Connected! Your Zalo AI assistant is now ready.

Advanced Configuration

Allow Specific Users

Restrict who can interact with your AI assistant:

{
  "channels": {
    "zalo": {
      "enabled": true,
      "oaId": "your_oa_id",
      "apiKey": "your_api_key",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Webhook Configuration

For advanced features, configure webhook in Zalo OA dashboard:

Go to OA dashboard → Advanced Settings → Webhook
Set webhook URL to your OpenClaw server
Enable the events you want to receive

Troubleshooting

API key invalid?

Check your API key in the Zalo OA dashboard. Make sure the API is enabled for your account.

Messages not received?

Verify that your openclaw.json has "enabled": true for the Zalo channel and check the logs.

OA not found?

Make sure your Official Account is verified and active. New OAs may need to be approved first.

Related Guides

✈️

Telegram Bot

💬

WhatsApp Bot

Frequently Asked Questions

Is Zalo OA free?

Zalo Official Accounts have both free and premium tiers. Basic API features are free with limitations. Check Zalo's pricing for details.

Can I use personal Zalo account?

No, you need a Zalo Official Account (OA) to use the API. Create one at oa.zalo.me.

Does Zalo support group messages?

Zalo OA can send messages to users who have interacted with your OA. For group messages, you need to manage a fan page.

How do I get API credentials?

Go to oa.zalo.me, select your OA, go to Advanced Settings → API → Create API key.