外观
🤖 自己搭一个 QQ AI 机器人
「想搞个和群里类似的机器人，接 QQ 小号怎么整？」先选接入方式，再把消息平台和模型连起来。让小助手进群前，先在测试群里练练手～
🛤️ 两条路，先选一条
| 接入方式 | 怎么接 | 要注意什么 |
|---|---|---|
| QQ 官方机器人 | 去 QQ 开放平台申请 | 最稳，不怕封号；功能和能加入的群聊范围受平台规则限制 |
| 个人 QQ 号 + 协议端 | 例如 NapCat，实现 OneBot v11 协议 | 非官方，有被风控、封号的风险 |
个人号接入务必用小号
别用主号，别用来发广告刷屏。非官方接入有被风控、封号的风险，遵守群规和平台规则。具体可用范围以官网/群公告为准。
🍡 推荐框架：AstrBot
AstrBot 是一站式 AI 聊天机器人框架，有可视化管理面板。GitHub 仓库是 AstrBotDevs/AstrBot，约 4.5 万星，使用 AGPL-3.0 协议；星数会变，以官网为准。
| 想做什么 | AstrBot 支持什么 |
|---|---|
| 接消息平台 | QQ 官方机器人、OneBot v11（NapCat 就是这个协议的实现），以及企业微信、飞书、钉钉、Telegram、Discord 等 |
| 接模型 | OpenAI、Anthropic、Gemini 等，也支持 NewAPI 类中转、Ollama 本地模型 |
| 加功能 | 插件市场、知识库、MCP、Skills |
| 部署 | Docker、桌面版、各种面板一键部署 |
另一位候选：Koishi
Koishi（koishijs/koishi）插件生态丰富，使用 MIT 协议。可以先看文档，选更顺手的框架。
🧩 大致流程：消息进来，模型回复
这里只列路线，具体部署命令和配置步骤看官方文档。界面、版本和平台要求以官网/群公告为准。
- 准备常开的设备：一台电脑或服务器。
- 部署 AstrBot：按官方文档选 Docker、桌面版或面板部署，进入可视化管理面板。
- 接入消息平台：选择 QQ 官方机器人；或者按文档部署 NapCat，再在 AstrBot 中接入 OneBot v11。
- 添加模型服务：选择要用的模型服务。接 Maru Code 时，按下面的 OpenAI 兼容配置填写。
- 先去测试群试：设置好触发方式和频率限制，再测试收消息、调用模型、回复消息这一整条流程。
| Maru Code 配置项 | 填什么 |
|---|---|
| 接口类型 | OpenAI 兼容 |
| Base URL | https://api.muteki.site/v1 |
| API Key | 自己的 Key，分组要支持所选模型 |
| 模型名 | 以后台为准 |
🛡️ 入群前的小检查
- Key 只填在自己的服务器上，不要写进公开仓库。
- 设置成 @ 才回，加上频率限制，避免刷屏被踢。
- 遵守群规和平台规则，不发广告、不刷屏。
- 用 AGPL 协议的软件，改了代码再对外提供服务，要开源。
先看清协议
AstrBot 使用 AGPL-3.0。修改代码后对外提供服务，记得履行开源要求；具体要求以官方协议文本为准。