nanobot：超輕量、可自託管的個人 AI 智慧體框架，瀏覽器、終端和聊天軟體共用一個閘道器

HKUDS/nanobot 的 README 開頭一句話說得很清楚：它是一個用 Python 寫的超輕量、開源、可自託管的個人 AI 智慧體框架，可以在瀏覽器、終端或聊天軟體裡使用，讓智慧體處理檔案、記住偏好、安排定時任務。它需要你自己接入受支援的模型服務或本地模型伺服器，nanobot 本身不提供模型。截至 2026 年 10 月 13 日，倉庫約有 48,978 個星標、8,626 個派生，MIT 許可，用 Python 編寫，建立於 2026 年 2 月 1 日，最近一次推送在 10 月 12 日。專案在 README 裡列出的“為什麼選擇 nanobot”有五點：持久的工作流、聊天軟體原生的觸達、模型自由、小而可讀的核心，以及“自己掌握整套技術棧”。 能力清單相當完整。它能接入 Telegram、Discord、Slack、微信、電子郵件、Mattermost、Linear 等渠道；用內建的檔案工具讀取 PDF、Word（.docx）、Excel（.xlsx）和 PowerPoint（.pptx），比如總結一份報告；使用命令列、網頁搜尋與抓取、MCP 整合、定時任務、影象生成和多智慧體委派；透過名為 Dream 的機制保留會話歷史和長期記憶；執行長週期目標和計劃自動化；提供 Python SDK 和相容 OpenAI 的 API；也可以作為長期執行的本地或伺服器閘道器部署。最新版本是 v0.3.5，更新說明稱它把工作臺帶到了終端，讓對話更容易在瀏覽器、終端和聊天軟體之間繼續，可以在 WebUI 裡並排排列最多四個對話，並檢視每一輪的上下文使用和壓縮排度。

安裝路徑很清楚。需要 Python 3.11 或更新版本。推薦用安裝指令碼自動設定：Linux 和 macOS 上用 curl 下載 install.sh，Windows 上用 PowerShell 的 install.ps1，指令碼會在啟用的虛擬環境、uv、pipx 或 ~/.nanobot/venv 裡安裝或升級 nanobot-ai，本地桌面會直接開啟 WebUI，SSH 和無頭環境則進入終端嚮導，還支援 --dry-run 先預覽計劃。熟悉工具鏈的人可以 uv tool install nanobot-ai 或 pip 安裝。隨後執行 nanobot webui，在設定裡選擇模型、儲存憑據，傳送一句“Hello!”驗證連線，再選一個練習資料夾和受限訪問模式，讓它讀 notes.txt 並寫出 summary.md，用來檢查檔案許可權是否按預期工作。平臺預編譯包同時包含 WebUI 和原生終端介面，覆蓋 macOS 13 以上、glibc 2.17 以上的 Linux（ARM64 與 x64）和 Windows x64，x64 執行時需要 SSE4.2；想用最新特性則從原始碼安裝，需要 Git 和 Bun。

架構上的取捨是它所說的“小核心”。Python 閘道器擁有智慧體的執行、會話、工具、記憶和安全策略，WebUI、終端介面和聊天軟體共享同一個執行時；核心的智慧體迴圈負責構建上下文、呼叫模型、執行請求的工具並返回結果，記憶、技能、渠道和 MCP 整合都是在這個迴圈上擴充套件。Python SDK 把執行時嵌入你自己的應用程序，而相容 OpenAI 的 API 會啟動一個獨立的 HTTP 服務，提供 /v1/chat/completions，每個請求只含一條使用者訊息，歷史由伺服器管理，模型由配置決定。WebUI 允許為不同任務保留獨立的“話題”，也有不寫入歷史和長期記憶的臨時對話；但 README 同時提醒，話題只隔離會話歷史，專案資料夾只決定檔案操作發生在哪裡，二者都不會產生獨立的長期記憶，一個例項的智慧體檔案、記憶和技能會在所有專案間共享，如果客戶資料或偏好必須隔離，應該使用多個獨立例項。

對想自託管的人，安全提醒值得放在前面。README 明確寫道：WebUI 的訪問許可權等同於管理同一個智慧體例項，只應分享給可信的操作者；接入聊天軟體前，要分別檢查平臺的私聊配對、白名單和群組訪問策略，因為批准一個私聊傳送者並不一定會限制所有平臺的群組訪問；定時任務需要閘道器持續執行、主機不休眠，閘道器重啟後錯過的時間點不會補發。另外，臨時對話的請求仍然會發給所配置的模型服務，工具建立的檔案在對話關閉後依然保留，所以“臨時”不等於“不外發”。 我們的判斷是，nanobot 的價值在於它把“個人智慧體”做成了一個可讀的小系統，而不是一個必須依賴某家雲的產品：你能看到核心迴圈，決定接哪個模型，決定資料放在哪裡。需要保持清醒的地方也很明確。第一，星標和更新頻率說明社群活躍，但並不等於穩定，它的 README 自己區分了穩定版和當前原始碼，日常使用應選穩定版。第二，智慧體擁有檔案、命令列和聊天渠道的許可權，許可權設定不當時風險與能力同樣大，建議從受限訪問模式和單個練習資料夾開始。第三，模型費用或本地硬體要求取決於你的選擇，nanobot 不會替你解決。建議先在隔離的機器或容器裡部署，只接入一個自己的聊天賬號並設定白名單，用一週的真實任務檢驗它是否值得長期執行。