docs: 重写部署指南,覆盖完整三层架构(NapCat → qqrebot → OpenClaw)
- 架构概览(拓扑图) - 第1步:NapCat / go-cqhttp 部署 - 第2步:qqrebot 本体部署(含 systemd 服务) - 第3步:OpenClaw Agent 端部署
This commit is contained in:
104
README.md
104
README.md
@ -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 账号并与腾讯服务器通信。
|
||||
|
||||
- NapCat:https://napcat.napneko.com/
|
||||
- go-cqhttp:https://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 工作区尝试执行单个脚本确认连通性:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user