Trustclaw

Trustclaw 是什麼？

Trustclaw 是一款可自架設的個人 AI 助理，能在您不在時執行循環任務。它透過 OAuth 串接 Composio 工具整合，在沙箱化的遠端環境中執行工具呼叫，並透過 Next.js 網頁儀表板與 Telegram 機器人提供聊天體驗。

此專案設計注重安全運作，與直接在本地機器上執行 AI 代理相比，它避免將原始 API 金鑰交給代理，也避免在工具執行期間於使用者裝置上執行程式碼。同時內建由 Postgres 與 pgvector 支援的長期記憶，採用多步驟情境管理機制。

主要功能

• 可自架設的網頁應用程式與 Telegram 機器人：使用 Next.js 介面或透過 Telegram 進行日常聊天與任務處理。
• 僅限 OAuth 的工具存取（Composio 整合）：工具呼叫透過使用者已連接的帳戶授權，而非將密碼分發給代理。
• 沙箱化工具動作執行：每項動作在隔離的遠端環境中執行，任務完成後即移除，降低本地程式碼執行的風險。
• 使用 Postgres + pgvector 的長期記憶：透過 3 層情境管理（剪枝、記憶清除、摘要/壓縮）儲存與擷取較長對話的記憶。
• 透過 cron 自動化循環工作：cron 排程的代理執行環境支援自動駕駛模式下的循環任務。
• 透過 Composio 提供廣泛工具介面（1000+ 整合）：整合服務包含 Gmail、GitHub、Slack、Notion、Linear、Calendar、Drive、Stripe 與 HubSpot 等，需透過使用者已連接的帳戶進行存取。

如何使用 Trustclaw

1. 快速部署（Vercel 模板）或使用 CLI：儲存庫提供透過 Vercel 模板部署，或執行 npx @composio/trustclaw deploy。
2. 一次性設定先決條件：CLI 流程需要您擁有 Vercel 帳戶（執行 npx vercel login once）與 GitHub 帳戶（執行 gh auth login once）。
3. 安裝 Trustclaw CLI 工具：使用提供的安裝指令安裝 CLI（curl -fsSL https://composio.dev/install | bash）。
4. 提供 Composio API 金鑰：說明文件要求使用 免費的 Composio API 金鑰 搭配 CLI。
5. 使用代理：部署完成後，可透過網頁儀表板或 Telegram 聊天，並使用代理執行環境排程循環任務。

來源關於 LLM/嵌入路由的說明：LLM 與嵌入呼叫透過 Vercel AI Gateway 路由，此設定不需要 Anthropic 或 OpenAI API 金鑰。

使用情境

• 循環收件匣或電子郵件相關工作流程：使用代理的 Gmail 整合搭配 cron 排程，自動化持續性任務，而非手動檢查。
• 開發者的軟體工作流程支援：連接 GitHub（以及 Slack 或 Linear 等相關工具），讓代理隨時間執行排程動作或回應請求。
• 具備文件與日曆情境的個人生產力助理：使用 Notion 與 Calendar 等整合，協助協調循環活動，並利用長期記憶保留相關細節。
• 涉及付款或 CRM 工具的操作任務：使用 Stripe 與 HubSpot 整合進行自動化循環流程，限制在使用者已連接的帳戶範圍內。
• 安全代理設定的實務實驗：對於評估更安全代理模式的開發者，Trustclaw 提供強調 OAuth 工具存取與遠端沙箱化執行的架構。

常見問題

• Trustclaw 真的可以自架設嗎？ 此專案自稱可自架設，並提供透過 Vercel（含模板）的部署路徑以及 CLI 流程。

• 代理是否需要每個工具的原始 API 金鑰？ 來源說明設計避免將原始 API 金鑰交給代理；工具存取透過 Composio OAuth 為每個整合進行仲介。

• 工具執行發生在哪裡？ 工具呼叫在隔離的遠端沙箱化環境中執行；來源也指出使用者機器上沒有長期 shell 存取。

• 長期記憶如何運作？ 記憶由 Postgres 與 pgvector 支援，代理使用 3 層情境管理（剪枝、記憶清除、摘要/壓縮）。

• Vercel 免費（Hobby）方案是否有部署限制？ 是。來源警告在 Vercel Hobby 方案下，cron 工作每天執行一次（60 分鐘視窗），比每天更頻繁的 cron 表達式會導致部署失敗；函式上限為 300 秒。CLI 會在 Hobby 方案下將 vercel.json 調整為每日執行，更高精確度需升級方案。

替代方案

• 具工具呼叫功能的本地 AI 代理框架：這些方案通常在使用者裝置上執行更多邏輯；相較 Trustclaw，它們可能需要更多設定，且無法提供相同的遠端沙箱與僅限 OAuth 的工具仲介方式。
• 託管式個人自動化／聊天助理：雲端服務可提供排程與工具整合，無需自行架設。相較 Trustclaw，您會以犧牲自架控制權換取更即開即用的設定。
• 其他具持久性的開源代理執行環境：可尋找結合工具執行、持久層（向量資料庫／記憶體）與代理排程的專案。差異通常在於憑證處理方式（OAuth 與金鑰）以及程式碼／工具呼叫的執行位置（本地或遠端沙箱）。