> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin personal de Zalo

Compatibilidad de Zalo Personal con OpenClaw mediante un Plugin que usa `zca-js` nativo para
automatizar una cuenta de usuario normal de Zalo. No se requiere ningún binario
CLI externo de `zca`/`openzca`.

<Warning>
  La automatización no oficial puede provocar la suspensión o el bloqueo de la cuenta. Úsala bajo tu propia responsabilidad.
</Warning>

## Nomenclatura

El id del canal es `zalouser` para dejar explícito que esto automatiza una **cuenta
personal de usuario de Zalo** (no oficial). El id de canal separado `zalo` es la integración oficial
incluida de Zalo Bot/Webhook - consulta [Zalo](/es/channels/zalo).

## Dónde se ejecuta

Este Plugin se ejecuta **dentro del proceso Gateway**. Para un Gateway remoto,
instálalo/configúralo en ese host y luego reinicia el Gateway.

## Instalación

### Desde npm

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/zalouser
```

Usa el paquete sin versión para seguir la etiqueta de versión oficial actual; fija una
versión exacta solo cuando necesites una instalación reproducible. Reinicia el Gateway
después.

### Desde una carpeta local (desarrollo)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
PLUGIN_SRC=./path/to/local/zalouser-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install
```

Reinicia el Gateway después.

## Configuración

La configuración del canal reside en `channels.zalouser` (no en `plugins.entries.*`):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}
```

Consulta [configuración del canal personal de Zalo](/es/channels/zalouser) para el control de acceso
a DM/grupos, la configuración de varias cuentas, variables de entorno y solución de problemas.

## CLI

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel zalouser
openclaw channels login --channel zalouser --account <name>
openclaw channels logout --channel zalouser
openclaw channels status --probe
openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "name"
openclaw directory groups members --channel zalouser --group-id <id>
```

## Herramienta de agente

Nombre de la herramienta: `zalouser`

Acciones: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`

Las acciones de mensajes de canal (no la herramienta de agente) también admiten `react` para
reacciones a mensajes.

## Relacionado

* [configuración del canal personal de Zalo](/es/channels/zalouser)
* [Zalo (canal oficial de Bot/Webhook)](/es/channels/zalo)
* [Creación de Plugins](/es/plugins/building-plugins)
* [ClawHub](/clawhub)