AstrBot NapCat 傻瓜式部署将 AstrBotQQ 机器人框架和 NapCatQQ 协议适配器整合到一个免安装的便携包里双击即可启动无需安装 Python。文件下载地址通过网盘分享的文件astrbot.zip链接: https://pan.baidu.com/s/1DN6mYklfhkehjy_9lINPMQ?pwd4uhd 提取码: 4uhd--来自百度网盘超级会员v5的分享 项目结构astrbot/ ├── 一键启动.bat ← ⭐ 双击这个同时启动 NapCat AstrBot ├── setup.bat ← 首次初始化自动下载便携 Python 装依赖 ├── README.md ← 本文档 ├── python-embed/ ← 内置便携版 Python 3.12已装好 AstrBot 全部依赖 ├── AstrBotLauncher-0.3.0/ │ └── AstrBotLauncher-0.3.0/AstrBot/ │ ├── main.py │ └── data/ ← AstrBot 配置/数据库 └── NapCat.Shell.Windows.OneKey/ └── NapCat.44498.Shell/ ├── NapCatWinBootMain.exe └── versions/9.9.26-44498/resources/app/napcat/ ├── config/ ├── cache/ └── logs/ 常用地址收藏到浏览器服务地址NapCat 配置面板http://127.0.0.1:6099/webui?token0cb14e3654d6AstrBot 管理面板http://127.0.0.1:6185反向 WebSocketws://localhost:6199/wsToken0cb14e3654d6是 NapCat 本地面板密码跟 QQ 号无关换号也不变。 快速上手首次使用首次解压后双击一键启动.bat等待两个窗口弹出NapCat 窗口显示 NapCat 启动日志 WebUI 地址 QQ 登录二维码AstrBot 窗口显示 AstrBot 启动日志 管理面板地址后续使用直接双击一键启动.bat即可已登录过的 QQ 会自动重连。 首次配置流程第一步登录 NapCat启动后NapCat 窗口会显示[info] [WebUi] WebUi Token: 0cb14e3654d6 [info] [WebUi] WebUi User Panel Url: http://127.0.0.1:6099/webui?token0cb14e3654d6 [info] 等待网络连接... [info] 网络已连接 [info] 没有 -q 指令指定快速登录将使用二维码登录方式 [warn] 请扫描下面的二维码然后手Q上授权登录 (QR code ASCII art)三种方式扫码登录方式操作WebUI 扫码浏览器打开http://127.0.0.1:6099/webui?tokentoken界面里扫码控制台二维码直接用手机 QQ 扫 NapCat 窗口里 ASCII 画出来的二维码终端字体需支持 UTF-8缓存图片扫码图片保存在NapCat.44498.Shell/versions/9.9.26-44498/resources/app/napcat/cache/qrcode.png双击打开扫解码 URL复制窗口里二维码解码URL到任何二维码生成网站草料二维码等生成后扫码快速登录之前登录过的号下次启动 NapCat 时如果同一个 QQ 号之前登录过会直接跳过扫码、自动登录。第二步登录 AstrBot 管理面板AstrBot 窗口启动后会显示管理面板地址格式类似[INFO] Dashboard running at http://0.0.0.0:6185 [INFO] Username: astrbot [INFO] Initial password: 首次启动时生成的随机密码首次启动 AstrBot 时会在控制台打印初始密码在 AstrBot 窗口里找用这个密码登录http://127.0.0.1:6185 账号: astrbot 密码: AstrBot 窗口里显示的初始密码⚠️ 忘了初始密码删除AstrBot/data/cmd_config.json后重启 AstrBot会重新生成新密码。第三步配置 NapCat → AstrBot 的 WebSocket 连接让 NapCat 把 QQ 收到的消息转发给 AstrBot。1. 打开 NapCat WebUIhttp://127.0.0.1:6099/webui?tokenNapCat 启动时显示的 Token2. 添加 WebSocket ClientNapCat 作为客户端连接到 AstrBot进入 WebUI →网络配置→WebSocket Client→新增按下面填写字段值说明启用✅ ON必须启用开启Debug⬜ OFF默认关闭名称astrbot任意识别名URLws://localhost:6199/wsAstrBot 默认监听端口上报自身消息⬜ OFF不上报自己发的消息消息格式Array数组格式TokenAstrBot 的 ws_reverse_token留空则不验证详见下方心跳间隔3000030 秒重连间隔3000030 秒SSL证书验证✅ ON验证 SSLlocalhost 关闭也行配图示例点保存。3. 获取 AstrBot 的 ws_reverse_token在 AstrBot 配置里设置反向 WebSocket token让 NapCat 和 AstrBot 互相认证打开 AstrBot 管理面板http://127.0.0.1:6185进入配置→ 找到aiocqhttp/QQ平台配置或 Platform 配置里的 OneBot11 反向 WS设置ws_reverse_token任意字符串例如astrbot_secret_123保存并重启 AstrBot把这个 token 填到 NapCat WebUI 的Token字段里 如果 NapCat 端 Token 留空AstrBot 端ws_reverse_token也要留空两边必须一致。第四步测试AstrBot 窗口日志里出现[OneBot11] connected类似的连接成功消息用手机 QQ 给登录的 QQ 号发消息AstrBot 应该回复了 关键端口和地址速查服务地址用途NapCat WebUIhttp://127.0.0.1:6099/webui?token0cb14e3654d6NapCat 配置面板Token 固定不变AstrBot Dashboardhttp://127.0.0.1:6185AstrBot 管理面板AstrBot ↔ NapCatws://localhost:6199/ws反向 WebSocket 连接Token0cb14e3654d6是 NapCat 本地面板的访问密码存在webui.json里。它不是 QQ 登录的 token换 QQ 号也不会变。 文件作用说明文件作用一键启动.bat启动入口先起 NapCat再起 AstrBotsetup.bat首次初始化下载便携 Python、装 AstrBot 依赖python-embed/内置 Python 3.12 pip AstrBot 全部依赖python-embed/python312._pth嵌入式 Python 配置启用 site-packagespython-embed/Lib/site-packages/astrbot.pth让 Python 找到 AstrBot 源码AstrBot/data/cmd_config.jsonAstrBot 全部配置含面板密码、API key 等NapCat/.../config/webui.jsonNapCat WebUI 配置含 TokenNapCat/.../config/napcat.jsonNapCat 通用配置日志级别等