Skip to content

AstrBot

v4.25.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent ai llm chatgpt discord docker
+8 more
gemini llama mcp openai python qq qqbot telegram

ReleasePort's take

Moderate signal
editorial:auto 9d

Release v4.25.0 fixes Tencent SILK audio conversion failures caused by a leading \x02 byte and adds several new integrations and UI improvements.

Why it matters: If your pipeline uses Tencent SILK audio, patch to v4.25.0 immediately to avoid ffmpeg conversion errors; the release also introduces QR‑code bot creation for Feishu, DingTalk, and Personal WeChat.

Summary

AI summary

Fixed Tencent SILK audio with leading \x02 byte causing ffmpeg conversion failures.

Changes in this release

Feature Medium

Adds Ollama Embedding and NVIDIA NIM Embedding provider adapters for AI models.

Adds Ollama Embedding and NVIDIA NIM Embedding provider adapters for AI models.

Source: llm_adapter@2026-05-21

Confidence: low

Feature Medium

Introduces one-click QR code creation for Feishu (Lark) bots during setup.

Introduces one-click QR code creation for Feishu (Lark) bots during setup.

Source: llm_adapter@2026-05-21

Confidence: low

Feature Medium

Adds one-click QR code creation capability for DingTalk bots during setup.

Adds one-click QR code creation capability for DingTalk bots during setup.

Source: llm_adapter@2026-05-21

Confidence: low

Feature Medium

Implementes QR login flow for Personal WeChat bot creation within the dialog UI.

Implementes QR login flow for Personal WeChat bot creation within the dialog UI.

Source: llm_adapter@2026-05-21

Confidence: low

Dependency Medium

Updates WebUI asset selection to prefer bundled Dashboard over outdated versions from data/dist.

Updates WebUI asset selection to prefer bundled Dashboard over outdated versions from data/dist.

Source: llm_adapter@2026-05-21

Confidence: low

Performance Medium

Enhances AMR audio conversion quality and simplifies Opus conversion using shared logic.

Enhances AMR audio conversion quality and simplifies Opus conversion using shared logic.

Source: llm_adapter@2026-05-21

Confidence: low

Bugfix Medium

Fixes Tencent SILK audio with  prefix not being recognized, preventing ffmpeg conversion failures.

Fixes Tencent SILK audio with  prefix not being recognized, preventing ffmpeg conversion failures.

Source: llm_adapter@2026-05-21

Confidence: high

Bugfix Medium

Resolves Personal WeChat media send failures that were not properly exposed as errors.

Resolves Personal WeChat media send failures that were not properly exposed as errors.

Source: llm_adapter@2026-05-21

Confidence: high

Bugfix Medium

Fixes tool call failures when Claude API returns None arguments for no-parameter tools.

Fixes tool call failures when Claude API returns None arguments for no-parameter tools.

Source: llm_adapter@2026-05-21

Confidence: high

Bugfix Medium

Corrects registration functions to properly forward **kwargs to platform adapters and permissions.

Corrects registration functions to properly forward **kwargs to platform adapters and permissions.

Source: llm_adapter@2026-05-21

Confidence: high

Bugfix Medium

Prevents MiniMax TTS initialization crashes caused by empty or invalid timber weight JSON config.

Prevents MiniMax TTS initialization crashes caused by empty or invalid timber weight JSON config.

Source: llm_adapter@2026-05-21

Confidence: high

Refactor Medium

Synchronizes console auto-scroll state so it persists after refresh across components.

Synchronizes console auto-scroll state so it persists after refresh across components.

Source: llm_adapter@2026-05-21

Confidence: low

Refactor Medium

Adds Noto Sans font support in Dashboard to improve Cyrillic and multilingual text rendering.

Adds Noto Sans font support in Dashboard to improve Cyrillic and multilingual text rendering.

Source: llm_adapter@2026-05-21

Confidence: low

Other Medium

Updates platform docs with QR setup instructions and permission reminders for Feishu, DingTalk, and Personal WeChat.

Updates platform docs with QR setup instructions and permission reminders for Feishu, DingTalk, and Personal WeChat.

Source: llm_adapter@2026-05-21

Confidence: low

Other Medium

Improves Personal WeChat login-state handling by clearing stale sessions on timeout to avoid invalid requests.

Improves Personal WeChat login-state handling by clearing stale sessions on timeout to avoid invalid requests.

Source: llm_adapter@2026-05-21

