把 AI 助手装进聊天软件的完整上手手册
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
如果你想在 QQ 群、微信、Telegram 或者企业微信里拥有一个真正能干活的 AI 助手——能聊天、能查资料、能定时做事、能记住你们社群的规矩——这套文档就是为这个目标准备的。它整理的对象是 AstrBot，一个开源的一站式 Agentic 聊天机器人平台：部署在你自己的电脑或服务器上，接入你常用的聊天软件，再挂上任意大模型服务，就能在聊天窗口里直接使用。
这里不替你做决定，只把每条路的走法讲清楚：八种部署途径怎么选、三种模型 API 格式怎么填、十八个消息平台从哪条线接、插件和 MCP 怎么装、出问题了去哪查日志。所有内容整理自官方文档与公开资料，供本地学习研究使用，具体功能随版本迭代，以官方最新版为准。
产品档案速览
| 项目 | 情况 |
|---|---|
| 产品类型 | 开源一站式 Agentic 个人与群聊助手、聊天机器人开发框架 |
| 开源协议 | AGPL-v3，非盈利开源项目，由全球贡献者维护 |
| 版本形态 | v4.x 系列持续迭代，桌面端、服务端、Docker 镜像多形态分发 |
| 支持平台 | QQ、企业微信、微信公众号、飞书、钉钉、Telegram、Discord、Slack、KOOK 等 18+ 平台 |
| 模型接入 | 适配 OpenAI、Google GenAI、Anthropic 三种原生 API 格式，兼容 OpenAI 格式的服务均可接 |
| 扩展体系 | 1000+ 插件市场、MCP 服务器、Agent Skills、内置知识库、Agent 沙盒 |
| 管理方式 | WebUI 管理面板（默认 6185 端口）+ 内置 ChatUI 对话界面 |
| 适用人群 | 个人玩家、群主、开发者、需要智能客服与知识库的中小团队 |
结构导览
- 先认识它：产品定位与核心能力 —— 还没决定要不要用，先看这一组
- 部署安装：八种途径选型与逐个实操 —— 从桌面客户端到 Docker，总有一种适合你的机器
- 接入模型：三种 API 格式与服务商清单 —— 让机器人有脑子，DeepSeek 实例走全流程
- 接入聊天平台：QQ、微信生态与海外 IM —— 消息从聊天软件进来的必经环节
- 管理面板：WebUI 与 ChatUI 全导览 —— 配置、日志、统计、指令管理都在这里
- 日常使用：唤醒、人格、语音与权限 —— 跑起来之后每天打交道的东西
- 扩展能力：插件、MCP、技能与知识库 —— 1000+ 插件之外的三层扩展体系
- 场景实践：群聊陪伴、智能客服与个人助手 —— 按用途组合功能，不堆参数
- 常见问题：登录、不回话、报错与升级 —— 出问题先来这里对号入座
从哪开始
路线很简单：选一种部署方式把程序跑起来 → 用启动日志里的初始密码登录管理面板 → 接一个模型服务 → 接一个消息平台 → 在群里 @ 它说第一句话。跑通这条线之后，再按需回来看插件、知识库和场景调优。