From 7d93fc3188fa5edec41c8f9adf6f6fdaa7d509fe Mon Sep 17 00:00:00 2001
From: Claw <claw@local>
Date: Mon, 4 May 2026 16:38:39 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E5=A2=9E=E5=8A=A0=20AI=20Agen?=
 =?UTF-8?q?t=20=E9=83=A8=E7=BD=B2=E7=AB=A0=E8=8A=82=EF=BC=88=E8=84=9A?=
 =?UTF-8?q?=E6=9C=AC/Skill/=E5=8D=A0=E4=BD=8D=E7=AC=A6=E6=9B=BF=E6=8D=A2?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 56 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 3577321..00ea325 100755
--- a/README.md
+++ b/README.md
@@ -137,21 +137,71 @@ my_plugin.zip
 
 ## 快速启动
 
-1. 为启动脚本授权(linux)：
+1. 为启动脚本授权（Linux）：
 
    ```bash
    chmod +x run.sh
    ```
-2. 修改配置文件，list_port为接收消息推送端口，send_url为消息发送地址
+
+2. 修改配置文件，`list_port` 为接收消息推送端口，`send_url` 为消息发送地址
+
 3. 运行启动脚本
-   linux下
 
-   `./run.sh`
+   Linux：
 
-   windows下
+   ```bash
+   ./run.sh
+   ```
 
-   `.\run.bat`
+   Windows：
 
+   ```bat
+   .\run.bat
+   ```
+
+## AI Agent 部署（OpenClaw）
+
+如需让 AI agent 主动操作 QQ（发消息、管理群、查信息等），需将脚本和 Skill 部署到 agent 的工作区。
+
+### 1. 部署脚本
+
+将 `scripts/` 目录复制到 qq-agent 工作区：
+
+```bash
+cp -r scripts/ /path/to/qq-agent/workspace/
+```
+
+### 2. 部署 Skills
+
+将 QQ 相关的 Skill 复制到 agent 的 skills 目录：
+
+```bash
+cp -r skills/qq-messenger     /path/to/agent/skills/
+cp -r skills/qq-management    /path/to/agent/skills/
+cp -r skills/qq-resolver      /path/to/agent/skills/
+cp -r skills/qq-napcat-extras /path/to/agent/skills/
+```
+
+### 3. 替换占位符
+
+编辑各脚本开头的配置变量，将占位符替换为实际值：
+
+```python
+# 需替换的占位符：
+ADMIN_QQ       = "YOUR_ADMIN_QQ"        # 你的 QQ 号
+CQHTTP_URL     = "http://YOUR_NAPCAT_HOST:25570"  # NapCat 地址
+GATEWAY_URL    = "http://127.0.0.1:18789"  # OpenClaw Gateway
+GATEWAY_TOKEN  = "YOUR_GATEWAY_TOKEN"    # Gateway 鉴权 Token
+```
+
+### 4. 验证
+
+在 agent 工作区尝试执行单个脚本确认连通性：
+
+```bash
+cd /path/to/qq-agent/workspace/scripts
+python3 qq_get_groups.py
+```
 ## 设计优势
 
 1. **解耦设计**：插件与核心系统完全解耦