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

# Zalo Personal Eklentisi

# Zalo Personal (eklenti)

OpenClaw için Zalo Personal desteği; normal bir Zalo kullanıcı hesabını otomatikleştirmek üzere `zca-cli` kullanarak bir eklenti üzerinden sağlanır.

> **Uyarı:** Resmi olmayan otomasyon, hesabın askıya alınmasına/yasaklanmasına yol açabilir. Riski size aittir.

## Adlandırma

Kanal kimliği, bunun **kişisel bir Zalo kullanıcı hesabını** (resmi olmayan) otomatikleştirdiğini açıkça belirtmek için `zalouser`’dır. Olası gelecekteki resmi Zalo API entegrasyonu için `zalo`’yi ayrılmış tutuyoruz.

## Nerede çalışır

Bu eklenti **Gateway sürecinin içinde** çalışır.

Uzak bir Gateway kullanıyorsanız, Gateway’i çalıştıran **makineye** kurun/yapılandırın ve ardından Gateway’i yeniden başlatın.

## Yükleme

### Seçenek A: npm’den yükleme

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

Ardından Gateway’i yeniden başlatın.

### Seçenek B: yerel bir klasörden yükleme (geliştirme)

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

Ardından Gateway’i yeniden başlatın.

## Ön koşul: zca-cli

Gateway makinesinde `zca`, `PATH` üzerinde bulunmalıdır:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
zca --version
```

## Yapılandırma

Kanal yapılandırması `channels.zalouser` altında yer alır (`plugins.entries.*` değil):

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

## Ajan aracı

Araç adı: `zalouser`

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