AstrBot
99 versions indexed · latest v4.30.0-beta.1 on Nov 18, 2026
202699
本版本为 Beta 测试版,可能存在不稳定或兼容性问题,建议先在测试环境验证。本次涉及对话数据库、Agent 配置和会话设置迁移。升级前请备份数据与配置;回退旧版需同时恢复升级前备份。
本版本为 Alpha 测试版,可能存在不稳定或兼容性问题,建议先在测试环境验证。本次涉及对话数据库、Agent 配置和会话设置迁移。升级前请备份数据与配置;回退旧版需同时恢复升级前备份。请不要在重要的生产环境使用该版本。
消息按钮:新增跨平台按钮组件,支持链接、消息发送和插件回调,并提供交互超时提示。各平台支持的按钮类型以文档为准。 (#9809);决策模型:新增独立于聊天模型的 Decision Provider 和 System One 适配器,供插件调用结构化选择、布尔判断和评分。 (#10775);网络搜索:接入 SerpApi Google News,支持新闻来源、作者、发布时间和 WebUI 引用展示。 (#10773)
Life is like a box of chocolates.
网页搜索:“网页搜索” 能力新增 SerpApi 搜索服务 (Google 网页搜索、图片搜索、学术搜索、财经搜索)、DeepSeek 搜索服务(网页搜索、网页内容提取)。 (#10599);插件开发:为插件的单选/多选配置项(list 类型)添加本地化的 subtitles 副标题元数据。
This release includes all changes from v4.29.0-beta.1 and v4.29.0-beta.2, plus changes since v4.29.0-beta.2. The full release range starts at v4.28.0.
This prerelease includes changes since v4.29.0-beta.1.
This prerelease includes changes since v4.28.0 (commit a412146401426c0cdff8bbefb8627a03da519da8).
Fixed SQLite datetime fields being inferred as SQLModel UTCDateTime after dependency upgrades, which caused knowledge-base writes, dashboard statistics, and related database operations to fail for naive datetime values.
We live in stories we collectively believe in.
Each season brings its own beauty, and the joy is endless.
Redesigned the WebUI pages for model providers, bots, and profiles, and consolidated logs, traces, conversation management, and data into the Data & Logs page.
Fixed an issue where the initial random password was not displayed when running astrbot run for the first time. (#9879)
The struggle itself toward the heights is enough to fill a man's heart. One must imagine Sisyphus happy.
E quindi uscimmo a riveder le stelle.
Accepted dashboard session tokens from case-insensitive Bearer authorization headers when downloading backups. (#9525)
Added -y / --yes to astrbot init so unattended deployments can skip the installation confirmation prompt. (#9514)
Added persistent group message history with configurable retention, normalized storage, and an LLM tool for searching and retrieving messages from the current group. (#9465)
Il faut cultiver notre jardin.
What can be shown cannot be said.
Added persona import and export in the WebUI. Exported personas intentionally exclude tools and Skills configuration. (#4532)
Added support for setting a custom bot ID while creating a platform by scanning a QR code. (#9067) · Added ChatUI project workspaces. (#9066) · Added improved ChatUI attachment display. (#9134)
Return clear errors when astrbot_file_read_tool receives a directory path instead of reporting a misleading permission error (#9088) · Reduce markdown streaming lag (#9097)
Support installing local plugins (#8448)
Preserve image formats and JPEG quality during media conversion (#9019, #9031) · Fix DashboardRequest compatibility for dashboard requests, resolving some IM webhook errors (#9021, #9023)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
fix: respect existing provider source IDs in config so that manually edited IDs are preserved on save instead of being silently reset. (#8915) (42ca89d6c)
fix: improve WebUI update stability
fix: improve WebUI update stability
更新日志(简体中文);Changelog(English)
fix: keep system tools with persona tool lists (#8908) (da7f53d5e) · docs: 文档更新 - 指令、FAQ、网页搜索、插件发布等 (#8912) (0a0c67740) · fix: restore static runtime version (d36987dd1) · fix: clarify WebUI recovery hint (ddc4e142c)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
更新日志(简体中文);Changelog(English)
个人微信 新增“对方正在输入...”状态控制能力。(#6977);配置管理页支持从现有配置复制生成新配置,减少重复创建成本。(#6785)
增强 Skills 安装流程,不再限制上传的压缩包顶级必须是一个目录。并支持中文技能名称显示。(#6952);OpenAI Embedding 模型配置支持自动补齐 /v1 基础路径。(#6863);为 /api/file 新增 GET 端点并支持多种请求方式。(#6874);WebUI 设置页新增日志与缓存清理能力。(#6822)
新增个人微信接入能力(微信官方提供)。详见 个人微信接入(#6777);新增图片压缩能力,支持图片尺寸、JPEG 质量限制。(#6794);新增 WebUI 已安装插件置顶与拖拽重排能力。(#6776)
为插件市场新增分类筛选并优化界面组件。(#6762);新增 Kimi Coding Plan Provider(兼容 Anthropic API)。(#6559);统一并重命名 skill.md 文件为 SKILL.md。(#6757);新增 Ollama 关闭思考模式开关。(#5941)
补充 MiniMax Provider。(#6318);新增 WebUI ChatUI 页面的会话批量删除功能。(#6160);新增 WebUI ChatUI 配置发送快捷键。(#6272)
新增俄语翻译(#6081)。;QQ 官方 Bot 新增文件、语音、视频消息支持(含 WebSocket 模式)(#6063)。
Lark 适配器支持 CardKit 流式输出(飞书)(#5777)。;WebUI 已安装插件列表新增筛选与排序功能 (#5923)。
新增 Skills 批量上传能力 (#5804)。
集成 KOOK 平台适配器 (#5658)。;新增 Discord pre-react Emoji 支持 (#5609)。;新增 Telegram 支持 sendMessageDraft 流式实时输出 API (#5726);支持在 Agent 运行时进行消息跟进能力,跟进的消息实时注入给 Agent (#5484)。
新增桌面端通用更新桥接能力,便于接入客户端内更新流程 (#5424)。
新增 Agent 会话停止能力,并优化 stop 请求处理流程,支持 /stop 指令终止 Agent 运行并尽量不丢失已运行输出的结果。 (#5380)。;新增 SubAgent 交接场景下的 computer-use 工具支持 (#5399)。;新增 Agent 执行过程中展示工具调用结果的能力,提升执行过程可观测性 (#5388)。;新增插件加载/卸载 Hook,扩展插件生命周期能力 (#5331)。
fix: 修复插件市场出现插件显示为空白的 bug;纠正已安装插件卡片的排版,统一大小 (#5309)
新增 AstrBot HTTP API,支持基于 API Key 的对话、会话查询、配置查询、文件上传与 IM 消息发送能力。详见AstrBot HTTP API (Beta) (#5280)。;新增 Telegram 指令别名注册能力,别名可同步展示在 Telegram 指令菜单中 (#5234)。;新增 Anthropic 自适应思考参数配置(type/effort),增强思考策略可控性 (#5209)。
新增 Python / Shell 执行工具的管理员权限校验,提升高风险操作安全性 (#5214)。;新增插件 astrbot-version 与平台版本要求校验支持,增强插件兼容性管理能力 (#5235)。;账号密码修改流程新增“确认新密码”校验,减少误输导致的配置问题 (#5247)。
支持 QQ 官方机器人平台发送 Markdown 消息,提升富文本消息呈现能力 (#5173)。;新增在插件市场中集成随机插件推荐能力 (#5190)。;新增插件错误钩子(plugin error hook),支持自定义错误路由处理,便于插件统一异常控制 (#5192)。
新增 NVIDIA Provider 模板,便于快速接入 NVIDIA 模型服务 (#5157)。;支持在 WebUI 搜索配置
‼️ 修复 Python 3.14 环境下 'Plain' object has no attribute 'text' 报错问题 (#5154)。;‼️ 修复插件元数据处理流程:在实例化前注入必要属性,避免初始化阶段元数据缺失 (#5155)。;修复桌面端后端构建中 AstrBot 内置插件运行时依赖未打包的问题 (#5146)。;修复通过 AstrBot Launcher 启动时仍被检测并触发更新的问题。
修复:MCP 服务器的 Tools 没有被正确添加到上下文中。;修复:Electron 桌面应用部署时,系统自带插件未被正确加载的问题。;fix: Tools from MCP server were not properly added to context.
修复:当开启了 “启用文件日志” 后,无法启动 AstrBot,报错 ValueError: Invalid unit value while parsing duration: 'files'。这是由于日志轮转设置中保留配置错误导致的,已通过根据备份数量正确设置保留参数进行修复。
新增 LINE 平台适配器与相关配置支持 (#5085);新增备用回退聊天模型列表,当主模型报错时自动切换到备用模型 (#5109);新增插件加载失败后的热重载支持,便于插件修复后快速恢复 (#5043);WebUI 新增 SSL 配置选项并同步更新相关日志行为 (#5117)
QQ 官方机器人平台支持主动推送消息,私聊场景支持接收文件 (#5066);为 Telegram 平台适配器新增等待 AI 回复时自动展示 “正在输入”、“正在上传图片” 等状态的功能 (#5037);为飞书适配器增加接收文件、读取引用消息的内容(包括引用的图片、视频、文件、文字等) (#5018);新增自定义平台适配器 i18n 支持 (#5045)
企业微信智能机器人支持主动消息推送,并新增视频、文件等消息类型支持 (#4999);企业微信应用支持主动消息推送,并优化企微应用、微信公众号、微信客服的音频处理流程 (#4998);钉钉适配器支持主动消息推送,并新增图片、视频、音频等消息类型支持 (#4986);人格管理弹窗新增删除按钮 (#4978)
为 AstrBot Electron App 增加特殊的更新处理。
人格预设对话可能会重复添加到上下文 (#4961)
修复一些原因导致 Tavily WebSearch、Bocha WebSearch 无法使用的问题
fix: fix: messages[x] assistant content must contain at least one part after tool calling (#4928) after tool calls. · fix: TypeError when MCP schema type is a list (#4867)
修复 token 统计错误的问题,修复在多轮 tool call 情况下或者其他极端情况下可能造成 tool 无限调用的问题。;修复 on_llm_request 钩子可能无法应用效果的问题;由 event.request_llm() 过时导致的群聊上下文感知-主动回复功能可能不可用的问题
修复 on_llm_request 钩子可能无法应用效果的问题;由 event.request_llm() 过时导致的群聊上下文感知-主动回复功能可能不可用的问题
控制台页面新增调试提示和本地化文件 (#4852)
由 event.request_llm() 过时导致的群聊上下文感知-主动回复功能可能不可用的问题
🔥 新增未来任务系统(Future Tasks)。给 AstrBot 布置的未来任务,让 AstrBot 能够在某一时刻自动唤醒,帮你完成任务。详见 主动任务 。(实验性) (#4697);🔥 新增子代理(SubAgent)编排器。(实验性)(#4697);🔥 AstrBot 目前可以直接通过调用 tool 将图片 / 文件推送给用户,大大提高交互效果。
feat(chat): feat: trace and log file config (#4747) · fix: WebUI shows success message when skills upload failed (#4768) · fix: cannot use tools when using skills-like tool schema mode (#4775)
feat(chat): refactor message rendering and introduce ToolCallItem component · fix(db): using lambda expression to ensure updated_at field (#4730) · fix(skills): update SANDBOX_SKILLS_ROOT path to use relative directory
支持 Anthropic Skills 导入和使用。参见 Skills;支持新的 Tool Schema 模式:Skill-like。通过两阶段调用来减少 Tool 过多的情况下,占用过多上下文的问题。;支持通过环境变量配置提供商 API Key。(#4696);支持插件的上传文件功能配置项类型 file (#4539)
为 ChatUI 添加文件拖拽上传功能 (#4583);实现人格文件夹以进行高级人格管理 (#4443);添加人格文件夹管理以支持层级组织 (db);支持 Genie TTS
fix: 只跳过 AstrBot 预设的位于开头的 System Message,防止一些非预期行为。;feat: 优化 ChatUI 默认的 System Message;feat: 新增 tool 调用时 on_using_llm_tool、tool 调用后 on_llm_tool_respond 的事件钩子。;feat: 优化 ChatUI 对 Tavily 网页搜索工具的渲染,支持内联搜索引用、引用网页。
fix: 只跳过 AstrBot 预设的位于开头的 System Message,防止一些非预期行为。;feat: 优化 ChatUI 默认的 System Message;feat: 新增 tool 调用时 on_using_llm_tool、tool 调用后 on_llm_tool_respond 的事件钩子。;feat: 优化 ChatUI 对 Tavily 网页搜索工具的渲染,支持内联搜索引用、引用网页。
AstrBot Agent 沙箱环境(改进的代码解释器) (#4449),详见文档;ChatUI 支持项目管理 (#4477);自定义规则支持批量处理。
AstrBot 代理沙箱环境(改进的代码解释器) (#4449),详见文档;ChatUI 支持项目管理 (#4477);自定义规则支持批量处理。
detect image MIME type from binary data for Anthropic API (#4426) · correct duplicate word in agent logger warning (#4390) · sannitize llm context by modalities (#4367)
detect image MIME type from binary data for Anthropic API (#4426) · correct duplicate word in agent logger warning (#4390) · sannitize llm context by modalities (#4367)
feat: supports to display plugin CHANGELOG.md (#4337)