mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-17 21:10:54 +00:00
a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
89 lines
2.1 KiB
Markdown
89 lines
2.1 KiB
Markdown
---
|
||
read_when:
|
||
- 你想在 OpenClaw 中支持 Zalo Personal（非官方）
|
||
- 你正在配置或开发 zalouser 插件
|
||
summary: Zalo Personal 插件：通过 zca-cli 进行 QR 登录 + 消息（插件安装 + 渠道配置 + CLI + 工具）
|
||
title: Zalo Personal 插件
|
||
x-i18n:
|
||
generated_at: "2026-02-03T07:53:33Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: b29b788b023cd50720e24fe6719f02e9f86c8bca9c73b3638fb53c2316718672
|
||
source_path: plugins/zalouser.md
|
||
workflow: 15
|
||
---
|
||
|
||
# Zalo Personal（插件）
|
||
|
||
通过插件为 OpenClaw 提供 Zalo Personal 支持，使用 `zca-cli` 自动化普通 Zalo 用户账户。
|
||
|
||
> **警告：** 非官方自动化可能导致账户被暂停/封禁。使用风险自负。
|
||
|
||
## 命名
|
||
|
||
渠道 id 是 `zalouser`，以明确表示这是自动化**个人 Zalo 用户账户**（非官方）。我们保留 `zalo` 用于潜在的未来官方 Zalo API 集成。
|
||
|
||
## 运行位置
|
||
|
||
此插件**在 Gateway 网关进程内**运行。
|
||
|
||
如果你使用远程 Gateway 网关，请在**运行 Gateway 网关的机器**上安装/配置它，然后重启 Gateway 网关。
|
||
|
||
## 安装
|
||
|
||
### 选项 A：从 npm 安装
|
||
|
||
```bash
|
||
openclaw plugins install @openclaw/zalouser
|
||
```
|
||
|
||
之后重启 Gateway 网关。
|
||
|
||
### 选项 B：从本地文件夹安装（开发）
|
||
|
||
```bash
|
||
openclaw plugins install ./extensions/zalouser
|
||
cd ./extensions/zalouser && pnpm install
|
||
```
|
||
|
||
之后重启 Gateway 网关。
|
||
|
||
## 前置条件：zca-cli
|
||
|
||
Gateway 网关机器必须在 `PATH` 中有 `zca`：
|
||
|
||
```bash
|
||
zca --version
|
||
```
|
||
|
||
## 配置
|
||
|
||
渠道配置位于 `channels.zalouser` 下（不是 `plugins.entries.*`）：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
zalouser: {
|
||
enabled: true,
|
||
dmPolicy: "pairing",
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
## CLI
|
||
|
||
```bash
|
||
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"
|
||
```
|
||
|
||
## 智能体工具
|
||
|
||
工具名称：`zalouser`
|
||
|
||
操作：`send`、`image`、`link`、`friends`、`groups`、`me`、`status`
|