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 与密钥）和代码/工具调用执行位置（本地与远程沙箱）。