diff --git a/README-WINDOWS.md b/README-WINDOWS.md
new file mode 100644
index 0000000..1b2a738
--- /dev/null
+++ b/README-WINDOWS.md
@@ -0,0 +1,825 @@
+# OpenClaw Bridge — Windows 部署指南
+
+> 本文档是 [README.md](./README.md) 的 Windows 版。架构和原理完全一致，针对 **Windows 10/11** 平台调整部署流程。
+>
+> **核心差异速览：**
+>
+> | 组件 | Linux 部署 | Windows 部署 |
+> |---|---|---|
+> | NapCat | Docker 容器 | **原生 NapCatQQ（桌面应用）** |
+> | qqrebot | systemd 服务 | **NSSM / Task Scheduler 注册为服务** |
+> | OpenClaw | systemd 服务 | **NSSM 注册为服务** |
+> | Python venv | `source .venv/bin/activate` | `.venv\Scripts\activate` |
+> | 路径风格 | `/opt/...` | `C:\ProgramData\ChatBot\...` |
+> | 打包脚本 | `packup.sh` | **`packup.bat`（已有）** |
+> | QQ 登录 | Docker 扫码 + WebUI | **原生 QQ 窗口 + 托盘扫码** |
+>
+> **脚本全是 Python**（`requests` + `jieba`），Windows / Linux 完全一致，不需要额外适配。
+
+---
+
+## 架构（不变）
+
+```
+QQ 用户  →→→  NapCatQQ（原生 Windows 版）
+                │
+                │  HTTP POST（事件推送 → localhost:25580）
+                ▼
+          qqrebot（HTTP Server :25580）
+                │
+                ├── 执行 openclaw_bridge 插件
+                │        │
+                │        │  HTTP POST /v1/chat/completions
+                │        ▼
+                │   OpenClaw Gateway（:18789）
+                │        │
+                │        ▼
+                │   qq-agent（AI 模型）
+                │        │
+                ◄── 返回回复文本 ──┘
+                │
+                │  HTTP POST（send_private_msg / send_group_msg）
+                ▼
+          NapCatQQ（原生）→ 回复发送到 QQ
+```
+
+---
+
+## 前提条件检查清单
+
+### 需要提前安装的软件
+
+| 软件 | 版本要求 | 下载 |
+|---|---|---|
+| **Python** | 3.10+ | [python.org](https://www.python.org/downloads/) |
+| **Node.js** | 18+ | [nodejs.org](https://nodejs.org/) |
+| **OpenClaw Gateway** | 最新 | [docs.openclaw.ai](https://docs.openclaw.ai) |
+| **NSSM**（推荐） 或 Task Scheduler | — | [nssm.cc/download](https://nssm.cc/download) |
+| **Git** | 任意 | [git-scm.com](https://git-scm.com/) |
+| **7-Zip**（可选）| — | [7-zip.org](https://7-zip.org/) |
+
+> 安装 Python 时务必勾选 **"Add Python to PATH"**。
+
+### 确认安装
+
+打开 **PowerShell（管理员）** 执行：
+
+```powershell
+python --version           # 应 ≥ 3.10
+node --version             # 应 ≥ 18
+git --version
+nssm --version             # 如用 NSSM
+```
+
+### 端口确认
+
+| 端口 | 用途 | 是否需放行防火墙 |
+|---|---|---|
+| **18789** | OpenClaw Gateway | 否（仅本地通信） |
+| **25580** | qqrebot HTTP 服务 | 否（仅本地通信） |
+| **6097** | NapCat HTTP API | 否（仅本地通信） |
+| **6099** | NapCat WebUI（可选） | 仅在局域网需远程扫码时开放 |
+
+> Windows Defender 防火墙通常不拦截 `127.0.0.1` 通信，一般无需额外规则。
+
+---
+
+## 第1步：规划目录结构
+
+> 使用统一的根目录 `C:\ProgramData\ChatBot`，方便管理和备份。
+
+```powershell
+# 创建工作目录
+mkdir C:\ProgramData\ChatBot\napcat-config -Force
+mkdir C:\ProgramData\ChatBot\napcat-data -Force
+mkdir C:\ProgramData\ChatBot\qqrebot -Force
+mkdir C:\ProgramData\ChatBot\qqrebot\plugins -Force
+mkdir C:\ProgramData\ChatBot\qqrebot\config -Force
+
+echo "目录结构已创建 ✅"
+```
+
+---
+
+## 第2步：部署 NapCatQQ（原生 Windows 版）
+
+### 2.1 NapCat 是什么
+
+NapCat 是 QQ 协议实现，接收 QQ 消息并通过 HTTP POST 推送到 qqrebot。
+Windows 版是**原生桌面应用**（非 Docker），使用你自己的 QQ 客户端。
+
+### 2.2 下载安装 NapCat Shell 版本
+
+NapCat 提供 Shell 版（无 GUI，后台运行），以及 GUI 版（有界面）。
+
+**推荐方式**：使用 Shell 版本 + 一键安装脚本
+
+```powershell
+# 1. 进入数据目录
+cd C:\ProgramData\ChatBot
+
+# 2. 下载 NapCat Shell 安装脚本
+#    从 NapCat 官方仓库获取
+Invoke-WebRequest -Uri "https://github.com/NapNeko/NapCatQQ/releases/latest/download/NapCat.Shell.zip" -OutFile "NapCat.Shell.zip"
+
+# 3. 解压
+Expand-Archive -Path "NapCat.Shell.zip" -DestinationPath "C:\ProgramData\ChatBot\napcat" -Force
+
+# 4. 安装依赖（npm 方式）
+cd C:\ProgramData\ChatBot\napcat
+npm install
+```
+
+> 如果 GitHub 下载慢，也可从官方 QQ 群 / 镜像站下载。
+
+### 2.3 配置 onebot11.json
+
+NapCat 的 Windows 版配置文件位置：`C:\ProgramData\ChatBot\napcat\config\onebot11.json`
+
+```powershell
+$config = @'
+{
+  "network": {
+    "httpServers": [
+      {
+        "name": "http-server",
+        "enable": true,
+        "host": "0.0.0.0",
+        "port": 6097,
+        "token": "",
+        "enableCors": true,
+        "debug": false
+      }
+    ],
+    "httpClients": [
+      {
+        "name": "http-post",
+        "enable": true,
+        "url": "http://127.0.0.1:25580/",
+        "messagePostFormat": "array",
+        "reportSelfMessage": false,
+        "token": "",
+        "debug": false
+      }
+    ],
+    "websocketServers": [],
+    "websocketClients": []
+  },
+  "musicSignUrl": "",
+  "enableLocalFile2Url": true,
+  "parseMultMsg": false
+}
+'@
+
+$config | Out-File -FilePath "C:\ProgramData\ChatBot\napcat\config\onebot11.json" -Encoding utf8
+Write-Host "onebot11.json 已创建 ✅"
+```
+
+### 2.4 启动 NapCat + QQ 登录
+
+**NapCat Shell 版启动方式：**
+
+```powershell
+cd C:\ProgramData\ChatBot\napcat
+.\napcat.bat
+```
+
+首次启动会引导扫码登录 QQ。你需要：
+1. 看到终端输出二维码 URL（或截图二维码保存到本地）
+2. 用手机 QQ 扫码登录
+3. 登录后 NapCat 会自动保持在线，窗口可以最小化
+
+### 2.5 验证 HTTP API
+
+```powershell
+# 登录成功后验证
+Invoke-RestMethod -Uri "http://127.0.0.1:6097/get_version_info" -Method Get
+# 预期：返回 {"status": "ok", "data": {"app_name": "NapCat", ...}}
+```
+
+> 如果上一步报错，说明 NapCat 尚未完成 QQ 登录。请等待登录后再试。
+
+---
+
+## 第3步：克隆本仓库
+
+```powershell
+cd C:\ProgramData\ChatBot
+
+git clone ssh://git@jianfgit.xyz:220/jianf/chatrebot_aireply_plug.git
+
+# 验证
+ls C:\ProgramData\ChatBot\chatrebot_aireply_plug\README.md
+```
+
+---
+
+## 第4步：部署 qqrebot
+
+### 4.1 下载 qqrebot（Windows 版）
+
+> **qqrebot 是 Go 语言编写的跨平台 HTTP Server，支持 Windows。**
+
+```powershell
+cd C:\ProgramData\ChatBot\qqrebot
+
+# 从仓库下载 qqrebot Windows 版本
+# 如果已有 qqrebot 的 Windows exe，直接复制到此目录
+# 或从 https://jianfgit.xyz/ 下载
+Invoke-WebRequest -Uri "https://jianfgit.xyz/jianf/chat_rebot-connect-with-onebot-standard-/archive/chatrebot1.0.tar.gz" -OutFile "chatrebot1.0.tar.gz"
+
+# 解压（tar 在较新 Windows 10/11 已内置，如没有则用 7-Zip）
+tar -xzf chatrebot1.0.tar.gz
+Copy-Item -Recurse "chat_rebot-connect-with-onebot-standard-\*" "C:\ProgramData\ChatBot\qqrebot\" -Force
+Remove-Item -Recurse "chat_rebot-connect-with-onebot-standard-" -Force
+Remove-Item "chatrebot1.0.tar.gz" -Force
+```
+
+### 4.2 配置 qqrebot
+
+```powershell
+$config = @'
+[app]
+list_port = 25580
+send_url = "http://127.0.0.1:6097"
+
+[rebot]
+id = ""
+
+[plugins]
+dir = ["plugins"]
+'@
+
+$config | Out-File -FilePath "C:\ProgramData\ChatBot\qqrebot\config\config.toml" -Encoding utf8
+Write-Host "config.toml 已创建 ✅"
+```
+
+### 4.3 用 NSSM 将 qqrebot 注册为 Windows 服务
+
+```powershell
+# 注意：以下命令需在管理员 PowerShell 中执行
+# qqrebot 的启动入口通常是 run.sh（bash），Windows 版对应 .exe
+# 请确认 qqrebot Windows exe 文件名，假设为 qqrebot.exe
+
+# 先检查 qqrebot 目录下有哪些可执行文件
+ls C:\ProgramData\ChatBot\qqrebot\*.exe
+
+# --- 假设主程序为 qqrebot.exe ---
+nssm install qqrebot "C:\ProgramData\ChatBot\qqrebot\qqrebot.exe"
+
+# 设置工作目录
+nssm set qqrebot AppDirectory "C:\ProgramData\ChatBot\qqrebot"
+
+# 设置自动重启
+nssm set qqrebot AppRestartDelay 3000
+
+# 启动服务
+nssm start qqrebot
+
+Write-Host "qqrebot 服务已注册并启动 ✅"
+```
+
+> ⚠️ 如果 `qqrebot.exe` 不存在（原版可能是 Python 脚本或其他方式启动），请改用方案二：
+
+**方案二：使用 run.bat + 开机自启**
+
+```powershell
+# 创建 Windows 启动脚本
+$runBat = @'
+@echo off
+cd /d "C:\ProgramData\ChatBot\qqrebot"
+qqrebot.exe
+'@
+$runBat | Out-File -FilePath "C:\ProgramData\ChatBot\qqrebot\run.bat" -Encoding ascii
+
+# 添加到开机启动（当前用户）
+$WshShell = New-Object -ComObject WScript.Shell
+$Shortcut = $WshShell.CreateShortcut("$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\qqrebot.lnk")
+$Shortcut.TargetPath = "C:\ProgramData\ChatBot\qqrebot\run.bat"
+$Shortcut.WorkingDirectory = "C:\ProgramData\ChatBot\qqrebot"
+$Shortcut.Save()
+Write-Host "已添加到开机启动 ✅"
+```
+
+### 4.4 验证 qqrebot 运行
+
+```powershell
+# 检查服务状态（NSSM）
+nssm status qqrebot
+
+# 检查端口监听
+netstat -ano | findstr :25580
+# 预期：TCP 0.0.0.0:25580  LISTENING
+```
+
+---
+
+## 第5步：打包并部署 openclaw_bridge 插件
+
+### 5.1 打包插件
+
+> 仓库中已有 `packup.bat`，直接使用即可。
+
+```powershell
+cd C:\ProgramData\ChatBot\chatrebot_aireply_plug
+
+# 创建并激活 Python 虚拟环境
+python -m venv .venv
+.\.venv\Scripts\activate
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 打包
+python dependence.py
+python package.py
+
+# 检查打包结果
+ls dist\
+# 预期：dist\openclaw_bridge.zip
+```
+
+### 5.2 部署到 qqrebot
+
+```powershell
+Copy-Item -Path "C:\ProgramData\ChatBot\chatrebot_aireply_plug\dist\openclaw_bridge.zip" `
+          -Destination "C:\ProgramData\ChatBot\qqrebot\plugins\"
+
+# 验证
+ls C:\ProgramData\ChatBot\qqrebot\plugins\
+```
+
+### 5.3 创建插件配置
+
+```powershell
+# ⚠️ 以下值需要根据你的实际情况修改！
+# allowed_sender → 你的 QQ 号
+# gateway_token → 从 OpenClaw 配置中获取
+
+$pluginConfig = @'
+[openclaw]
+gateway_url      = "http://127.0.0.1:18789"
+gateway_token    = "你的GatewayToken"
+allowed_sender   = "你的QQ号"
+model            = "openclaw/qq-agent"
+agent_id         = "qq-agent"
+'@
+
+# 创建配置目录
+New-Item -ItemType Directory -Path "C:\ProgramData\ChatBot\qqrebot\config\openclawbridge" -Force
+
+$pluginConfig | Out-File -FilePath "C:\ProgramData\ChatBot\qqrebot\config\openclawbridge\config.toml" -Encoding utf8
+Write-Host "插件配置已创建 ✅"
+```
+
+### 5.4 重启 qqrebot
+
+```powershell
+# 方式一：NSSM 服务
+nssm restart qqrebot
+
+# 方式二：任务管理器结束进程，重新运行 run.bat
+
+# 查看 qqrebot 日志
+# NSSM 服务默认日志在 C:\ProgramData\ChatBot\qqrebot\logs\
+
+# 验证插件加载
+Get-Content "C:\ProgramData\ChatBot\qqrebot\log\*.log" -Tail 20
+# 预期看到：Config loaded: url=http://127.0.0.1:18789, allowed=123456789
+```
+
+> 清理旧版（如果之前部署过）：
+> ```powershell
+> Remove-Item "C:\ProgramData\ChatBot\qqrebot\plugins\openclaw_bridge" -Recurse -Force -ErrorAction SilentlyContinue
+> ```
+> 插件是 ZIP 格式，删除旧目录后重启 qqrebot 即可加载新包。
+
+---
+
+## 第6步：部署 OpenClaw Gateway
+
+### 6.1 安装 OpenClaw（Windows）
+
+```powershell
+# OpenClaw 基于 Node.js，Windows 直接安装
+npm install -g openclaw
+```
+
+> 如果使用官方安装器，按照文档指引操作。OpenClaw 在 Windows 上完全可用。
+
+### 6.2 配置 OpenClaw
+
+> ~~假设已有运行中的 OpenClaw Gateway~~，以下是创建新 agent 的步骤。
+
+创建 agent workspace：
+
+```powershell
+$agentId = "qq-agent"
+$workspace = "C:\ProgramData\ChatBot\$agentId-workspace"
+
+New-Item -ItemType Directory -Path "$workspace\scripts" -Force
+New-Item -ItemType Directory -Path "$workspace\skills" -Force
+New-Item -ItemType Directory -Path "$workspace\memory" -Force
+New-Item -ItemType Directory -Path "$workspace\files" -Force
+
+Write-Host "Agent workspace 已创建: $workspace ✅"
+```
+
+添加 agent 到 OpenClaw 配置：
+
+```powershell
+# 读取 OpenClaw 配置
+$configPath = "$env:USERPROFILE\.openclaw\openclaw.json"
+$cfg = Get-Content $configPath -Raw | ConvertFrom-Json
+
+# 添加 agent（如果不存在）
+$exists = $cfg.agents.list | Where-Object { $_.id -eq "qq-agent" }
+if (-not $exists) {
+    $agent = @{
+        id = "qq-agent"
+        name = "qq-agent"
+        model = "kimi/kimi-for-coding"
+        workspace = "C:\ProgramData\ChatBot\qq-agent-workspace"
+    }
+    $cfg.agents.list += $agent
+    $cfg | ConvertTo-Json -Depth 10 | Set-Content $configPath
+    Write-Host "Agent qq-agent 已添加 ✅"
+} else {
+    Write-Host "Agent qq-agent 已存在，跳过"
+}
+```
+
+### 6.3 用 NSSM 注册 OpenClaw 服务（可选）
+
+```powershell
+# 找到 openclaw.cmd 路径
+$ocPath = (Get-Command openclaw).Source
+
+nssm install openclaw-gateway $ocPath
+nssm set openclaw-gateway AppParameters "gateway start"
+nssm set openclaw-gateway AppDirectory $env:USERPROFILE
+nssm set openclaw-gateway AppRestartDelay 3000
+nssm start openclaw-gateway
+
+Write-Host "OpenClaw Gateway 已注册为服务 ✅"
+```
+
+---
+
+## 第7步：部署脚本和 Skills
+
+### 7.1 复制脚本
+
+```powershell
+$workspace = "C:\ProgramData\ChatBot\qq-agent-workspace"
+$repoRoot = "C:\ProgramData\ChatBot\chatrebot_aireply_plug"
+
+Copy-Item -Path "$repoRoot\scripts\*" -Destination "$workspace\scripts\" -Recurse -Force
+Write-Host "脚本已复制: $( (ls $workspace\scripts).Count ) 个"
+```
+
+### 7.2 复制 Skills
+
+```powershell
+$skills = @("qq-messenger", "qq-management", "qq-resolver", "qq-napcat-extras", "mc-query", "nix-helper", "browser", "file-process")
+
+foreach ($skill in $skills) {
+    $src = "$repoRoot\skills\$skill"
+    if (Test-Path $src) {
+        Copy-Item -Path $src -Destination "$workspace\skills\" -Recurse -Force
+        Write-Host "已复制: $skill"
+    } else {
+        Write-Host "⚠️ 不存在: $skill"
+    }
+}
+```
+
+### 7.3 替换占位符
+
+```powershell
+$workspace = "C:\ProgramData\ChatBot\qq-agent-workspace"
+
+# ⚠️ 替换为你的实际值
+$ADMIN_QQ = "你的QQ号"
+$NAPCAT_URL = "127.0.0.1:6097"
+$GATEWAY_TOKEN = "你的GatewayToken"
+
+# PowerShell 替换脚本中的占位符
+Get-ChildItem -Path "$workspace\scripts\*.py" | ForEach-Object {
+    (Get-Content $_.FullName) -replace 'YOUR_NAPCAT_HOST:25570', $NAPCAT_URL `
+                               -replace 'YOUR_ADMIN_QQ', $ADMIN_QQ `
+                               -replace 'YOUR_GATEWAY_TOKEN', $GATEWAY_TOKEN `
+                               -replace 'YOUR_WORKSPACE_PATH', $workspace `
+                               -replace 'YOUR_SHARED_DIR', "C:\ProgramData\ChatBot\shared" | 
+    Set-Content $_.FullName
+}
+
+# 替换 Skills 中的占位符
+Get-ChildItem -Path "$workspace\skills\*\SKILL.md" | ForEach-Object {
+    (Get-Content $_.FullName) -replace 'YOUR_WORKSPACE_PATH', $workspace `
+                               -replace 'YOUR_ADMIN_QQ', $ADMIN_QQ | 
+    Set-Content $_.FullName
+}
+
+Write-Host "占位符替换完毕 ✅"
+```
+
+---
+
+## 第8步：端到端验证
+
+### 验证检查清单
+
+```powershell
+Write-Host "========== 端到端验证 =========="
+
+# 1. NapCat 是否运行
+try {
+    $ver = Invoke-RestMethod -Uri "http://127.0.0.1:6097/get_version_info" -Method Get
+    Write-Host "✅ NapCat: $($ver.data.app_name) v$($ver.data.app_version)"
+} catch {
+    Write-Host "❌ NapCat 不可达"
+}
+
+# 2. qqrebot 是否运行
+try {
+    $tcp = netstat -ano | findstr :25580
+    if ($tcp) { Write-Host "✅ qqrebot: 端口 25580 监听中" } else { Write-Host "❌ qqrebot 端口未监听" }
+} catch {
+    Write-Host "❌ 无法检查 qqrebot"
+}
+
+# 3. OpenClaw Gateway 是否运行
+try {
+    $oc = Invoke-RestMethod -Uri "http://127.0.0.1:18789/v1/models" -Method Get
+    Write-Host "✅ OpenClaw Gateway: 可访问"
+} catch {
+    Write-Host "❌ OpenClaw Gateway 不可达"
+}
+
+Write-Host "================================"
+```
+
+### 发一条测试消息
+
+在 QQ 上给机器人发一条消息，然后检查日志：
+
+```powershell
+# 查看 qqrebot 日志
+Get-Content "C:\ProgramData\ChatBot\qqrebot\log\*.log*" -Tail 20
+
+# 查看 OpenClaw 日志
+Get-Content "$env:USERPROFILE\.openclaw\logs\*" -Tail 20
+```
+
+---
+
+## Windows 特有注意事项
+
+### 1. 路径分隔符
+
+Python 脚本使用 `Path` 类（如 `pathlib`），**Windows 和 Linux 都兼容**。
+但在 `.py` 脚本中硬编码路径时，建议使用 `os.path.join()` 或 `Path()`：
+
+```python
+# ❌ 不要
+shared_dir = "/opt/napcat_shared"
+
+# ✅ 好
+from pathlib import Path
+shared_dir = Path("C:/ProgramData/ChatBot/shared")
+```
+
+### 2. 虚拟环境激活
+
+```powershell
+# Windows PowerShell / CMD
+.\.venv\Scripts\activate
+
+# Linux
+source .venv/bin/activate
+```
+
+### 3. 环境变量
+
+```powershell
+# PowerShell
+$env:MY_VAR = "value"
+
+# CMD
+set MY_VAR=value
+```
+
+### 4. 文件共享路径
+
+NapCat 原生 Windows 版无需共享目录映射。脚本中如果涉及文件传输：
+
+- `qq_send_file.py` → 直接用本地绝对路径发文件
+- `qq_ocr_image.py` → 图片路径用 Windows 格式（`C:\...`）
+- NapCat Windows 版可直接访问本地文件系统，无需 `Docker volume`
+
+### 5. 开机自启
+
+推荐两种方式：
+
+**方式一：NSSM 注册为服务（推荐）**
+```powershell
+nssm install <服务名> <程序路径>
+```
+
+**方式二：添加到开机启动文件夹**
+```powershell
+shell:startup
+# 将 qqrebot 和 napcat 的快捷方式拖入
+```
+
+**方式三：Windows Task Scheduler**
+- 触发器：系统启动时
+- 操作：启动程序
+- 适用于需要延迟启动的场景
+
+### 6. 日志管理
+
+Windows 无 `journalctl`，使用以下替代：
+
+```powershell
+# NSSM 服务日志
+# 默认在 C:\ProgramData\ChatBot\qqrebot\logs\
+Get-Content ".\logs\*.log" -Tail 100
+
+# OpenClaw 日志
+Get-Content "$env:USERPROFILE\.openclaw\logs\openclaw.log" -Tail 100
+
+# 实时跟踪（类似 tail -f）
+Get-Content ".\logs\qqrebot.log" -Tail 10 -Wait
+```
+
+### 7. 防火墙
+
+NapCat 监听 `0.0.0.0:6097`，如需从局域网其他设备访问（如 WebUI 扫码）：
+
+```powershell
+# 放行端口（管理员 PowerShell）
+New-NetFirewallRule -DisplayName "NapCat HTTP API" -Direction Inbound -LocalPort 6097 -Protocol TCP -Action Allow
+New-NetFirewallRule -DisplayName "NapCat WebUI" -Direction Inbound -LocalPort 6099 -Protocol TCP -Action Allow
+```
+
+---
+
+## 常见问题（Windows 特有）
+
+### Q: NapCat 启动后闪退？
+- 确认已安装 QQ（NapCat Shell 版不依赖 QQ GUI，但需 QQ 协议库）
+- 使用完整版 NapCatQQ（带 GUI 的版本）
+- 检查日志文件：`C:\ProgramData\ChatBot\napcat\logs\`
+
+### Q: qqrebot 运行时报 "not a valid Win32 application"？
+- 确认下载的是 Windows 版（`.exe`）
+- 如果只有 Linux 版 qqrebot，可以用 **WSL** 运行，或将 qqrebot 重写为 Python 版本
+
+### Q: NSSM 安装后服务无法启动？
+```powershell
+# 查看错误详情
+nssm status qqrebot
+# 检查 Windows 事件查看器 > Windows 日志 > 应用程序
+
+# 或者直接前台运行确认程序本身没问题
+C:\ProgramData\ChatBot\qqrebot\qqrebot.exe
+```
+
+### Q: 路径中的反斜杠 `\` 被转义了？
+在 Python 字符串中的路径：
+- 用正斜杠：`"C:/ProgramData/ChatBot"` ✅
+- 用原始字符串：`r"C:\ProgramData\ChatBot"` ✅
+- 用 `pathlib`：`Path("C:/ProgramData/ChatBot")` ✅
+
+### Q: `git clone` 使用 SSH 在 Windows 上报错？
+```powershell
+# 1. 确保已配置 SSH key
+ssh-keygen -t ed25519 -C "你的邮箱"
+
+# 2. 添加到 ssh-agent
+Start-Service ssh-agent
+ssh-add $env:USERPROFILE\.ssh\id_ed25519
+
+# 3. 将公钥添加到 Git 服务器
+Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
+```
+
+### Q: 如何后台运行 qqrebot（不用 NSSM）？
+```powershell
+# 使用 Start-Process 在后台启动
+Start-Process -WindowStyle Hidden -FilePath "C:\ProgramData\ChatBot\qqrebot\qqrebot.exe"
+
+# 查看进程
+Get-Process qqrebot
+```
+
+---
+
+## 快速启动脚本（一键部署）
+
+将以下内容保存为 `deploy-windows.ps1`，在管理员 PowerShell 中执行：
+
+> ⚠️ 执行前请修改脚本中 `$ADMIN_QQ` 和 `$GATEWAY_TOKEN` 的值。
+
+```powershell
+# deploy-windows.ps1 — Windows 一键部署脚本
+# 使用前请修改以下两个变量
+$ADMIN_QQ = "你的QQ号"
+$GATEWAY_TOKEN = "你的GatewayToken"
+
+# ─── 配置 ───
+$BaseDir = "C:\ProgramData\ChatBot"
+$RepoUrl = "ssh://git@jianfgit.xyz:220/jianf/chatrebot_aireply_plug.git"
+$NapCatPortApi = 6097
+$NapCatPortWebUI = 6099
+$QqrebotPort = 25580
+$Workspace = "$BaseDir\qq-agent-workspace"
+$AgentId = "qq-agent"
+
+Write-Host "══════════════════════════════════════" -ForegroundColor Cyan
+Write-Host " OpenClaw Bridge — Windows 一键部署" -ForegroundColor Cyan
+Write-Host "══════════════════════════════════════" -ForegroundColor Cyan
+
+# 1. 创建目录
+Write-Host "`n[1/8] 创建目录..." -ForegroundColor Yellow
+@("", "\qqrebot\plugins", "\qqrebot\config", "\shared") | ForEach-Object {
+    New-Item -ItemType Directory -Path "$BaseDir$_" -Force | Out-Null
+}
+
+# 2. 克隆仓库
+Write-Host "`n[2/8] 克隆仓库..." -ForegroundColor Yellow
+if (!(Test-Path "$BaseDir\chatrebot_aireply_plug")) {
+    git clone $RepoUrl "$BaseDir\chatrebot_aireply_plug"
+} else {
+    Write-Host "  仓库已存在，跳过克隆"
+}
+
+# 3. 打包插件
+Write-Host "`n[3/8] 打包插件..." -ForegroundColor Yellow
+cd "$BaseDir\chatrebot_aireply_plug"
+if (!(Test-Path ".venv")) { python -m venv .venv }
+.\.venv\Scripts\activate
+pip install -r requirements.txt -q
+python dependence.py
+python package.py
+Copy-Item "dist\openclaw_bridge.zip" "$BaseDir\qqrebot\plugins\" -Force
+
+# 4. 配置插件
+Write-Host "`n[4/8] 配置插件..." -ForegroundColor Yellow
+$pluginConfig = @"
+[openclaw]
+gateway_url      = "http://127.0.0.1:18789"
+gateway_token    = "$GATEWAY_TOKEN"
+allowed_sender   = "$ADMIN_QQ"
+model            = "openclaw/$AgentId"
+agent_id         = "$AgentId"
+"@
+New-Item -ItemType Directory -Path "$BaseDir\qqrebot\config\openclawbridge" -Force | Out-Null
+$pluginConfig | Out-File "$BaseDir\qqrebot\config\openclawbridge\config.toml" -Encoding utf8
+
+# 5. 创建 Agent workspace
+Write-Host "`n[5/8] 创建 Agent workspace..." -ForegroundColor Yellow
+@("scripts", "skills", "memory", "files") | ForEach-Object {
+    New-Item -ItemType Directory -Path "$Workspace\$_" -Force | Out-Null
+}
+
+# 6. 复制脚本和 Skills
+Write-Host "`n[6/8] 复制脚本和 Skills..." -ForegroundColor Yellow
+Copy-Item "$BaseDir\chatrebot_aireply_plug\scripts\*" "$Workspace\scripts\" -Recurse -Force
+@("qq-messenger", "qq-management", "qq-resolver", "qq-napcat-extras", "browser", "file-process") | ForEach-Object {
+    $src = "$BaseDir\chatrebot_aireply_plug\skills\$_"
+    if (Test-Path $src) { Copy-Item $src "$Workspace\skills\" -Recurse -Force }
+}
+
+# 7. 替换占位符
+Write-Host "`n[7/8] 替换占位符..." -ForegroundColor Yellow
+Get-ChildItem "$Workspace\scripts\*.py" | ForEach-Object {
+    (Get-Content $_.FullName) -replace 'YOUR_NAPCAT_HOST:25570', "127.0.0.1:6097" `
+                               -replace 'YOUR_ADMIN_QQ', $ADMIN_QQ |
+    Set-Content $_.FullName
+}
+
+# 8. 添加 OpenClaw agent
+Write-Host "`n[8/8] 配置 OpenClaw agent..." -ForegroundColor Yellow
+$ocConfig = "$env:USERPROFILE\.openclaw\openclaw.json"
+if (Test-Path $ocConfig) {
+    $cfg = Get-Content $ocConfig -Raw | ConvertFrom-Json
+    $exists = $cfg.agents.list | Where-Object { $_.id -eq $AgentId }
+    if (!$exists) {
+        $agent = @{ id = $AgentId; name = $AgentId; model = "kimi/kimi-for-coding"; workspace = $Workspace }
+        $cfg.agents.list += $agent
+        $cfg | ConvertTo-Json -Depth 10 | Set-Content $ocConfig
+        Write-Host "  Agent 已添加 ✅"
+    }
+}
+
+Write-Host "`n══════════════════════════════════════" -ForegroundColor Green
+Write-Host " 部署完成！请手动完成以下步骤：" -ForegroundColor Green
+Write-Host "  1. 启动 NapCat: cd $BaseDir\napcat && .\napcat.bat（扫码登录QQ）" -ForegroundColor Yellow
+Write-Host "  2. 启动 qqrebot（NSSM 或手动）" -ForegroundColor Yellow
+Write-Host "  3. 重启 OpenClaw Gateway" -ForegroundColor Yellow
+Write-Host "  4. 验证：发 QQ 消息给机器人" -ForegroundColor Yellow
+Write-Host "══════════════════════════════════════" -ForegroundColor Green
+```