AstrBot
AstrBot 是一款功能强大的开源 AI 智能体聊天机器人平台，旨在将先进的大语言模型（LLM）无缝集成到各类主流即时通讯软件中。它不仅仅是一个简单的聊天机器人，更是一个支持高度扩展的对话式 AI 基础设施，能够作为 OpenClaw 等工具的优质替代方案。
对于希望在不同社交平台（如 QQ、微信、Telegram 等）上部署统一 AI 助手的用户而言，AstrBot 解决了多平台适配复杂、模型切换困难以及功能扩展受限等痛点。通过其模块化设计，用户可以轻松接入多种大模型，并利用丰富的插件系统自定义 AI 的行为与能力，实现从日常闲聊到复杂任务处理的多样化场景覆盖。
这款工具特别适合开发者、技术爱好者以及需要构建私有化 AI 服务的企业或个人使用。无论是想要快速搭建专属智能助手的研究人员，还是希望为社群提供自动化服务的运营者，都能通过 AstrBot 获得稳定且可扩展的解决方案。其独特的亮点在于对多 IM 平台的广泛支持、灵活的插件生态以及便捷的部署方式（包括 Docker 一键部署），让技术门槛大幅降低，同时保持了极高的自由度与可定制性。
使用场景
某初创团队希望将内部知识库与 AI 能力整合，并通过微信、QQ 和 Discord 等多个即时通讯平台为不同部门的员工提供统一的智能问答服务。
没有 AstrBot 时
- 多平台重复开发：团队需要分别为微信、QQ 和 Discord 编写独立的机器人代码，维护三套完全不同的后端逻辑，开发成本极高。
- 模型切换困难：当需要测试新的开源大模型或切换商业 API 时，必须修改每个平台的对接代码，无法实现“一次配置，全局生效”。
- 功能扩展受限：想要添加“查询天气”或“搜索内部文档”等插件功能时，需在各个平台上单独实现接口调用，缺乏统一的插件市场支持。
- 运维部署繁琐：缺乏容器化支持，每次更新都需要手动在多台服务器上重启服务，且难以监控各渠道的消息并发状态。
使用 AstrBot 后
- 一站式多端接入：通过 AstrBot 统一的配置界面，仅需一次部署即可同时连接微信、QQ、Discord 等主流 IM 平台，底层消息处理逻辑完全复用。
- 灵活模型热切换：在可视化后台中可随意切换本地部署的 LLM 或云端 API，所有聊天渠道立即同步生效，无需重启服务或修改代码。
- 插件生态即插即用：直接利用内置的市场安装社区开发的插件（如联网搜索、数据库查询），瞬间为所有平台赋予相同的扩展能力。
- 容器化轻松运维：支持 Docker 一键部署，结合内置的监控面板，团队可轻松管理消息队列和系统资源，大幅降低运维门槛。
AstrBot 通过屏蔽底层异构平台的差异，让团队能专注于业务逻辑与提示词优化，真正实现了低成本构建企业级全渠道 AI 助手。
运行环境要求
- Linux
- macOS
- Windows
未说明 (支持本地部署 Ollama/LM Studio，具体显卡需求取决于所选模型)
未说明
快速开始
简体中文 ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ Русский
<div align=){kind=icon}
简体中文 ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ Русский
Documentation ｜ Blog ｜ Roadmap ｜ Issue Tracker ｜ Email Support
AstrBot 是一个开源的一体化 Agent 聊天机器人平台，可与主流即时通讯应用集成。它为个人、开发者和团队提供可靠且可扩展的对话式 AI 基础设施。无论您是构建个人 AI 伴侣、智能客服、自动化助手，还是企业知识库，AstrBot 都能让您在 IM 平台的工作流中快速搭建生产就绪的 AI 应用。
核心功能
- 💯 免费且开源。
- ✨ 支持 AI 大模型对话、多模态、Agent、MCP、技能、知识库、角色设定以及自动上下文压缩。
- 🤖 支持与 Dify、阿里云百炼、Coze 等其他 Agent 平台集成。
- 🌐 多平台支持：QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 等 更多。
- 📦 插件扩展，拥有 1000 多个插件可供一键安装。
- 🛡️ Agent 沙盒 可实现代码、Shell 命令的隔离安全执行，并支持会话级资源复用。
- 💻 支持 WebUI。
- 🌈 支持 Web ChatUI，内置 Agent 沙盒和网络搜索功能。
- 🌐 支持国际化（i18n）。
| 💙 角色扮演与情感陪伴 | ✨ 主动型 Agent | 🚀 通用 Agent 能力 | 🧩 1000+ 社区插件 |
|---|---|---|---|
|
|
|
|
快速入门
一键部署
对于希望快速体验 AstrBot、熟悉命令行操作并能自行安装 uv 环境的用户，我们推荐使用 uv 一键部署方式 ⚡️：
uv tool install astrbot --python 3.12
astrbot init # 仅在首次运行时执行此命令以初始化环境
astrbot run
需要先安装 uv。 AstrBot 要求 Python 3.12 或更高版本。
--python 3.12选项确保uv使用 Python 3.12 创建工具环境。
[!NOTE] 对于 macOS 用户：由于 macOS 的安全检查机制，首次运行
astrbot命令可能会花费较长时间（约 10–20 秒）。
更新 astrbot：
uv tool upgrade astrbot --python 3.12
[!WARNING] 通过
uv部署的 AstrBot 不支持通过 WebUI 升级。如需更新，请在命令行中运行上述命令。
Docker 部署
对于熟悉容器技术且寻求更稳定、适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。
请参考官方文档：使用 Docker 部署 AstrBot。
在 RainYun 上部署
对于希望实现一键部署且不想自行管理服务器的用户，我们推荐 RainYun 的一键云部署服务 ☁️：
桌面应用部署
对于希望在桌面端使用 AstrBot 并主要通过 ChatUI 进行交互的用户，我们推荐使用 AstrBot 桌面应用。
访问 AstrBot-desktop 下载并安装；该方法专为桌面使用设计，不建议用于服务器场景。
Launcher 部署
对于同样希望快速部署且需要隔离多实例使用的桌面用户，我们推荐使用 AstrBot Launcher。
访问 AstrBot Launcher 下载并安装。
在 Replit 上部署
Replit 部署由社区维护，适用于在线演示和轻量级试用。
AUR
AUR 部署面向偏好通过系统包管理流程安装 AstrBot 的 Arch Linux 用户。
运行以下命令安装 astrbot-git，然后在本地环境中启动 AstrBot。
yay -S astrbot-git
更多部署方式
如果您需要基于面板的管理或更深度的定制化，请参阅以下内容：BT-Panel 部署介绍如何通过 BT Panel 应用商店进行设置；1Panel 部署讲解如何通过 1Panel 应用市场进行部署；CasaOS 部署提供 NAS/家庭服务器的可视化部署方案；手动部署则允许您使用 uv 完全自定义源码安装。
支持的消息平台
将 AstrBot 连接到您喜爱的聊天平台。
| 平台 | 维护者 |
|---|---|
| 官方 | |
| OneBot v11 协议实现 | 官方 |
| Telegram | 官方 |
| Wecom & Wecom AI Bot | 官方 |
| 微信公众号 | 官方 |
| Feishu (Lark) | 官方 |
| DingTalk | 官方 |
| Slack | 官方 |
| Discord | 官方 |
| LINE | 官方 |
| Satori | 官方 |
| KOOK | 官方 |
| Misskey | 官方 |
| Mattermost | 官方 |
| WhatsApp（即将上线） | 官方 |
| Matrix | 社区 |
| Rocket.Chat | 社区 |
| VoceChat | 社区 |
支持的模型服务
| 服务 | 类型 |
|---|---|
| OpenAI 及兼容服务 | LLM 服务 |
| Anthropic | LLM 服务 |
| Google Gemini | LLM 服务 |
| Moonshot AI | LLM 服务 |
| Zhipu AI | LLM 服务 |
| DeepSeek | LLM 服务 |
| Ollama（自托管） | LLM 服务 |
| LM Studio（自托管） | LLM 服务 |
| AIHubMix | LLM 服务（API 网关，支持所有模型） |
| CompShare | LLM 服务 |
| 302.AI | LLM 服务 |
| TokenPony | LLM 服务 |
| SiliconFlow | LLM 服务 |
| PPIO Cloud | LLM 服务 |
| ModelScope | LLM 服务 |
| OneAPI | LLM 服务 |
| Dify | LLMOps 平台 |
| 阿里云百炼应用 | LLMOps 平台 |
| Coze | LLMOps 平台 |
| OpenAI Whisper | 文本转语音服务 |
| SenseVoice | 文本转语音服务 |
| 小米 MiMo Omni | 文本转语音服务 |
| OpenAI TTS | 语音合成服务 |
| Gemini TTS | 语音合成服务 |
| GPT-Sovits-Inference | 语音合成服务 |
| GPT-Sovits | 语音合成服务 |
| FishAudio | 语音合成服务 |
| Edge TTS | 语音合成服务 |
| 阿里云百炼 TTS | 语音合成服务 |
| Azure TTS | 语音合成服务 |
| Minimax TTS | 语音合成服务 |
| 小米 MiMo TTS | 语音合成服务 |
| 火山引擎 TTS | 语音合成服务 |
❤️ 赞助商
❤️ 贡献
欢迎随时提交问题和拉取请求！请随意向该项目贡献您的修改 :)
如何贡献
您可以参与问题评审或协助审查拉取请求。任何问题或 PR 都受到欢迎，以鼓励社区参与。当然，这些建议仅供参考，您也可以以任何您喜欢的方式做出贡献。若要添加新功能，请先通过 Issue 进行讨论。
开发环境
AstrBot 使用 ruff 进行代码格式化和 linting。
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install
🌍 社区
QQ 群组
群组 12：916228568（新群）
群组 9：1076659624（已满）
群组 10：1078079676（已满）
群组 11：704659519（已满）
群组 1：322154837（已满）
群组 3：630166526（已满）
群组 4：1077826412（已满）
群组 5：822130018（已满）
群组 6：753075035（已满）
群组 7：743746109（已满）
群组 8：1030353265（已满）
开发者群（闲聊）：975206796
开发者群（正式）：1039761811
Discord 服务器
❤️ 特别致谢
特别感谢所有贡献者和插件开发者对 AstrBot 的贡献 ❤️
此外，如果没有以下开源项目的帮助，本项目也不可能诞生：
- NapNeko/NapCatQQ - 令人惊叹的猫咪框架
⭐ 星标历史
[!TIP] 如果这个项目在你的生活或工作中对你有所帮助，或者你对它的未来发展感兴趣，请为该项目点亮一颗星吧。这将是我们持续维护这个开源项目的重要动力 <3
陪伴与能力不应相互矛盾。我们致力于打造一款既能理解情感、提供真诚陪伴，又能可靠完成任务的机器人。
私は、高性能ですから!
版本历史
v4.23.12026/04/13v4.23.02026/04/12v4.23.0-beta.12026/04/11v4.22.32026/04/04v4.22.22026/03/28v4.22.12026/03/25v4.22.02026/03/22v4.21.02026/03/21v4.20.12026/03/16v4.20.02026/03/12v4.19.52026/03/10v4.19.42026/03/09v4.19.32026/03/08v4.19.22026/03/05v4.18.32026/02/26v4.18.22026/02/24v4.18.12026/02/22v4.18.02026/02/21v4.17.62026/02/20v4.17.52026/02/18常见问题
相似工具推荐
openclaw
OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上
opencode
OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。 这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。 在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。
gemini-cli
gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。 这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。 它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。