QQ Bot 部署与配置笔记
本目录记录个人 QQ 聊天助手的部署过程。实际架构是：
个人 QQ -> NapCatQQ -> LangBot -> New API -> DeepSeek / CPA本笔记基于 2026-05 在腾讯云 OpenCloudOS 服务器上的实际部署整理。部署文件在：
/Users/Zhuanz/Documents/learn/qq-bot正式学习笔记放在本目录：
/Users/Zhuanz/Documents/learn/notes/qq-bot目录
| 文件 | 内容 |
|---|---|
| 01-overview.md | 架构、组件职责、风险边界 |
| 02-deploy.md | Docker Compose 部署、镜像拉取、代理配置 |
| 03-napcat.md | NapCat 登录 QQ、WebUI token、WebSocket 客户端 |
| 04-langbot.md | LangBot 初始化、模型、机器人、流水线 |
| 05-trigger-rules.md | 触发条件、群聊 @、No pipeline_uuid 排查 |
| 06-persona.md | “神盾局特工 26 号”人设提示词 |
| 07-multi-model-routing.md | DeepSeek + ChatGPT 多模型路由 |
| 08-memory-and-summary.md | 群聊总结、上下文、长期记忆 |
| 09-troubleshooting.md | 常见错误与解决方案 |
| 10-security.md | QQ 账号、后台端口、数据目录安全 |
| 11-image-generation.md | 生图插件、OpenAI 兼容接口、QQ 调用 |
快速回顾
- 在服务器
/root/qq-bot下用 Docker Compose 启动 NapCatQQ、LangBot、LangBot plugin runtime。 - NapCat
6099页面输入 token 后扫码登录 QQ。 - LangBot
5300页面初始化管理员账号。 - LangBot 模型配置接 New API，底层优先用
deepseek-chat。 - LangBot 机器人使用 OneBot v11，端口
2280。 - NapCat 网络配置选择
websocket客户端，URL 填ws://qqbot-langbot:2280/ws。 - LangBot 流水线触发条件里群聊开启
@，测试阶段随机=1，跑通后改回随机=0。 - 完整链路跑通后，QQ 群里
@机器人可以触发 DeepSeek 回复。
两个核心组件
NapCatQQ 是 QQ 侧网关，负责登录 QQ、接收消息、发送消息。
LangBot 是机器人中枢，负责触发规则、流水线、提示词、上下文和模型调用。
一句话：
NapCat 负责“把 QQ 接进来”。
LangBot 负责“决定怎么回答”。