README Zh TW

<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh.md">简体中文</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">English</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>

<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"></a> <a href="https://hub.docker.com/r/soulter/astrbot"></a>

<a href="https://astrbot.app/">文件</a> ｜ <a href="https://blog.astrbot.app/">Blog</a> ｜ <a href="https://astrbot.featurebase.app/roadmap">路線圖</a> ｜ <a href="https://github.com/AstrBotDevs/AstrBot/issues">問題回報</a> ｜ <a href="mailto:[email protected]">Email</a>

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）支援。

快速開始

一鍵部署

對於想快速體驗 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 且不想自行管理伺服器的使用者，我們推薦使用雨雲的一鍵雲端部署服務 ☁️：

桌面客戶端部署

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

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

啟動器部署

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

前往 AstrBot Launcher 下載並安裝。

在 Replit 上部署

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

AUR

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

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

yay -S astrbot-git

更多部署方式

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

支援的訊息平台

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

支援的模型服務

❤️ 貢獻

歡迎任何 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 群組

<a href="https://discord.gg/hAVk6tgV36"></a>

❤️ Special Thanks

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

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

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

⭐ Star History

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

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

私は、高性能ですから!