MicroClaw：自架 Rust 代理執行時期
此專案圍繞「An agentic AI assistant that lives in your chats, inspired by nanoclaw and incorporating some of its design ideas. Built with Rust.」建置，聚焦實際場景的開源實作，提供可重用的工具鏈與整合方式。
秒懂
- 它是什麼？
- 一個以 Rust 為基礎的代理執行時期，為聊天、網頁與代理協定提供統一的執行環境。
- 適合誰用？
- MicroClaw 將多通道代理行為統一到一個以 Rust 為基礎的執行時期，強調持久執行與可擴充性。其 MIT 授權允許廣泛使用，但專案本身不提供任何保證或支援。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 11 天前。
- 用什麼語言寫的？
- 主要是 Rust（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
專案定位與核心設計：1
MicroClaw 被描述為一個自架的 Rust 代理執行時期。其核心設計理念是使用一個與頻道無關的代理迴圈和一個與供應商無關的 LLM 層，為 Telegram、Discord、Slack、飛書/Lark、網頁等多種介面卡提供支援，而不在各邊界重複實作行為。它特別面向那些持續時間超過單一請求的任務，例如多步驟工具呼叫、可恢復工作階段、持久投遞、持久記憶、排程任務以及受管理的擴充。
驗證 MicroClaw 時，先選一個聊天介面卡與一個供應商，觀察工作階段恢復、工具核准和訊息投遞是否共享同一執行時期，再用 `microclaw doctor delivery` 檢查超長回覆的分塊、排序與重試。若要測試中斷恢復，應在模型與工具步驟間停止程序，確認已完成工具結果不會重放；對寫入工具則檢查不確定副作用是否停下來要求驗證。供應商矩陣、`docs/completion-contracts.md` 與生成工具目錄比概括功能表更適合作為實作依據。
本章的核對焦點是 microclaw-microclaw 第 1 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 1 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
主要特性與可靠性：2
專案強調單一執行時期支撐多個互動介面，執行可以跨處理程序重啟持續，並支援原生 Anthropic 或廣泛的 OpenAI 相容及本地供應商。其可擴充性體現在透過技能、MCP 伺服器、外掛、鉤子、工具或頻道介面卡進行擴充，而無需取代核心執行時期。設計上可在適度基礎設施上執行，依賴 Rust 服務與嵌入式 SQLite，無需單獨的向量資料庫或服務網格。安全方面，工具風險門控、範圍授予、出口控制、沙箱、編輯和稽核追蹤均使用共享的強制執行點。
本章的核對焦點是 microclaw-microclaw 第 2 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 2 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
可靠性驗證：3
README 中提供了一個可靠性驗證表格，說明了在特定情況下 MicroClaw 的保證。例如，當回覆超過頻道限制時，回覆會被持久接受，分塊排序並重試，且不丟失邊界位元組，可透過 `microclaw doctor delivery` 檢查。當處理程序在模型和工具步驟之間停止時，供應商無關的檢查點會恢復已完成的工作，而不重放已完成的工具結果。當支援寫入的工具被中斷時，恢復會停在不確定的副作用處並請求驗證，而非盲目重放呼叫。當頻道不可用時，任務完成與訊息投遞分離，結果可排隊等待重試。
本章的核對焦點是 microclaw-microclaw 第 3 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 3 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
工作流程與架構：4
每則訊息遵循相同的流程：恢復工作階段狀態並載入相關記憶、技能和執行時期內容；使用供應商無關的訊息和工具定義呼叫所選模型；透過共享的護欄、鉤子和授權檢查執行工具；持續執行直至完成，然後持久化該輪次並可靠地投遞結果。頻道介面卡僅負責翻譯入口和投遞事件，不攜帶自己的代理迴圈或特定於供應商的行為。
本章的核對焦點是 microclaw-microclaw 第 4 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 4 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
功能概覽：5
MicroClaw 的功能分為幾個領域：代理執行包括多步驟工具、平行唯讀波次、規劃、進度更新、完成契約和子代理；連續性包括可恢復工作階段、上下文壓縮、檢查點、持久出站投遞、排程和取消；記憶與學習包括檔案和 SQLite 記憶、語意召回、時間知識圖譜、經驗證據和受管理的技能演進；擴充包括技能、清單外掛、鉤子、MCP、ClawHub、A2A 和 ACP；介面包括本地 Web UI、HTTP/SSE/WebSocket API、聊天介面卡和代理協定；安全與營運包括工具核准、範圍能力授予、Docker 沙箱、出口政策、秘密編輯、指標、追蹤和診斷。
本章的核對焦點是 microclaw-microclaw 第 5 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 5 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
頻道與供應商支援：6
執行時期包含針對 Telegram、Discord、Slack、飛書/Lark、微信、釘釘、QQ、WhatsApp、Signal、Matrix、IRC、Nostr、iMessage、電子郵件和網頁的介面卡。Matrix 透過 `full` 功能啟用，各平台的可用性和設定要求有所不同。Anthropic 有原生提供程式路徑，而 OpenAI、OpenAI Codex、OpenRouter、Ollama、Google、DeepSeek、本地伺服器等透過共享的 OpenAI 相容路徑使用。生成的提供程式矩陣被視為當前 ID、協定、預設值和模型的權威來源。
本章的核對焦點是 microclaw-microclaw 第 6 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 6 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
安裝選項與文件：7
README 列出了多種安裝方式：適用於 macOS/Linux 的安裝腳本、適用於 Windows 的 PowerShell 腳本、Homebrew、容器以及原始碼建置。預建置的 Linux 二進位檔案有 glibc 和 OpenSSL 要求，在舊發行版上安裝前需閱讀入門指南。專案文件分為多個部分，包括入門指南、範例食譜、生成工具目錄、設定預設值、操作手冊、安全指南、開發與貢獻指南、測試指南以及變更日誌和升級指南。本地化的 README 檔案涵蓋專案概覽和快速入門，而英文技術文件被視為命令和設定事實的唯一權威來源。
本章的核對焦點是 microclaw-microclaw 第 7 個實作面向：將命令、檔案或設定鍵放進測試紀錄，並把 README 已說明的能力與尚未說明的部分分開。這樣閱讀結果才會對應到實際專案，而不是把一般工具的期待套在它身上。針對第 7 章，還要把輸入條件、執行結果與限制逐項寫下，尤其是 microclaw-microclaw 沒有承諾的功能，不應由標題或社群印象代替。這段專案分析也要交代環境、資料流、錯誤處理、版本差異和權限邊界，讓讀者能以同一組步驟重現觀察。採用者還應檢查安裝依賴是否與現有環境衝突，確認資料放在哪裡、誰能讀寫、失敗時如何回復，以及升級後設定是否仍然有效。若專案提供多種入口，就逐一比較它們的輸入格式、權限需求、輸出位置與日誌內容。這些細節比單純列出功能名稱更能說明 microclaw-microclaw 是否符合目標工作流，也能避免把作者的自報能力誤當成已經在目標環境證實的結果。
編輯結論
MicroClaw 將多通道代理行為統一到一個以 Rust 為基礎的執行時期，強調持久執行與可擴充性。其 MIT 授權允許廣泛使用，但專案本身不提供任何保證或支援。 對 microclaw-microclaw 而言，適合先在隔離環境由熟悉相關技術的團隊試用；不適合把 README 未承諾的能力當成保證。先依專案文件執行具體命令，檢查輸入、輸出、日誌、權限與重新啟動後的狀態，再決定是否擴大使用。
社群筆記