From cee3ed882b66d9244d6cee0ed3be88b75ff426ac Mon Sep 17 00:00:00 2001
From: Claw <claw@local>
Date: Mon, 4 May 2026 18:38:10 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E9=87=8D=E5=86=99=E9=83=A8=E7=BD=B2?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97=EF=BC=8C=E8=A6=86=E7=9B=96=E5=AE=8C=E6=95=B4?=
 =?UTF-8?q?=E4=B8=89=E5=B1=82=E6=9E=B6=E6=9E=84=EF=BC=88NapCat=20=E2=86=92?=
 =?UTF-8?q?=20qqrebot=20=E2=86=92=20OpenClaw=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 架构概览（拓扑图）
- 第1步：NapCat / go-cqhttp 部署
- 第2步：qqrebot 本体部署（含 systemd 服务）
- 第3步：OpenClaw Agent 端部署
---
 README.md | 104 +++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 95 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 1f908e9..274882d 100755
--- a/README.md
+++ b/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 工作区尝试执行单个脚本确认连通性：