Skip to content

Latest commit

 

History

History
277 lines (201 loc) · 13.7 KB

File metadata and controls

277 lines (201 loc) · 13.7 KB

AstrBot-Logo-Simplified

AstrBot 是一個開源的一站式 Agent 聊天機器人平台,可接入主流即時通訊軟體,為個人、開發者和團隊打造可靠、可擴展的對話式智慧基礎設施。無論是個人 AI 夥伴、智慧客服、自動化助手,還是企業知識庫,AstrBot 都能在您的即時通訊軟體平台的工作流程中快速構建生產可用的 AI 應用程式。

screenshot_1 5x_postspark_2026-02-27_22-37-45

主要功能

  1. 💯 免費 & 開源。
  2. ✨ AI 大模型對話,多模態,Agent,MCP,Skills,知識庫,人格設定,自動壓縮對話。
  3. 🤖 支援接入 Dify、阿里雲百煉、Coze 等智慧體 (Agent) 平台。
  4. 🌐 多平台,支援 QQ、企業微信、飛書、釘釘、微信公眾號、Telegram、Slack 以及更多
  5. 📦 插件擴展,已有 1000+ 個插件可一鍵安裝。
  6. 🛡️ Agent Sandbox 隔離化環境,安全地執行任何代碼、調用 Shell、會話級資源複用。
  7. 💻 WebUI 支援。
  8. 🌈 Web ChatUI 支援,ChatUI 內置代理沙盒 (Agent Sandbox)、網頁搜尋等。
  9. 🌐 國際化(i18n)支援。

💙 角色扮演 & 情感陪伴 ✨ 主動式 Agent 🚀 通用 Agentic 能力 🧩 1000+ 社區外掛程式

99b587c5d35eea09d84f33e6cf6cfd4f

c449acd838c41d0915cc08a3824025b1

image

image

快速開始

一鍵部署

對於想快速體驗 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 建立 tool 環境。

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

在雨雲上部署

對於希望一鍵部署 AstrBot 且不想自行管理伺服器的使用者,我們推薦使用雨雲的一鍵雲端部署服務 ☁️:

Deploy on RainYun

桌面客戶端部署

對於希望在桌面端使用 AstrBot、並以 ChatUI 為主要入口的使用者,我們推薦使用 AstrBot App。

前往 AstrBot-desktop 下載並安裝;此方式面向桌面使用,不建議伺服器場景。

啟動器部署

同樣在桌面端,對於希望快速部署並實現環境隔離多開的使用者,我們推薦使用 AstrBot Launcher。

前往 AstrBot Launcher 下載並安裝。

在 Replit 上部署

Replit 部署由社群維護,適合線上示範與輕量試用情境。

Run on Repl.it

AUR

AUR 方式面向 Arch Linux 使用者,適合希望透過系統套件管理器安裝 AstrBot 的場景。

在終端執行下方命令安裝 astrbot-git 套件,安裝完成後即可啟動使用。

yay -S astrbot-git

更多部署方式

若你需要面板化或更高自訂程度的部署,可參考 寶塔面板(BT Panel 應用商店安裝)、1Panel(1Panel 應用商店安裝)、CasaOS(NAS / 家用伺服器可視化部署)與 手動部署(基於原始碼與 uv 的完整自訂安裝)。

支援的訊息平台

將 AstrBot 連接到你常用的聊天平台。

平台 維護方
QQ 官方維護
OneBot v11 協議實作 官方維護
Telegram 官方維護
企微應用 & 企微智慧機器人 官方維護
微信客服 & 微信公眾號 官方維護
飛書 官方維護
釘釘 官方維護
Slack 官方維護
Discord 官方維護
LINE 官方維護
Satori 官方維護
KOOK 官方維護
Misskey 官方維護
Mattermost 官方維護
WhatsApp(即將支援) 官方維護
Matrix 社群維護
Rocket.Chat 社群維護
VoceChat 社群維護

支援的模型服務

服務 類型
OpenAI 及相容服務 大型模型服務
Anthropic 大型模型服務
Google Gemini 大型模型服務
Moonshot AI 大型模型服務
智譜 AI 大型模型服務
DeepSeek 大型模型服務
Ollama(本機部署) 大型模型服務
LM Studio(本機部署) 大型模型服務
AIHubMix 大型模型服務(API 閘道,支援所有模型)
優雲智算 大型模型服務
302.AI 大型模型服務
小馬算力 大型模型服務
矽基流動 大型模型服務
PPIO 派歐雲 大型模型服務
ModelScope 大型模型服務
OneAPI 大型模型服務
Dify LLMOps 平台
阿里雲百煉應用 LLMOps 平台
Coze LLMOps 平台
OpenAI Whisper 語音轉文字服務
SenseVoice 語音轉文字服務
Xiaomi MiMo Omni 語音轉文字服務
OpenAI TTS 文字轉語音服務
Gemini TTS 文字轉語音服務
GPT-Sovits-Inference 文字轉語音服務
GPT-Sovits 文字轉語音服務
FishAudio 文字轉語音服務
Edge TTS 文字轉語音服務
阿里雲百煉 TTS 文字轉語音服務
Azure TTS 文字轉語音服務
Minimax TTS 文字轉語音服務
Xiaomi MiMo TTS 文字轉語音服務
火山引擎 TTS 文字轉語音服務

❤️ 貢獻

歡迎任何 Issues/Pull Requests!只需要將您的變更提交到此專案 :)

如何貢獻

您可以透過檢視問題或協助審核 PR(拉取請求)來貢獻。任何問題或 PR 都歡迎參與,以促進社群貢獻。當然,這些只是建議,您可以以任何方式進行貢獻。對於新功能的新增,請先透過 Issue 討論。

開發環境

AstrBot 使用 ruff 進行程式碼格式化和檢查。

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 群組

Discord_community

❤️ Special Thanks

特別感謝所有 Contributors 和外掛開發者對 AstrBot 的貢獻 ❤️

此外,本專案的誕生離不開以下開源專案的幫助:

⭐ Star History

Tip

如果本專案對您的生活 / 工作產生了幫助,或者您關注本專案的未來發展,請給專案 Star,這是我們維護這個開源專案的動力 <3

Star History Chart

陪伴與能力從來不應該是對立面。我們希望創造的是一個既能理解情緒、給予陪伴,也能可靠完成工作的機器人。

私は、高性能ですから!