Files
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.5 KiB

Zalo Personal Integration

Overview

This documentation describes an experimental, unofficial integration for automating personal Zalo accounts through the OpenClaw platform using zca-cli.

Warning: This integration is unofficial and carries account suspension risks.

Setup Steps

1. Plugin Installation

openclaw plugins install @openclaw/zalouser

2. Authentication

Login using QR code scanning with the Zalo mobile app:

openclaw channels login --channel zalouser

3. Configuration

Enable the channel with settings like:

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing"
    }
  }
}

Core Capabilities

The integration leverages zca listen to receive messages and zca msg commands for sending text, media, and links. It's designed for personal account scenarios where the official Zalo Bot API isn't available.

Limitations

  • Text messages are chunked to approximately 2000 characters
  • Streaming functionality is disabled by default
  • The integration is unofficial and carries account suspension risks

Access Management

DM Policies

  • pairing
  • allowlist
  • open
  • disabled

Group Access

  • open
  • allowlist (restricted)
  • disabled

The platform includes pairing approval workflows and multi-account support through zca profiles.

Troubleshooting

Missing zca Binary

Ensure the zca binary is available on the system PATH.

Login Persistence Problems

Re-authenticate if sessions expire or become invalid.