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

> 비공식 Zalo Personal plugin의 설치, `channels.zalouser` 설정, CLI 로그인, agent tool 동작을 안내합니다.

# Zalo Personal Plugin

# Zalo Personal (플러그인)

이 플러그인은 native `zca-js`를 사용해 일반 Zalo 개인 계정을 자동화하며, OpenClaw에 Zalo Personal 지원을 추가합니다.

> **Warning:** 비공식 자동화는 계정 정지나 차단으로 이어질 수 있습니다. 사용 책임은 본인에게 있습니다.

## 이름 규칙

채널 id는 `zalouser`입니다. 이 이름은 **개인 Zalo 사용자 계정**(비공식)을 자동화한다는 점을 분명히 하기 위한 것입니다. `zalo`는 향후 공식 Zalo API 통합을 위해 남겨 둡니다.

## 실행 위치

이 플러그인은 **Gateway 프로세스 내부**에서 실행됩니다.

원격 Gateway를 사용한다면 **Gateway가 실제로 실행되는 머신**에 설치하고 설정한 뒤 Gateway를 다시 시작하세요.

외부 `zca`/`openzca` CLI 바이너리는 필요하지 않습니다.

## 설치

### 옵션 A: npm에서 설치

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

이후 Gateway를 재시작하세요.

### 옵션 B: 로컬 폴더에서 설치(dev)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install
```

이후 Gateway를 재시작하세요.

## 설정

channel config는 `plugins.entries.*`가 아니라 `channels.zalouser` 아래에 있습니다.

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

## CLI

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

## Agent tool

Tool name: `zalouser`

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

channel message actions는 message reactions용 `react`도 지원합니다.