【开源自荐】qq-ai-bot：带稳定镜像分发路径的 QQ ↔ AI 自托管脚手架

[happysnaker]

开源名称

qq-ai-bot

开源地址

https://github.com/happysnaker/qq-ai-bot

简介

qq-ai-bot 是一个面向 OneBot 11 / NapCat / LLOneBot 的 QQ ↔ AI 自托管脚手架。它前面接 QQ / OneBot 消息通道，后面接 ACP-compatible agent。重点不是再做一个聊天 UI，而是把消息入口、会话状态、进度回传、部署路径和工程化文档整理成一个更像 bot 基础设施的仓库。

推荐理由

• 定位更偏基础设施 / 接线层：QQ / OneBot transport + ACP agent bridge，而不是玩具聊天机器人
• 可以低成本验证全链路：仓库自带 NapCat + qq-ai-bot + mock ACP agent 的最小 Docker demo
• 补了不少偏工程化能力：persistent sessions、progress streaming、轻量去重、correlation ID、/metrics、/readyz
• 文档比较完整：快速开始、Docker demo、FAQ、部署矩阵、架构、Roadmap、Contributing、Security 都补齐了
• 最近又补了稳定镜像分发路径：现在不只有 latest，还发了 ghcr.io/happysnaker/qq-ai-bot:v0.1.4，而且 v0.1.4 和 latest 都支持 linux/amd64 + linux/arm64，更适合被 self-hosted / homelab / CasaOS / Compose 这类场景引用

补充信息

• 官网：https://happysnaker.github.io/qq-ai-bot/
• Docker 演示：https://github.com/happysnaker/qq-ai-bot/blob/main/docs/docker-quickstart.md
• Release：https://github.com/happysnaker/qq-ai-bot/releases/tag/v0.1.4
• OneBot 生态：https://onebot.dev/ecosystem