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

# Zalo Personal（非官方）

Status: experimental. 狀態：實驗性。此整合會自動化 **Zalo 個人帳號**，透過 `zca-cli`。

> **Warning:** This is an unofficial integration and may result in account suspension/ban. Use at your own risk.

## Plugin required

Zalo Personal 以外掛形式提供，未包含在核心安裝中。

* 透過 CLI 安裝：`openclaw plugins install @openclaw/zalouser`
* 或從原始碼檢出安裝：`openclaw plugins install ./extensions/zalouser`
* 詳情：[Plugins](/tools/plugin)

## 先決條件：zca-cli

Gateway 閘道器 主機必須在 `PATH` 中可用 `zca` 二進位檔。

* 驗證：`zca --version`
* 若缺少，請安裝 zca-cli（請參閱 `extensions/zalouser/README.md` 或上游 zca-cli 文件）。

## 快速設定（新手）

1. Install the plugin (see above).
2. 登入（QR，在 Gateway 閘道器 主機上）：
   * `openclaw channels login --channel zalouser`
   * 使用 Zalo 行動應用程式掃描終端機中的 QR Code。
3. 啟用頻道：

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

4. 重新啟動 Gateway 閘道器（或完成入門引導）。
5. DM access defaults to pairing; approve the pairing code on first contact.

## 這是什麼

* 使用 `zca listen` 接收傳入訊息。
* 使用 `zca msg ...` 傳送回覆（文字／媒體／連結）。
* 專為無法使用 Zalo Bot API 的「個人帳號」使用情境設計。

## 命名

頻道 id 為 `zalouser`，以明確表示這會自動化 **Zalo 個人使用者帳號**（非官方）。我們保留 `zalo`，以供未來可能的官方 Zalo API 整合。 We keep `zalo` reserved for a potential future official Zalo API integration. We keep `zalo` reserved for a potential future official Zalo API integration.

## 尋找 ID（目錄）

使用目錄 CLI 探索對象／群組及其 ID：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"
```

## 限制

* 傳出文字會切分為約 2000 個字元（Zalo 用戶端限制）。
* Streaming is blocked by default.

## 存取控制（DM）

`channels.zalouser.dmPolicy` 支援：`pairing | allowlist | open | disabled`（預設：`pairing`）。
`channels.zalouser.allowFrom` 接受使用者 ID 或名稱。精靈在可用時會透過 `zca friend find` 將名稱解析為 ID。
`channels.zalouser.allowFrom` accepts user IDs or names.
`channels.zalouser.allowFrom` accepts user IDs or names. The wizard resolves names to IDs via `zca friend find` when available.

Approve via:

* `openclaw pairing list zalouser`
* `openclaw pairing approve zalouser <code>`

## 群組存取（選用）

* 預設：`channels.zalouser.groupPolicy = "open"`（允許群組）。在未設定時，使用 `channels.defaults.groupPolicy` 覆寫預設值。 Use `channels.defaults.groupPolicy` to override the default when unset. Use `channels.defaults.groupPolicy` to override the default when unset.
* 使用允許清單限制：
  * `channels.zalouser.groupPolicy = "allowlist"`
  * `channels.zalouser.groups`（鍵值為群組 ID 或名稱）
* 封鎖所有群組：`channels.zalouser.groupPolicy = "disabled"`。
* The configure wizard can prompt for group allowlists.
* On startup, OpenClaw resolves group/user names in allowlists to IDs and logs the mapping; unresolved entries are kept as typed.

範例：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}
```

## 多帳號

Accounts map to zca profiles. Example:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}
```

## Troubleshooting

**找不到 `zca`：**

* 安裝 zca-cli，並確保對 Gateway 閘道器 程序而言，它位於 `PATH`。

**Login doesn’t stick:**

* `openclaw channels status --probe`
* 重新登入：`openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser`