docs: 重写部署指南,覆盖完整三层架构(NapCat → qqrebot → OpenClaw)

- 架构概览(拓扑图)
- 第1步:NapCat / go-cqhttp 部署
- 第2步:qqrebot 本体部署(含 systemd 服务)
- 第3步:OpenClaw Agent 端部署
This commit is contained in:
Claw
2026-05-04 18:38:10 +08:00
parent 35f3979b52
commit cee3ed882b

104
README.md
View File

@ -159,21 +159,107 @@ my_plugin.zip
.\run.bat
```
## AI Agent 部署OpenClaw
## 完整部署指南
如需让 AI agent 主动操作 QQ发消息、管理群、查信息等需将脚本和 Skill 部署到 agent 的工作区。
### 架构概览
### 1. 部署脚本
整个系统分三层:
将 `scripts/` 目录复制到 qq-agent 工作区:
```
QQ客户端 服务器
│ │
│ QQ 协议 │
▼ │
NapCat / go-cqhttp │
│ OneBot HTTP │
├─── POST 消息 → qqrebot (本仓库)
│ │
│ HTTP API │
◄─── 主动操作 ── qqrebot │
│ ├─── 转发消息 → OpenClaw Gateway
│ │ └─── agent 处理
│ ◄─── 回复 ←────┘
```
### 第1步部署 NapCat / go-cqhttp
这是 QQ 协议实现,负责登录 QQ 账号并与腾讯服务器通信。
- NapCathttps://napcat.napneko.com/
- go-cqhttphttps://docs.go-cqhttp.org/
配置 NapCat 的 HTTP 上报地址指向 qqrebot默认 `http://127.0.0.1:25580`)。
### 第2步部署 qqrebot本仓库
从 [chatrebot1.0 release](https://jianfgit.xyz/jianf/chat_rebot-connect-with-onebot-standard-/src/tag/chatrebot1.0/) 下载并解压:
```bash
# 下载 release 源码
wget https://jianfgit.xyz/jianf/chat_rebot-connect-with-onebot-standard-/archive/chatrebot1.0.tar.gz
tar xzf chatrebot1.0.tar.gz
cd chat_rebot-connect-with-onebot-standard-
# 如需安装 OpenClaw Bridge 插件,从 main 分支复制
wget https://jianfgit.xyz/jianf/chat_rebot-connect-with-onebot-standard-/raw/branch/main/src/process.py
wget https://jianfgit.xyz/jianf/chat_rebot-connect-with-onebot-standard-/raw/branch/main/config/openclawbridge/config.toml
mkdir -p plugins config/openclawbridge
mv process.py plugins/
mv config.toml config/openclawbridge/
```
**配置 NapCat 地址**`config/config.toml`
```toml
[app]
list_port = 25580 # 接收 NapCat 消息推送的端口
send_url = "http://127.0.0.1:25570" # NapCat HTTP API 地址
[rebot]
id = ""
[plugins]
dir = ["plugins"]
```
**启动Linux**
```bash
chmod +x run.sh
./run.sh
```
**配置 systemd 服务(推荐)**
```ini
[Unit]
Description=QQ Robot
After=network.target
[Service]
Type=simple
WorkingDirectory=/path/to/chat_rebot-connect-with-onebot-standard-
ExecStart=/path/to/chat_rebot-connect-with-onebot-standard-/run.sh
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
```
### 第3步配置 OpenClaw Agent
让 agent 能够主动操作 QQ发消息、管理群、查信息等
#### 3a. 部署脚本到 agent 工作区
```bash
cp -r scripts/ /path/to/qq-agent/workspace/
```
### 2. 部署 Skills
将 QQ 相关的 Skill 复制到 agent 的 skills 目录:
#### 3b. 部署 Skills 到 agent skills 目录
```bash
cp -r skills/qq-messenger /path/to/agent/skills/
@ -182,7 +268,7 @@ cp -r skills/qq-resolver /path/to/agent/skills/
cp -r skills/qq-napcat-extras /path/to/agent/skills/
```
### 3. 替换占位符
#### 3c. 替换占位符
编辑各脚本开头的配置变量,将占位符替换为实际值:
@ -194,7 +280,7 @@ GATEWAY_URL = "http://127.0.0.1:18789" # OpenClaw Gateway
GATEWAY_TOKEN = "YOUR_GATEWAY_TOKEN" # Gateway 鉴权 Token
```
### 4. 验证
#### 3d. 验证
在 agent 工作区尝试执行单个脚本确认连通性: