NapCat QQ Bridge Installer 概述
使用此技能为 Windows 主机构建本地 QQ 机器人栈，围绕 NTQQ、NapCat 和通过 WSL + Docker 运行的 OpenClaw 代理。该技能是脚本驱动的。建议使用捆绑的 Python 入口点，而不是手动重写设置流程：scripts/manage.py
该脚本可以：
使用 winget 安装 NTQQ（如果 QQ 缺失）
从 GitHub 下载最新的公开 NapCat 版本
覆盖本地 bridge.mjs、start-all.bat 和 stop-all.bat
生成 config/bridge.json 和 config/onebot11_.json
引导基本的 OpenClaw Docker 容器（如果请求）
启动、停止、修复、健康检查和烟雾测试桥接器
何时使用
当用户请求以下任何内容时使用此技能：
在 Windows 上安装 QQ 机器人
将 NapCat 连接到 OpenClaw
自动下载 NTQQ/NapCat
修复损坏的 QQ 桥接器
启动或停止现有的 NapCat + OpenClaw 运行时
验证 QQ 回复是否仍在流动
不要将此技能用于官方 QQ API 或云托管的机器人平台。这是用于本地非官方自动化的 NapCat。
主机先决条件
预计以下主机工具存在或可按需安装：
具有 Python 3 的 Windows（作为 python 可用）
winget 用于安装 Tencent.QQ.NT
WSL 内的 wsl.exe 和 Docker
捆绑脚本使用的下载源：
https://api.github.com/repos/NapNeko/NapCatQQ/releases/latest
winget install --id Tencent.QQ.NT --exact
工作流程
默认运行时根目录：C:\Users\\NapCat.OpenClaw
如果用户已经有一个提取的 NapCat 运行时，请将 -Root 指向该文件夹，并更喜欢修复而不是安装。
典型安装：python .\scripts\manage.py -Action install -Root C:\Bots\NapCat.OpenClaw -BotQq 123456789 -AdminQq 987654321 -GroupIds 123456,234567 -BootstrapOpenClaw
典型修复：python .\scripts\manage.py -Action repair -Root C:\Bots\NapCat.OpenClaw -BotQq 123456789
启动/停止/健康/烟雾测试：python .\scripts\manage.py -Action start -Root C:\Bots\NapCat.OpenClaw
python .\scripts\manage.py -Action stop -Root C:\Bots\NapCat.OpenClaw
python .\scripts\manage.py -Action health -Root C:\Bots\NapCat.OpenClaw
python .\scripts\manage.py -Action smoke-test -Root C:\Bots\NapCat.OpenClaw
如果 OpenClaw 容器是新的或未经身份验证，用户仍需要一个浏览器登录步骤用于 openai-codex。
使用：python .\scripts\manage.py -Action auth -Root C:\Bots\NapCat.OpenClaw
该操作打开一个终端，显示推荐的入职命令。不要承诺完全无人值守的 OAuth 登录。
安装或修复后，始终运行：health smoke-test
如果用户已经有一个活跃的 QQ 会话，更喜欢私人消息自测试到配置的管理员 QQ。
安全性和发布约束
此技能是公开的。永远不要将真实的 QQ 号码、群组 ID、令牌、容器身份验证 blob 或本地密钥硬编码到发布的文件中。
在安装时在 config/bridge.json 和 config/onebot11_.json 中生成本地令牌。
为 NapCat 快速登录回退生成 config/.env 和 config/webui.json 值。
不要发布真实的运行时密钥。
从公共运行时源在执行时下载 NTQQ 和 NapCat。
不要将供应商二进制文件捆绑到技能中。
如果 OpenClaw 容器已经存在，请就地修复它，而不是删除用户数据。
不要假设快速登录可以绕过每个 QQ 验证挑战。QQ 可能仍需要一个新的验证步骤。
捆绑资源
scripts/manage.py：安装、身份验证、启动、停止、修复、健康和烟雾测试的主要入口点
assets/runtime/bridge.mjs：通用的 Windows 主机桥接器，用于与 NapCat 通信并通过 wsl docker exec ... 调用 OpenClaw 代理
assets/runtime/start-all.bat.txt：渲染到运行时根目录
assets/runtime/stop-all.bat.txt：渲染到运行时根目录
by