【开源自荐】qq-ai-bot：面向 OneBot 11 / NapCat / LLOneBot 的自托管 QQ ↔ AI Agent 脚手架

[happysnaker]

项目简介

• 项目地址：https://github.com/happysnaker/qq-ai-bot
• 项目页：https://happysnaker.github.io/qq-ai-bot/
• 演示入口：https://github.com/happysnaker/qq-ai-bot/blob/main/docs/docker-quickstart.md

qq-ai-bot 是一个偏工程化的 QQ ↔ AI 自托管项目骨架：

• QQ 侧：基于 OneBot 11，兼容 NapCat / LLOneBot
• AI 侧：通过 ACP-compatible agent 接入本地 / 自托管 agent
• 工程能力：持久化会话、进度流式回传、Docker 演示栈、Prometheus 风格指标、部署矩阵文档

我想把它定位成一个 messaging-first 的 bot infrastructure / integration scaffold，而不是又一个“网页聊天壳”。

适合谁

• 想把本地 AI agent 接到 QQ / OneBot 场景的人
• 想验证 NapCat / LLOneBot + agent runtime 的整条链路的人
• 想拿现成脚手架改造成自己 bot 的开发者

核心亮点

1. OneBot 11 + ACP bridge：把消息通道和 agent 执行边界拆开
2. persistent sessions：按 QQ 会话维持独立上下文，可恢复
3. progress streaming：把 agent 处理进度增量回传到 QQ
4. Docker demo：仓库内自带 NapCat + qq-ai-bot + mock ACP agent 最小演示栈
5. deployment docs：有架构说明、部署矩阵、FAQ、agent 接入文档

一句描述

一个面向实际部署的、production-grade 的 QQ ↔ AI bot scaffold：OneBot 11 + NapCat / LLOneBot + ACP-compatible agents + persistent sessions + progress streaming + Docker demo。

如果适合收录，感谢关注。