> ## 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 Zalo cá nhân

Hỗ trợ Zalo Cá nhân cho OpenClaw thông qua một Plugin sử dụng `zca-js` nguyên bản để
tự động hóa tài khoản người dùng Zalo thông thường. Không yêu cầu tệp nhị phân CLI
`zca`/`openzca` bên ngoài.

<Warning>
  Việc tự động hóa không chính thức có thể khiến tài khoản bị đình chỉ hoặc cấm. Bạn tự chịu rủi ro khi sử dụng.
</Warning>

## Cách đặt tên

ID kênh là `zalouser` để thể hiện rõ rằng kênh này tự động hóa một **tài khoản
người dùng Zalo cá nhân** (không chính thức). ID kênh `zalo` riêng biệt là tích hợp
Zalo Bot/Webhook chính thức được đóng gói sẵn — xem [Zalo](/vi/channels/zalo).

## Nơi chạy

Plugin này chạy **bên trong tiến trình Gateway**. Đối với Gateway từ xa,
hãy cài đặt/cấu hình Plugin trên máy chủ đó, sau đó khởi động lại Gateway.

## Cài đặt

### Từ npm

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

Sử dụng tên gói trần để theo thẻ phát hành chính thức hiện tại; chỉ ghim một
phiên bản chính xác khi bạn cần quá trình cài đặt có thể tái lập. Sau đó, hãy
khởi động lại Gateway.

### Từ thư mục cục bộ (phát triển)

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

Sau đó, hãy khởi động lại Gateway.

## Cấu hình

Cấu hình kênh nằm trong `channels.zalouser` (không phải `plugins.entries.*`):

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

Xem [Cấu hình kênh Zalo cá nhân](/vi/channels/zalouser) để biết về kiểm soát truy cập
tin nhắn trực tiếp/nhóm, thiết lập nhiều tài khoản, biến môi trường và khắc phục sự cố.

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

## Công cụ tác tử

Tên công cụ: `zalouser`

Hành động: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`

Các hành động tin nhắn của kênh (không phải công cụ tác tử) cũng hỗ trợ `react`
để bày tỏ cảm xúc với tin nhắn.

## Liên quan

* [Cấu hình kênh Zalo cá nhân](/vi/channels/zalouser)
* [Zalo (kênh Bot/Webhook chính thức)](/vi/channels/zalo)
* [Xây dựng Plugin](/vi/plugins/building-plugins)
* [ClawHub](/clawhub)