README_zh-TW.md

简体中文 ｜ English ｜ 日本語 ｜ Français ｜ Русский

文件 ｜ Blog ｜ 路線圖 ｜ 問題回報

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

主要功能

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+ 社區外掛程式

快速開始

Docker 部署（推薦 🥳）

推薦使用 Docker / Docker Compose 方式部署 AstrBot。

請參閱官方文件 使用 Docker 部署 AstrBot。

uv 部署

uv tool install astrbot
astrbot

桌面應用部署（Tauri）

桌面應用倉庫 AstrBot-desktop。

支援多系統架構，安裝包直接安裝，開箱即用，最適合新手和懶人的一鍵桌面部署方案，不推薦伺服器場景。

啟動器一鍵部署（AstrBot Launcher）

快速部署和多開方案，實現環境隔離，進入 AstrBot Launcher 倉庫，在 Releases 頁最新版本下找到對應的系統安裝包安裝即可。

寶塔面板部署

AstrBot 與寶塔面板合作，已上架至寶塔面板。

請參閱官方文件 寶塔面板部署。

1Panel 部署

AstrBot 已由 1Panel 官方上架至 1Panel 面板。

請參閱官方文件 1Panel 部署。

在雨雲上部署

AstrBot 已由雨雲官方上架至雲端應用程式平台，可一鍵部署。

在 Replit 上部署

社群貢獻的部署方式。

Windows 一鍵安裝器部署

請參閱官方文件 使用 Windows 一鍵安裝器部署 AstrBot。

CasaOS 部署

社群貢獻的部署方式。

請參閱官方文件 CasaOS 部署。

手動部署

首先安裝 uv：

pip install uv

透過 Git Clone 安裝 AstrBot：

git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
uv run main.py

或者請參閱官方文件 透過原始碼部署 AstrBot。

系統套件管理員安裝

Arch Linux

yay -S astrbot-git
# 或者使用 paru
paru -S astrbot-git

支援的訊息平台

官方維護

• QQ（官方平台 & OneBot）
• Telegram
• 企微應用 & 企微智慧機器人
• 微信客服 & 微信公眾號
• 飛書
• 釘釘
• Slack
• Discord
• Satori
• Misskey
• LINE
• Whatsapp（即將支援）

社群維護

• Matrix
• KOOK
• VoceChat

支援的模型服務

大型模型服務

• OpenAI 及相容服務
• Anthropic
• Google Gemini
• Moonshot AI
• 智譜 AI
• DeepSeek
• Ollama（本機部署）
• LM Studio（本機部署）
• 優雲智算
• 302.AI
• 小馬算力
• 矽基流動
• PPIO 派歐雲
• ModelScope
• OneAPI

LLMOps 平台

• Dify
• 阿里雲百煉應用
• Coze

語音轉文字服務

• OpenAI Whisper
• SenseVoice

文字轉語音服務

• OpenAI TTS
• Gemini TTS
• GPT-Sovits-Inference
• GPT-Sovits
• FishAudio
• Edge TTS
• 阿里雲百煉 TTS
• Azure TTS
• Minimax 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 群組

• 1 群：322154837
• 3 群：630166526
• 5 群：822130018
• 6 群：753075035
• 開發者群：975206796

Telegram 群組

Discord 群組

❤️ Special Thanks

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

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

• NapNeko/NapCatQQ - 偉大的貓貓框架

⭐ Star History

Tip

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

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

私は、高性能ですから!