trustclaw
永续运行的个人AI助手:向量记忆 + 1000+工具 + Telegram,Vercel一键部署
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
永续运行的个人AI助手:向量记忆 + 1000+工具 + Telegram,Vercel一键部署
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象这样一个场景:你在睡觉,你的AI助手自动整理了你的 Gmail 邮件,把重要客户的问题标注出来,推送到你的 Telegram 上;它翻看了 GitHub 新 Issue,找到需要紧急修复的 bug,创建了 Linear 工单并分配给相应开发者;它注意到你日历上明天有个重要会议,提前准备了资料摘要。这不是科幻,而是 TrustClaw 的日常。
大语言模型(LLM)的对话记忆是短暂的——对话结束,记忆也随之消散。业界很早就意识到这个问题,解决方案大致分两类:一类是靠 Prompt Engineering 在每次请求中塞入历史上下文(成本高、容易爆 token);另一类是引入外部向量数据库,将对话摘要和关键信息持久化存储,检索时再召回。
TrustClaw 来自 ComposioHQ,是 OpenClaw 项目的安全重写版。Composio 本身是一个 AI Agent 工具平台,拥有 1000+ 工具集成(Gmail、GitHub、Slack、Notion、Linear、Calendar 等),TrustClaw 将这些能力打包成一套可自托管的个人 AI 助手系统,让用户在享受强大工具生态的同时,拥有对数据的完全控制权。
1. 记忆系统:PostgreSQL + pgvector 向量引擎
TrustClaw 的记忆系统构建在 PostgreSQL + pgvector 扩展之上。每个用户与 AI 的对话经过结构化处理后存储,支持三种记忆策略:
这种三层设计让 AI 的「记忆」可以跨越无限长的对话周期,不必担心上下文窗口耗尽。
2. 工具生态:1000+ OAuth 工具,零密码共享
TrustClaw 接入 Composio 平台,通过 OAuth 授权方式连接 Gmail、GitHub、Slack、Notion、Linear、Calendar、Drive、Stripe、HubSpot 等主流 SaaS 工具。所有授权通过 OAuth 完成,不存储任何第三方账户密码,避免密码泄露风险。工具调用在云端的沙盒环境中执行,任务完成后环境自动销毁。
3. 通信渠道:Web Dashboard + Telegram Bot
用户可以通过两种方式与 TrustClaw 交互:
4. 定时任务(Cron Jobs):让 AI 自动执行重复工作
TrustClaw 内置 Cron 任务调度器,用户可以配置定时任务:每天早上汇总邮件、每周一生成工作周报、检测 GitHub 仓库异常并告警……AI 在后台按计划运行,无需人工干预。
TrustClaw 的技术栈选择非常务实:
架构上采用标准的 Next.js 全栈模式:前端 React 组件 → tRPC Router → 服务端业务逻辑 → Composio 工具/PostgreSQL 数据库。API 层完全由 tRPC 托管,没有额外的 REST 端点,保证了前后端的类型一致性。
代码结构示例(tRPC Router):
import { router } from "~/server/api/trpc";
import { getInstance } from "./getInstance";
import { getStatus } from "./getStatus";
import { createInstance } from "./createInstance";
import { linkTelegram } from "./linkTelegram";
import { getCronJobs } from "./getCronJobs";
import { getMemories } from "./getMemories";
// ... 更多路由
export const trustclawRouter = router({
getInstance, getStatus, createInstance,
linkTelegram, getCronJobs, getMemories, ...
});
TrustClaw 的部署门槛极低,这是它最吸引人的地方。官方提供了两种快速部署方式:
方式一:Vercel 一键按钮(推荐)
点击 README 中的 Deploy with Vercel 按钮,在 Vercel 平台上自动 Fork 仓库、配置环境变量、自动部署。全程不需要本地安装任何工具。
方式二:CLI 部署
# 安装 CLI 并部署
npx @composio/trustclaw deploy
CLI 会自动检测本地 GitHub 认证、Vercel 账号,引导用户填写项目名称、配置 Composio API Key,自动创建 Vercel 项目并触发首次部署。
部署前需要准备:
openssl rand -base64 32 生成)部署完成后,AI 通过 Vercel AI Gateway 路由到 LLM 提供商(如 Claude),用户无需单独持有 Anthropic 或 OpenAI 的 API Key,降低了使用门槛。
⚠️ 注意:TrustClaw 目前没有提供 Dockerfile,不支持 Docker Compose 部署,完全依赖 Vercel 平台运行。如果你希望完全自托管(在自己的服务器上运行),需要额外做二次开发。
适合你吗?
需要考虑的点:
TrustClaw 出现的大背景是 Personal AI Agent 概念正在从极客圈走向大众。2024 年下半年开始,Claude Agent、Cursor、Devin 等产品相继亮相,但大多数聚焦在代码场景。TrustClaw 的差异化在于工具连接能力——通过 Composio 的 1000+ 工具生态,它能把 AI 的能力延伸到邮件、日历、CRM、项目管理等日常办公场景。
从架构设计来看,TrustClaw 强调「安全」和「自托管」两个关键词:OAuth 授权(不存密码)、沙盒执行(任务完成后销毁环境)、向量记忆(用户数据存在自己的数据库)。这些设计选择与 OpenClaw 的「security-first」理念一脉相承,也是它区别于那些纯 API 调用的 AI 助手的核心差异。
随着 AI Agent 工具生态的成熟,像 TrustClaw 这样「开箱即用 + 工具生态 + 可自托管」的个人助手,可能会成为继日历、邮件之后的下一个「必备数字工具」。
项目基本信息