# 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.