一键部署需预先安装 uv,且要求 Python 3.12;macOS 首次运行 astrbot 命令可能耗时 10-20 秒;Docker 等部署方式需另查官方文档。
AstrBot
AstrBotDevsAGPL-3.0活跃维护一个把 QQ、Discord 等聊天平台与大模型、插件和 MCP 能力串起来的 AI Agent 开发框架,能快速搭建多平台聊天机器人和智能助手。
AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
uv tool install astrbot --python 3.12
astrbot init
astrbot runREADME 未说明显存或 GPU 要求;支持 Ollama、LM Studio 等自托管模型服务,也可用云端 LLM API,无需本地 GPU。
开源一体化 Agent 聊天机器人平台,把大模型接入 QQ、飞书等主流 IM
一个把 QQ、Discord 等聊天平台与大模型、插件和 MCP 能力串起来的 AI Agent 开发框架,能快速搭建多平台聊天机器人和智能助手。
核心能力
- 接入 QQ、微信、飞书、钉钉、Telegram、Slack 等 IM 平台
- 支持多模态、Agent、MCP、技能、知识库与人设设定
- 可对接 Dify、阿里云百炼、Coze 等 Agent 平台
- 插件市场提供 1000+ 插件一键安装
- 内置 Agent 沙箱隔离执行代码与 shell 调用
容易踩的坑
- v4.29.4最新正式版2026-10-31 · 2026-10-31 11:59 UTC
[4.29.4] - 2026-10-31
新增
- 消息按钮:新增跨平台按钮组件,支持链接、消息发送和插件回调,并提供交互超时提示。各平台支持的按钮类型以文档为准。 (#9809)
- 决策模型:新增独立于聊天模型的 Decision Provider 和 System One 适配器,供插件调用结构化选择、布尔判断和评分。 (#10775)
- 网络搜索:接入 SerpApi Google News,支持新闻来源、作者、发布时间和 WebUI 引用展示。 (#10773)
- 会话与用户选择:统一会话来源选择弹窗,支持昵称搜索、平台标识、分页及 ID 复制;记录发送者信息并补全飞书、QQ 官方群名称。管理员配置入口由“添加更多 → 编辑列表项”改为“选择用户”;原会话下拉框和列表编辑入口统一为“选择会话来源”,“已知会话”改为“已记录的会话来源”。 (#10747)
- 机器人管理:删除机器人时可选择清理配置、定时任务、会话、消息记录、追踪和用量数据;默认保留对话与历史数据。 (#10761)
- 定时任务:支持查看群内共享任务列表,并允许管理员删除群任务。 (#10785)
- 网络设置:新增 PyPI 镜像选择器与测速功能。 (#10657)
优化与修复
- 稳定性:修复日志输出受阻时 WebUI 和 WebChat 可能无响应的问题,并在诊断包中提供控制台日志丢弃统计。 (#10902)
- 上下文压缩:简化设置,将“历史记录达到上限或上下文窗口紧张时的处理方式”改为“压缩策略”,“上下文压缩模型提供商 ID”改为“压缩模型”;最大轮数、丢弃轮数、压缩指令、近期上下文比例及回退窗口大小移至“更多设置”,保留现有配置和运行行为。 (#10753)
- 模型服务:保留 Anthropic 兼容服务所需的 API Key 请求头;修复 DashScope Agent 超时配置未生效的问题。 (#10787, #10868)
- Gemini:提供原生参数快捷模板,并修正原生工具配置提示。 (#10771, #10875)
- 插件与技能:修复 NAS 等环境中临时目录与
.astrbot标记文件冲突导致的插件安装失败;报告插件配置重载失败;加载技能时优先使用文件读取工具。 (#10784, #10788, #10789) - 安全:为默认 PyPI 镜像启用 TLS 证书校验。 (#10685)
- 音频:支持带
0x03前缀的腾讯 SILK 音频。 (#10744) - ChatUI:文件面板使用当前会话的工作目录。 (#10883)
- WebUI:优化追踪列表实时更新、统一配置表单样式、移除自定义规则中不受支持的“全部”选项,并限制原生滚动条样式仅在 Firefox 生效。 (#10748, #10755, #10757, #10760)
Added
- Message buttons: Added portable button components for links, sending messages, and plugin callbacks, with interaction timeout notices. Supported action types vary by platform; see the documentation. (#9809)
- Decision models: Added a Decision Provider independent of chat models and a System One adapter for structured choices, boolean questions, and scores in plugins. (#10775)
- Web search: Integrated SerpApi Google News with publisher, author, publication time, and WebUI citations. (#10773)
- Session and user selection: Unified session-source selection with nickname search, platform labels, pagination, and ID copying; recorded sender information and enriched Lark and QQ Official group names. Administrator settings move from Add More → Edit List Items to Select users. Previous session dropdowns and list editors become Select session sources; Known sessions becomes Recorded session sources. (#10747)
- Bot management: Added selective cleanup of configuration, scheduled tasks, conversations, message history, traces, and usage data when deleting a bot. Conversations and historical data are retained by default. (#10761)
- Scheduled tasks: Shared group task lists and allowed administrators to delete group tasks. (#10785)
- Network settings: Added a PyPI mirror picker and speed tests. (#10657)
Improved and Fixed
- Stability: Fixed WebUI and WebChat becoming unresponsive when console output is blocked, and included console log drop counters in diagnostic exports. (#10902)
- Context compression: Renamed Handling for History Limits or Context Window Pressure to Compression Strategy, and Model Provider ID for Context Compression to Compression Model. Moved maximum turns, discarded turns, compression instruction, recent-context ratio, and fallback context window size into More Settings, preserving existing configuration and runtime behavior. (#10753)
- Model providers: Preserved API key headers for Anthropic-compatible providers and honored the configured DashScope Agent timeout. (#10787, #10868)
- Gemini: Added native parameter quick templates and corrected native tool configuration hints. (#10771, #10875)
- Plugins and skills: Fixed plugin installation when temporary directories conflict with the
.astrbotmarker file on NAS and similar environments; reported plugin configuration reload failures; preferred file-reading tools when loading skills. (#10784, #10788, #10789) - Security: Enabled TLS certificate verification for the default PyPI mirror. (#10685)
- Audio: Supported Tencent SILK audio with a
0x03prefix. (#10744) - ChatUI: Used the active session workspace in the file panel. (#10883)
- WebUI: Smoothed live trace updates, unified configuration form styling, removed the un
- v4.29.32026-10-24 · 2026-10-24 15:48 UTC
查看更新说明
[4.29.3] - 2026-10-24
Life is like a box of chocolates.
新增
- 消息追踪:进一步完善消息追踪能力,支持记录和观测所有入站消息事件,以及事件对应的插件调用和 Agent 调用。(需要先在 WebUI 左下角设置中开启) (#10614)
- 诊断导出:支持从控制台和系统设置导出支持脱敏的系统诊断包,包含日志、追踪、配置、插件状态和环境等信息。 (#10418, #10659)
- 安装脚本:新增多语言安装流程和中国大陆镜像支持。 (#10629)
修复
- 备份:补全定时任务、持久化文件和相关数据目录的备份与恢复,避免数据遗漏。 (#10644, #10661)
- Gemini:支持模型自定义生成参数,保留显式设置的零值;修复非字符串枚举导致工具 Schema 不兼容的问题。 (#10719, #10635)
- NVIDIA Rerank:保留模型专属 API 端点路径,避免请求错误的通用地址。 (#10732)
- 电脑使用:修复 Shipyard Bay 执行结果的解析,以及 Windows Shell 超时或取消时的子进程清理。 (#10671, #10729)
- WebUI:修复配置刷新后模型元数据丢失、默认聊天模型选择、插件侧栏名称本地化、桌面更新通知和配置模板字段默认值。 (#10522, #10663, #10576, #10622, #10517)
- WebUI:优化配置说明与条件选项显示,修复全屏日志中的 Pip 安装弹窗、日志流连接等待和页面切换后的重复日志,并明确插件筛选范围。 (#10647, #10608, #10666, #10694, #10691)
- 数据库:使用跨数据库兼容的 JSON 查询表达式。 (#10664)
Added
- Message tracing: Improved tracing to record and inspect all incoming message events and their associated plugin and Agent calls. Enable it first in Settings in the lower-left corner of the WebUI. (#10614)
- Diagnostics: Export system diagnostic bundles with redaction support from the console and system settings, including logs, traces, configuration, plugin status, and environment information. (#10418, #10659)
- Installer: Added multilingual setup and mainland China mirrors. (#10629)
Fixed
- Backups: Include scheduled tasks, persistent files, and related data directories in backup and restore operations. (#10644, #10661)
- Gemini: Honor model-specific generation parameters and explicit zero values, and handle non-string enums in tool schemas. (#10719, #10635)
- NVIDIA Rerank: Preserve model-specific endpoint paths instead of substituting a generic endpoint. (#10732)
- Computer use: Parse Shipyard Bay execution envelopes correctly and clean up Windows shell child processes on timeout or cancellation. (#10671, #10729)
- WebUI: Preserve fetched model metadata after configuration refresh; restore default chat model selection; localize plugin sidebar names; fix desktop update notices and template field defaults. (#10522, #10663, #10576, #10622, #10517)
- WebUI: Clarify configuration hints and conditional settings; keep the Pip dialog visible in fullscreen logs; flush log stream headers promptly; prevent duplicate logs after navigation; clarify plugin filter scope. (#10647, #10608, #10666, #10694, #10691)
- Database: Use portable JSON query expressions. (#10664)
What's Changed
- feat: improve message tracing and add bounded SQLite history by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10614
- fix: preserve fetched model metadata after config refresh by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10522
- fix(dashboard): localize plugin names in sidebar by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10576
- fix: initialize template dict fields without explicit defaults by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10517
- fix: show clickable desktop update notices in header by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10622
- feat(install): add multilingual setup and mainland China mirrors by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10629
- chore(deps): bump github/codeql-action from 4.38.3 to 4.39.0 in the github-actions group by @dependabot[bot] in https://github.com/AstrBotDevs/AstrBot/pull/10636
- fix(dashboard): keep pip install dialog visible in console fullscreen by @mantoujun12 in https://github.com/AstrBotDevs/AstrBot/pull/10608
- fix(dashboard): clarify configuration hints and hide disabled options by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10647
- feat(dashboard): export logs from the console and settings pages by @niansia in https://github.com/AstrBotDevs/AstrBot/pull/10418
- fix(dashboard): complete diagnostic export improvements by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10659
- fix(tests): use consistent newlines in diagnostic export fixture by @Soulter in https:/
- v4.29.12026-10-17 · 2026-10-17 09:42 UTC
查看更新说明
我们计划于 2026 年 11 月 1 日停止支持对 < Python 3.12 版本的支持。如果您的 Python 版本仍然是 3.10, 3.11,请及时更换新的 Python 版本。
We plan to end support for Python versions prior to 3.12 on November 1st. If you are currently using Python 3.10 or 3.11, please upgrade to a newer version of Python.[4.29.1] - 2026-10-17
新增
- 网页搜索:“网页搜索” 能力新增 SerpApi 搜索服务 (Google 网页搜索、图片搜索、学术搜索、财经搜索)、DeepSeek 搜索服务(网页搜索、网页内容提取)。 (#10599)
- 插件开发:为插件的单选/多选配置项(list 类型)添加本地化的
subtitles副标题元数据。
修复
- ‼️ 电脑使用:修复部分环境(如 Docker 容器环境)下,本地隔离不可用时,无法保存 Local 权限的问题。(#10584)
- 电脑使用:恢复 Windows 下工作区范围内的文件读取、写入和编辑,通过原生文件句柄检查拒绝重解析点和硬链接别名。 (#10584)
- Core:修复开启 “会话隔离” 功能后可能造成的内存泄漏。在注册消息处理流水线之前完成群聊会话隔离,确保运行中的任务及停止请求使用正确的会话。 (#10581)
- Telegram:转换消息时保留隐藏链接。 (#10557)
- Discord:修复全体成员提及。 (#10563)
- WebUI:修复移动端点击插件视图信息后浮层立即关闭的问题。 (#10562)
- Edge TTS:保留原生客户端的 User-Agent,避免请求失败。 (#10588)
- Skills:跳过无法读取的本地及插件技能目录,避免单个目录异常导致整轮 Agent 请求失败。 (#10591)
Added
- Web Search: Added SerpApi (Google Search, Google Image Search, Google Scholar Search and Google Finance Search) and DeepSeek Search API (web search and page content extraction). (#10599)
- Plugin development: Added localized subtitle metadata for single-select/multi-select configuration options (of type 'list') in plugins.
Fixed
- ‼️ Computer Use: Restored workspace-scoped file reading, writing, and editing on Windows. Native handle checks reject reparse points and hardlink aliases. (#10584)
- Computer Use: Fixed saving Local permissions when isolation is unavailable. File access remains configurable; execution requiring unavailable isolation is blocked at tool execution. Defaults now give members workspace file access without execution, and administrators entire-environment execution with networking. Legacy Windows member policies with all access disabled migrate once to workspace file access, including identical manually disabled policies because their origin was not stored; later choices remain unchanged. (#10584)
- Core: Fixed a potential memory leak that could occur when the "session isolation" feature is enabled. Group chat session isolation is now performed before registering the message-processing pipeline, ensuring that both ongoing tasks and termination requests utilize the correct session. (#10581)
- Telegram: Preserved hidden links when converting messages. (#10557)
- Discord: Corrected everyone mentions. (#10563)
- WebUI: Kept plugin View information popovers open when tapped on mobile. (#10562)
- Edge TTS: Preserved the native client User-Agent to avoid request failures. (#10588)
- Skills: Skipped unreadable local and plugin skill directories instead of failing the entire agent request. (#10591)
Full Changelog: https://github.com/AstrBotDevs/AstrBot/compare/v4.29.0...v4.29.1
What's Changed
- fix: preserve Telegram hidden links in converted messages by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10557
- fix: correct Discord everyone mentions by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10563
- fix(dashboard): keep plugin view info popover open on mobile by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/10562
- fix(core): isolate sessions before pipeline registration by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10581
- fix: restore Windows workspace files and simplify Local permissions by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/10584
- feat(websearch): add DeepSeek search and page fetching by @letr007 in https://github.com/AstrBotDevs/AstrBot/pull/10599
- docs: add Simplified Chinese Code of Conduct and link it in issue templates by @XTsat in https://github.com/AstrBotDevs/AstrBot/pull/10580
- fix: preserve native Edge TTS user agent by @wcqqq1214 in https://github.com/AstrBotDevs/AstrBot/pull/10588
- fix(skills): keep one unreadable skill directory from failing the whole request by @he-yufeng in https://g
- v4.29.02026-10-14 · 2026-10-14 12:25 UTC
查看更新说明
[4.29.0] - 2026-10-14
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.
Major Additions
- Computer Use: Added OS-specific sandbox support for the local execution environment, available on macOS with Seatbelt and Linux with bubblewrap only. Please refer to: https://docs.astrbot.app/use/astrbot-agent-sandbox.html (#9472)
- ChatUI: Added chat history and sidebar session pagination, persistent input drafts, per-session model selection, and input autofocus when switching projects. (#9667, #10279, #10247, #10301)
- ChatUI: Added provider source filters and sticky groups to model selection, plus search on the Skills and MCP pages. (#10084, #10217)
- Text-to-image settings have moved from Settings to Configuration Profiles → Extensions and are now configured separately for each profile.
- Administrator and whitelist settings have moved from Configuration Profiles → Platform to Configuration Profiles → Access Control. (#10321)
- WebUI: Added a workspace directory picker and update download progress in the desktop app. (#10222, #10227, #10050)
- Desktop: Added macOS frosted-glass effects to the WebUI sidebar and top bar. (#10222, #10227, #10050)
- Core: Added agent step budget reminders, migrated legacy limits, increased the default agent step limit, and extended shell session waits. (#10131, #10133)
- Core: Added the
x-astrbot-conversation-idconversation ID header to provider requests. (#10218, #10237) - WebUI: Added model settings shortcuts beside selected models and in model/fallback menus. Changes save immediately for every configuration profile using that model. (#10321)
- WebUI: Added console log search and keyword highlighting, source badges for Skills, staged image previews in ChatUI, and remembered the last opened Data & Logs tab. (#10327, #10339, #10376, #10251)
- WebUI: Added configuration profile editing in a side drawer from the bot editor. (#10310)
- Docker: Included the
astrbotCLI for password reset inside containers. (#10442) - Logs: Added combined level, source, plugin, platform, and keyword filtering, an option to hide user-chat logs, and font-size controls from 8–16px (12px by default, in 2px steps). Plugin selectors show display names with IDs as subtitles. (#10514)
Major Optimizations
- WebUI: Refined the sidebar and top bar, reducing their vertical footprint to display more information. (#10222, #10227, #10050)
- Improved conversation data previews on the Data & Logs page. (#10021, #10020, #10023, #10108)
- Added resumable chunked uploads with bounded memory use, compressed dashboard static assets, and reduced bundled font and diagram assets. (#10123, #10187, #10034)
- Improved streamed response and reasoning panel scrolling, preserved scroll position while loading history, and coalesced automatic scrolling per animation frame. (#10219, #10221, #10243, #10253, #10257, #10271)
- Improved model input image preparation, preserved image geometry, limited encoded image sizes, and explained animation-to-frame conversion to models. (#9703, #10071, #10120, #10119)
- Batched console log rendering, optimized provider dialogs and trace updates, and removed unnecessary session and rate-limit work. (#9990, #10007, #10270, #10273, #10274)
- WebUI: Significantly reduced initial loading overhead and improved loading speed by lazy-loading VAD, Monaco, translations, and ApexCharts, and enabling gzip responses. (#10413)
- WebUI: Kept content borders and corners fixed while scrolling, added 6px desktop right/bottom gaps, and pinned configuration/settings headers and section navigation while the content pane scrolls. (#10480)
- Computer Use: Clarified local permission access modes, kept execution and file access controls visible when local isolation is unavailable, and linked setup guidance to the consolidated Agent Sandbox guide. (#10444, #10445, #10487)
- v4.29.0-beta.22026-10-10 · 2026-10-10 16:19 UTC
查看更新说明
[4.29.0-beta.2] - 2026-10-11
This prerelease includes changes since v4.29.0-beta.1.
Major Additions
- WebUI: Added model settings shortcuts beside selected models and in model/fallback menus. Changes save immediately for every configuration profile using that model. (#10321)
- WebUI: Added console log search and keyword highlighting, source badges for Skills, staged image previews in ChatUI, and remembered the last opened Data & Logs tab. (#10327, #10339, #10376, #10251)
- WebUI: Added configuration profile editing in a side drawer from the bot editor. (#10310)
- Docker: Included the
astrbotCLI for password reset inside containers. (#10442)
Major Optimizations
- WebUI: Significantly reduced initial loading overhead and improved loading speed by lazy-loading VAD, Monaco, translations, and ApexCharts, and enabling gzip responses. (#10413)
- WebUI: Kept content borders and corners fixed while scrolling, added 6px desktop right/bottom gaps, and pinned configuration/settings headers and section navigation while the content pane scrolls. (#10480)
- Computer Use: Clarified local permission access modes, kept execution and file access controls visible when local isolation is unavailable, and linked setup guidance to the consolidated Agent Sandbox guide. (#10444, #10445, #10487)
- Docs: Refreshed Chinese and English plugin and built-in AI guides with current workflows, troubleshooting, and localized screenshots; updated Slack and Lark/Feishu setup instructions. (#10487, #10353, #10400)
Major Fixes
- Agent: Stopping a session now stops its background agent work and prevents late main-agent wakeups. Cleaned up session waiters only once and kept async tool generators in the same task. (#10323, #10347, #10474)
- Agent: Warned when a background task result is not delivered to the user and avoided recording cron sends without a matching platform. (#10398, #10468)
- Core: Fell back promptly after failed context summaries, matched command group names as whole words, maintained one editable system default persona, and preserved child folders when deleting persona folders. (#10436, #10372, #10287, #10361)
- Providers: Preserved Anthropic tool calls with empty streamed input, merged custom server tools with registered tools, replaced the retired Gemini embedding default with
gemini-embedding-001, and handled CRLF separators in Dify streams. (#10432, #10437, #10393, #10392) - Images: Rejected unresolved and non-regular image references instead of fabricating local paths, retained pending-path handling for audio/video/files, and skipped invalid images during non-strict payload assembly. Added tolerance for oversized base64 payloads and long Windows paths. (#10434)
- Audio: Degraded unresolvable voice attachments without failing the turn, avoided blocking format probes, and closed FishAudio TTS clients after requests. (#10337, #10055, #10358)
- Platforms: Fixed UTF-16 offsets and case-insensitive bot mentions in Telegram, and left the Telegram token empty by default. Preserved Slack code blocks, quotes, lists, links, and mentions, and resolved remote Slack files before upload. Sent Discord video components as attachments and prevented self-reply loops. (#10367, #10399, #10365, #10380, #10447, #10448, #10355, #10423, #10425)
- WebUI: Enforced session ownership when sending chat messages, stored attachments under unique names, restored plugin README anchors, and corrected dark-mode log search and default-profile localization. (#10346, #10356, #10341, #10351, #10296)
- WebUI: Refreshed navigation and provider icons, corrected the configuration test-chat button theme color, and updated the plugin submission link and label. Reused logo tokens and refreshed expired platform caches. (#10304, #10332, #10309, #10471, #10294)
Navigation and Configuration Changes
- Sidebar: Core entries are grouped under System; Personas, Knowledge Base, scheduled tasks, subagent orchestration, and plugin Views appear under Extensions. The
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
简体中文 | 繁體中文 | 日本語 | Français | Español | Русский
Documentation | Blog | Roadmap | Issue Tracker | Email Support
AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
Key Features
- 💯 Free & Open Source.
- ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
- 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
- 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more.
- 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
- 🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse.
- 💻 WebUI Support.
- 🌈 Web ChatUI Support with built-in agent sandbox and web search.
- 🌐 Internationalization (i18n) Support.
Quick Start
One-Click Cloud Deployment (RainYun)
For users who want one-click 24-hour-online deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:
One-Click Deployment
[!NOTE] Requires uv to be installed. For macOS users: due to macOS security checks, the first run of the
astrbotcommand may take longer (about 10-20s).
For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a uv environment on their own, we recommend the uv one-click deployment method ⚡️:
uv tool install astrbot --python 3.12
astrbot init # Only execute this command for the first time to initialize the environment
astrbot run
Update astrbot:
uv tool upgrade astrbot --python 3.12
Docker Deployment
For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.
Please refer to the official documentation: Deploy AstrBot with Docker.
Desktop Application Deployment
For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.
Visit AstrBot-desktop to download and install; this method is designed for desktop usage and is not recommended for server scenarios.
Launcher Deployment
For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.
Visit AstrBot Launcher to download and install.
More deployment methods
If you need panel-based management or deeper customization, see BT-Panel Deployment, 1Panel Deployment, CasaOS Deployment, or Source Deployment.
❤️ Sponsors
Welcome to sponsor us via Afdian or contact us.
Supported Messaging Platforms
Connect AstrBot to your favorite chat platform.
| Platform | Maintainer |
|---|---|
| Official | |
| OneBot v11 protocol implementation | Official |
| Telegram | Official |
| Wecom & Wecom AI Bot | Official |
| WeChat Official Accounts | Official |
| Feishu (Lark) | Official |
| DingTalk | Official |
| Slack | Official |
| Discord | Official |
| LINE | Official |
| Satori | Official |
| KOOK | Official |
| Misskey | Official |
| Mattermost | Official |
| WhatsApp (Coming Soon) | Official |
| Matrix | Community |
| Rocket.Chat | Community |
| VoceChat | Community |
Supported Model Services
| Service | Type |
|---|---|
| OpenAI and Compatible Services | LLM Services |
| Anthropic | LLM Services |
| Google Gemini | LLM Services |
| Moonshot AI | LLM Services |
| Zhipu AI | LLM Services |
| DeepSeek | LLM Services |
| Ollama (Self-hosted) | LLM Services |
| LM Studio (Self-hosted) | LLM Services |
| MiraRouter | LLM Services (API Gateway, supports all models) |
| ShengSuanYun | LLM Services |
| AIHubMix | LLM Services (API Gateway, supports all models) |
| CompShare | LLM Services |
| 302.AI | LLM Services |
| TokenPony | LLM Services |
| SiliconFlow | LLM Services |
| PPIO Cloud | LLM Services |
| ModelScope | LLM Services |
| OneAPI | LLM Services |
| Dify | LLMOps Platforms |
| Alibaba Cloud Bailian Applications | LLMOps Platforms |
| Coze | LLMOps Platforms |
| OpenAI Whisper | Speech-to-Text Services |
| SenseVoice | Speech-to-Text Services |
| Xiaomi MiMo Omni | Speech-to-Text Services |
| OpenAI TTS | Text-to-Speech Services |
| Gemini TTS | Text-to-Speech Services |
| GPT-Sovits-Inference | Text-to-Speech Services |
| GPT-Sovits | Text-to-Speech Services |
| FishAudio | Text-to-Speech Services |
| Edge TTS | Text-to-Speech Services |
| Alibaba Cloud Bailian TTS | Text-to-Speech Services |
| Azure TTS | Text-to-Speech Services |
| Minimax TTS | Text-to-Speech Services |
| Xiaomi MiMo TTS | Text-to-Speech Services |
| Volcano Engine TTS | Text-to-Speech Services |
❤️ Contributing
Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)
How to Contribute
You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.
Development Environment
AstrBot uses ruff for code formatting and linting.
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install
🌍 Community
QQ Groups
We have 15+ chat groups, please see: Community for details.
Discord Server
❤️ Special Thanks
Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
Open Source Friends ❤️
- NapNeko/NapCatQQ - The amazing cat framework
- Mai-with-u/MaiBot - The powerful "digital life" in your QQ!
⭐ Star History
[!TIP] If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3
Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks.
私は、高性能ですから!