Selig
4c966a3ad2
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.
76 lines
1.5 KiB
Markdown
76 lines
1.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/zalouser
|
|
```
|
|
|
|
### 2. Authentication
|
|
|
|
Login using QR code scanning with the Zalo mobile app:
|
|
|
|
```bash
|
|
openclaw channels login --channel zalouser
|
|
```
|
|
|
|
### 3. Configuration
|
|
|
|
Enable the channel with settings like:
|
|
|
|
```json5
|
|
{
|
|
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.
|