docs: README 增加 AI Agent 部署章节（脚本/Skill/占位符替换）

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. **解耦设计**：插件与核心系统完全解耦