Confidence: low

Full changelog

What's Changed

修复

  • 修复 Tencent SILK 音频带 \x02 前缀时未被识别,导致后续 ffmpeg 转换失败的问题。(#8009
  • 修复个人微信媒体消息发送失败时错误未向上暴露的问题。(#8175
  • 修复 Claude API 对无参数工具返回 None 参数时工具调用失败的问题。(#8136
  • 修复 register_platform_adapter_typeregister_permission_type 未正确透传 **kwargs 的问题。(#8141
  • 修复 MiniMax TTS timber weight 配置为空或非法 JSON 时可能导致初始化崩溃的问题。

新功能

  • 新增 Ollama Embedding 与 NVIDIA NIM Embedding 提供商适配器。(#8104
  • 新增飞书扫码一键创建能力。(#8191
  • 新增钉钉扫码一键创建能力。(#8198
  • 新增个人微信创建时扫码登录流程,选择个人微信后直接在创建弹窗中显示二维码,登录成功后再保存机器人配置。(#8196

优化

  • 优化个人微信登录态处理:当接口返回 session timeout 时清理旧登录态,避免继续高频请求失效会话。(#8196
  • 优化 AMR 音频转换质量,并复用通用音频转换逻辑简化 Opus 转换实现。(#8153
  • 优化 WebUI 资源选择逻辑:当 data/dist 中的 Dashboard 版本旧于当前核心版本时,优先使用随包内置的 Dashboard,避免旧前端资源造成兼容问题。(#8172
  • Dashboard 新增 Noto Sans 字体支持,改善西里尔文字等多语言文本显示效果。(#8015
  • 优化控制台自动滚动状态同步,刷新后能正确恢复并同步到日志显示组件。(#8186
  • 更新飞书、钉钉、个人微信平台文档,补充扫码创建 / 登录说明、飞书权限开通提醒,以及个人微信新版创建流程。
  • 更新 AI 插件开发文档,明确 context.register_llm_tool() 已弃用,并补充 LLM Tool docstring 参数解析要求。(#8178

What's Changed (EN)

New Features

  • Added one-click QR setup for Feishu / Lark. When creating a bot, users can choose Feishu China or Lark Global, scan the QR code, and automatically fill app_id, app_secret, and domain settings. AstrBot also fetches the bot name for the generated config ID display. (#8191)
  • Added one-click QR setup for DingTalk. Users can create or bind a DingTalk app by scanning a QR code, automatically filling ClientID and ClientSecret, while manual setup remains available. (#8198)
  • Added QR login during Personal WeChat bot creation. The creation dialog now shows the login QR code directly and allows saving after login succeeds. (#8196)
  • Added Ollama Embedding and NVIDIA NIM Embedding provider adapters. (#8104)

Improvements

  • Improved Personal WeChat login-state handling by clearing stale login state when the API reports session timeout, avoiding repeated requests against an invalid session. (#8196)
  • Improved AMR audio conversion quality and simplified Opus conversion by reusing the shared audio conversion path. (#8153)
  • Improved WebUI asset selection: when data/dist contains a Dashboard older than the current core version, AstrBot now prefers the bundled Dashboard to avoid stale frontend compatibility issues. (#8172)
  • Added Noto Sans support to the Dashboard for better Cyrillic and multilingual text rendering. (#8015)
  • Improved console auto-scroll state synchronization so the restored preference is applied to the log display component after refresh. (#8186)
  • Updated Feishu / Lark, DingTalk, and Personal WeChat platform docs with QR setup / login instructions, Feishu permission reminders, and the new Personal WeChat creation flow.
  • Updated the AI plugin development guide to clarify that context.register_llm_tool() is deprecated and to document the required LLM Tool docstring argument format. (#8178)

Bug Fixes

  • Fixed Tencent SILK audio with a leading \x02 byte not being detected, which could cause ffmpeg conversion failures. (#8009)
  • Fixed Personal WeChat media send failures not being surfaced properly. (#8175)
  • Fixed tool calls failing when the Claude API returns None arguments for no-parameter tools. (#8136)
  • Fixed register_platform_adapter_type and register_permission_type not forwarding **kwargs correctly. (#8141)
  • Fixed MiniMax TTS initialization crashes when timber weight config is empty or invalid JSON.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track AstrBot

Get notified when new releases ship.

Sign up free

About AstrBot

All releases →

Related context

Beta — feedback welcome: [email protected]