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

# Персональный плагин Zalo

Поддержка Zalo Personal для OpenClaw через плагин, который использует нативный `zca-js` для
автоматизации обычной учётной записи пользователя Zalo. Внешний исполняемый файл CLI `zca`/`openzca`
не требуется.

> [!WARNING]
>
> Неофициальная автоматизация может привести к приостановке или блокировке учётной записи. Используйте на свой риск.

## Именование

Идентификатор канала — `zalouser`, чтобы явно указать, что он автоматизирует **личную
учётную запись пользователя Zalo** (неофициально). Отдельный идентификатор канала `zalo` относится к официальной
встроенной интеграции с ботом Zalo/Webhook — см. [Zalo](https://docs2.openclaw.ai/ru/channels/zalo.md).

## Где он работает

Этот плагин работает **внутри процесса Gateway**. Если Gateway удалённый,
установите и настройте плагин на этом хосте, затем перезапустите Gateway.

## Установка

### Из npm

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

Используйте пакет без указания версии, чтобы получать текущий официальный тег выпуска; закрепляйте точную
версию только тогда, когда требуется воспроизводимая установка. После этого перезапустите
Gateway.

### Из локальной папки (для разработки)

```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
```

После этого перезапустите Gateway.

## Конфигурация

Конфигурация канала находится в `channels.zalouser` (не в `plugins.entries.*`):

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

Сведения об управлении доступом к личным сообщениям и группам, настройке нескольких учётных записей,
переменных окружения и устранении неполадок см. в разделе [Конфигурация личного канала Zalo](https://docs2.openclaw.ai/ru/channels/zalouser.md).

## 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 "Привет от OpenClaw"
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "имя"
openclaw directory groups list --channel zalouser --query "имя"
openclaw directory groups members --channel zalouser --group-id <id>
```

## Инструмент агента

Имя инструмента: `zalouser`

Действия: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`

Действия с сообщениями канала (не инструмент агента) также поддерживают `react` для
реакций на сообщения.

## Связанные материалы

* [Конфигурация личного канала Zalo](https://docs2.openclaw.ai/ru/channels/zalouser.md)
* [Zalo (официальный канал бота/Webhook)](https://docs2.openclaw.ai/ru/channels/zalo.md)
* [Создание плагинов](https://docs2.openclaw.ai/ru/plugins/building-plugins.md)
* [ClawHub](https://docs2.openclaw.ai/clawhub.md)