AstrBot是一个松耦合、异步化的聊天机器人开发框架,支持多消息平台部署,配备易用的插件系统和全面的大语言模型(LLM)接入功能。
核心功能概览
大语言模型对话:兼容多种模型如OpenAI API、Google Gemini、Llama、Deepseek和ChatGLM,支持本地部署方案(如Ollama、LLMTuner)。具备多轮对话管理、人格情境设定和多模态能力,集成图片理解及语音转文字(Whisper)技术。
多平台接入:已支持QQ(OneBot)、QQ频道、微信(Gewechat)、飞书、Telegram,未来计划扩展至钉钉、Discord、WhatsApp及小爱音响。内置速率限制、白名单控制、关键词过滤和百度内容审核机制。
Agent能力:原生支持代码执行器、自然语言待办事项和网页搜索Agent。无缝对接Dify平台,便捷接入其智能助手、知识库和工作流系统。
插件扩展:深度优化的插件机制简化开发流程,支持快速安装和管理多个功能扩展插件。
可视化管理:提供Web面板用于实时修改配置、管理插件、查看日志及WebChat对话功能,大幅降低操作门槛。
架构优势:基于事件总线和流水线设计,实现高模块化、低耦合性,确保系统稳定性和可扩展性。
消息平台支持详情
服务提供商兼容性
管理面板在线体验
访问Demo:https://demo.astrbot.app
准备工作: 部署Gewechat微信机器人框架
Gewechat是一个免费开源的个人微信框架,支持Restful API接入和二次开发,无需安装电脑微信或手机破解插件,扫码即可使用。
框架优势与能力
核心优势:操作简易,无复杂接入流程,采用大厂主流稳定方案。
主要功能:
消息自动化:向好友或群组发送文本、图片、文件、表情、小程序及语音消息。
自定义处理:支持自动回复、关键词触发、AI交互及RPA业务自动化。
管理工具:提供好友备注设置、邀请统计和群组管理功能。
业务集成:轻松接入ChatGPT、Sora等AI模型及客服系统。
扩展性:开放架构支持创新功能开发。
项目架构设计
Docker Compose部署
services:
gewe:
image: xmoxmo/gewe:latest
container_name: gewe
ports:
- 2531:2531
- 2532:2532
volumes:
- /vol1/1000/docker/gewe/temp:/root/temp
privileged: true
restart: always
在浏览器访问 http://NAS的IP:2531
验证运行状态: 内存占用约1GB:
安装AstrBot核心组件
Docker Compose配置
services:
astrbot:
image: soulter/astrbot:latest
container_name: astrbot
ports:
- 6180-6200:6180-6200
- 11451:11451
volumes:
- /vol1/1000/docker/astrbot:/AstrBot/data
- /etc/localtime:/etc/localtime
restart: always
端口映射说明:
6185(必需):WebUI默认端口
6195(可选):企业微信端口
6199(可选):OneBot(aiocqhttp)端口
6196(可选):QQ官方API回调端口
11451(可选):Gewechat回调端口
配置与使用指南
访问 http://NAS的IP:6185
进入管理界面: 初始用户名和密码均为
astrbot
: 修改凭证增强安全性:
成功登录仪表盘:
添加大语言模型
进入“服务提供商”添加模型(例如Ollama本地模型): 填写参数并测试对话功能:
接入消息平台
选择“消息平台”添加Gewechat: 关键配置项:
base_url
:Gewechat后端API地址host
:AstrBot回调主机(不含http://
)port
:回调端口(默认无需修改) 配置参考:保存后启用适配器,从日志获取二维码链接并扫码登录:
问题排查与优化
初始测试可能出现异常(如deepseek-r1不支持函数调用): 日志分析确认问题:
切换至OpenAI模型后回复正常:
高级自定义功能
全局配置:自由调整系统参数
插件市场:安装扩展插件增强功能
总结与性能评估
AstrBot提供简洁高效的配置流程,模型和平台接入灵活,默认设置即可运行,同时支持深度自定义。扩展性出色,兼容多服务商模型和丰富插件,适合从新手到专业开发者。
注意事项:微信测试存在封号风险,建议避免使用主账号。
综合评分:
推荐指数:⭐⭐⭐⭐(多平台支持优异)
使用体验:⭐⭐⭐⭐(兼顾易用性与专业性)
部署难度:⭐⭐⭐(需框架联动)
资源占用分析:Gewechat框架内存消耗较高(约1GB),AstrBot运行轻量: