astrbot

应用介绍

astrbot是一款运行于安卓平台的开源智能体聊天机器人框架，内置了庞大的插件市场，因此也被直接称为astrbot插件。它支持对接QQ、企业微信、Telegram等主流消息平台，同时可接入OpenAI、Gemini及本地Ollama等大模型，用于构建企业微信智能客服、知识库问答等场景。对开发者而言，astrbot提供了高效灵活的一站式AI对话解决方案。

项目入口

用户可访问astrbot官方项目主页获取最新的下载地址与使用文档，也可以通过应用内的引导页面直接跳转官方社区。项目团队会持续更新版本，提供更稳定的体验。

插件生态概览

astrbot的插件体系分为多个类别，覆盖从平台接入到内容创作、从系统管理到办公协作的诸多场景，用户可以根据需求自由组合安装。

官方核心插件

官方团队维护了一批基础能力插件，包括指令查询工具command_query、让大模型代理执行机器人指令的command_executor、支持多路混合检索的知识库插件knowledge_base，以及用于提升安全性的反提示注入插件anti_prompt_injection和统一处理文本、图片、语音消息的message_parser。

平台适配方面，提供了Matrix、QQ OneBot、Telegram、企业微信、Discord、Slack、Misskey等多种消息平台接入方案，满足不同渠道的部署需求。

内容与工具类插件

内容工具模块包含明航音乐（全网音乐搜索与下载）、pixiv_search（Pixiv插画与小说检索）、bilibili_plugin（B站视频解析及UP主动态订阅）、meme_manager表情包管理、weather_query天气查询、translation多语言翻译、news_query实时新闻、dictionary词典查询、movie_search影视信息以及anime_search动漫资料查看等，覆盖日常高频需求。

记忆与交互增强插件

在智能化交互方面，LivingMemory模拟人类记忆形成与遗忘机制，Mnemosyne基于向量数据库构建长期记忆中枢，Heartflow支持群聊主动回复，LMArena可免费调用部分大模型，加上PersonaManager多人格管理、EmotionDetector情绪识别和ContextEnhancer上下文增强，让机器人更懂用户。

管理运维类插件

对于群组管理和运维需求，QQ群管插件支持禁言、踢人、拉黑与违禁词检测；人际关系管理器方便维护好友及群列表；log_monitor提供实时日志监控，plugin_manager支持插件一键安装卸载，config_editor通过WebUI修改配置，backup_manager自动备份恢复，performance_monitor监控系统性能。

媒体与工具类插件

媒体处理方面有图片、视频、音频的元数据解析工具，MAA远程控制可操作自动化工具，file_converter转换文件格式，ocr_reader提取图片文字，voice_recognizer基于Whisper实现语音识别，text_to_speech完成文本转语音，image_generator支持SD/Flux等模型进行AI绘图。

娱乐与趣味类插件

娱乐板块包含chat_game文字冒险游戏、dice骰子与TRPG工具、riddle猜谜、fortune_teller运势占卜、horoscope星座运势、joke_generator随机笑话生成器以及ai_story智能故事续写，为日常使用增添轻松体验。

企业与办公类插件

面向办公场景，meeting_scheduler负责会议安排与提醒，todo_manager管理待办事项，document_search支持企业文档检索，notion_sync同步Notion内容，google_calendar_sync对接谷歌日历，email_sender发送邮件，workflow帮助搭建自动化工作流。

常见问题与排查方法

如果模型接入失败，需要检查API密钥是否有效、网络连接是否正常，若使用本地模型则确认Ollama或LLMTuner服务已启动，并核对相关配置参数。

当消息平台无响应时，应核实平台侧的地址与Token配置是否正确，同时检查白名单或关键词过滤规则，并通过日志定位具体原因。

遇到知识库检索不准的情况，可以尝试配置重排序模型、优化嵌入模型，并在上传文档前进行合理的文本拆分，以提升召回精度。

代码执行器如果报错，先确认Docker是否运行、镜像拉取是否完整，国内用户可考虑配置镜像源，同时检查Python库的版本兼容性。

插件安装失败时，需确认插件与当前astrbot版本是否兼容，检查网络状态，也可以手动上传插件文件，并利用WebUI日志排查详细错误信息。

核心特性与优势

astrbot支持OpenAI、Gemini、Claude、Kimi等主流大模型，也能通过Ollama接入本地模型，数据可保留在本地。它原生具备AI Agent能力，包含代码执行器、网页搜索、自然语言待办等，并可对接Dify完成智能助手与知识库的快速搭建。

模块化低耦合的架构基于事件总线与流水线设计，异步处理消息，扩展性和稳定性都比较突出。插件机制允许用Python编写扩展，官方及社区插件资源丰富，一键安装卸载十分方便。WebUI提供可视化配置界面，用户无需操作复杂命令行即可完成模型、插件、知识库的管理，同时集成WebChat便于直接调试对话。

多模态交互方面，支持Whisper语音转文字、图片理解等功能，未来还会加入AI图像生成。知识库支持PDF、DOCX、Markdown等格式上传，并可采用多路混合检索，在单个会话中引用多个知识库，满足企业级应用需求。

更新日志

v1.5.3版本主要优化了Docker部署流程，并更新了代码执行器相关镜像，提升了整体稳定性。