OpenGithubs / OpenGithubs/monthly
【开源自荐】qq-ai-bot：OneBot 11 + ACP 的 QQ ↔ AI 自托管脚手架
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 851
- Forks
- 20
- PR merge metrics
- No merged PRs in 30d
Description
项目名称
qq-ai-bot
项目地址
https://github.com/happysnaker/qq-ai-bot
在线阅读
https://happysnaker.github.io/qq-ai-bot/
项目简介
qq-ai-bot 是一个把 QQ / OneBot 11 接到 本地 AI agent 的自托管脚手架。前面兼容 NapCat / LLOneBot，后面接 ACP-compatible agent。它的重点不是再做一个聊天 UI，而是把消息入口、会话状态、进度回传、Docker 演示和部署文档整理成一个可以直接跑起来的 QQ ↔ AI bot 基础设施仓库。
推荐原因
- 支持 OneBot 11 / NapCat / LLOneBot + ACP agent，更像可复用的接线层 / 集成层，而不是玩具聊天机器人。
- 仓库自带 NapCat + qq-ai-bot + mock ACP agent 的最小 Docker demo，可以先验证完整链路，再替换成自己的 agent。
- 有 persistent sessions、progress streaming、轻量入站去重、correlation ID、/metrics、/readyz 这类更偏工程化的能力。
- 文档比较完整：项目介绍、特性、快速开始、Docker demo、FAQ、部署矩阵、架构说明、Roadmap、Contributing、Security 都补齐了。
- 已进入 OneBot 生态页，对 QQ / OneBot / self-hosted AI 方向的读者更容易理解定位。
适合分类
AI 开源项目 / 机器人基础设施 / 自托管 / 工程化部署
License
MIT
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No repository file, test, or entry point is identified in the issue. Review the monthly publication format and the linked qq-ai-bot project before deciding how this recommendation fits; done means the supplied project links and description are included in the appropriate publication entry.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker
- Domain
- content
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 42/100