TrustClaw：给AI装上「记忆」和「工具」，让它替你完成一切

想象这样一个场景：你在睡觉，你的AI助手自动整理了你的 Gmail 邮件，把重要客户的问题标注出来，推送到你的 Telegram 上；它翻看了 GitHub 新 Issue，找到需要紧急修复的 bug，创建了 Linear 工单并分配给相应开发者；它注意到你日历上明天有个重要会议，提前准备了资料摘要。这不是科幻，而是 TrustClaw 的日常。

背景：为什么 Personal AI Agent 需要「记忆」？

大语言模型（LLM）的对话记忆是短暂的——对话结束，记忆也随之消散。业界很早就意识到这个问题，解决方案大致分两类：一类是靠 Prompt Engineering 在每次请求中塞入历史上下文（成本高、容易爆 token）；另一类是引入外部向量数据库，将对话摘要和关键信息持久化存储，检索时再召回。

TrustClaw 来自 ComposioHQ，是 OpenClaw 项目的安全重写版。Composio 本身是一个 AI Agent 工具平台，拥有 1000+ 工具集成（Gmail、GitHub、Slack、Notion、Linear、Calendar 等），TrustClaw 将这些能力打包成一套可自托管的个人 AI 助手系统，让用户在享受强大工具生态的同时，拥有对数据的完全控制权。

核心功能：三层架构打造「永续运行」的 AI 助手

1. 记忆系统：PostgreSQL + pgvector 向量引擎

TrustClaw 的记忆系统构建在 PostgreSQL + pgvector 扩展之上。每个用户与 AI 的对话经过结构化处理后存储，支持三种记忆策略：

• 上下文裁剪（Pruning）：对话过长时，裁剪低权重消息，保留核心内容
• 记忆刷新（Memory Flush）：定期将对话片段提炼为摘要向量，持久化存储
• 摘要压缩（Compaction）：长期对话的摘要再压缩，减少存储开销

这种三层设计让 AI 的「记忆」可以跨越无限长的对话周期，不必担心上下文窗口耗尽。

2. 工具生态：1000+ OAuth 工具，零密码共享

TrustClaw 接入 Composio 平台，通过 OAuth 授权方式连接 Gmail、GitHub、Slack、Notion、Linear、Calendar、Drive、Stripe、HubSpot 等主流 SaaS 工具。所有授权通过 OAuth 完成，不存储任何第三方账户密码，避免密码泄露风险。工具调用在云端的沙盒环境中执行，任务完成后环境自动销毁。

3. 通信渠道：Web Dashboard + Telegram Bot

用户可以通过两种方式与 TrustClaw 交互：

• Next.js Dashboard：浏览器中访问 AI 对话界面，支持会话管理、工具连接、设置面板
• Telegram Bot：随时随地通过 Telegram 发送指令或接收 AI 的推送通知，真正实现「24/7 在线」

4. 定时任务（Cron Jobs）：让 AI 自动执行重复工作

TrustClaw 内置 Cron 任务调度器，用户可以配置定时任务：每天早上汇总邮件、每周一生成工作周报、检测 GitHub 仓库异常并告警……AI 在后台按计划运行，无需人工干预。

技术架构：Next.js 全家桶 + tRPC 类型安全 API

TrustClaw 的技术栈选择非常务实：

• Next.js 15（App Router）：React 全栈框架，既是前端 UI 框架，也承担服务端渲染和 API Route 功能
• tRPC：TypeScript 专用的类型安全 API 调用层，前端直接调用后端函数而无需手动编写 REST 端点，类型自动推导，开发体验极佳
• Prisma ORM + PostgreSQL/pgvector：Prisma 负责数据库建模和查询，pgvector 扩展提供向量存储和相似度检索能力
• Better Auth：轻量级认证库，提供用户名/密码登录、会话管理、OAuth 账户关联
• Vercel AI SDK（@ai-sdk/react）：连接 LLM 提供商（Anthropic Claude、OpenAI 等），支持流式响应（Streaming）

架构上采用标准的 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, ...
});

部署体验：「一键上 Vercel」，2分钟跑起来

TrustClaw 的部署门槛极低，这是它最吸引人的地方。官方提供了两种快速部署方式：

方式一：Vercel 一键按钮（推荐）

点击 README 中的 Deploy with Vercel 按钮，在 Vercel 平台上自动 Fork 仓库、配置环境变量、自动部署。全程不需要本地安装任何工具。

方式二：CLI 部署

# 安装 CLI 并部署
npx @composio/trustclaw deploy

CLI 会自动检测本地 GitHub 认证、Vercel 账号，引导用户填写项目名称、配置 Composio API Key，自动创建 Vercel 项目并触发首次部署。

部署前需要准备：

• Vercel 账号 + GitHub 账号关联
• PostgreSQL 数据库（支持 pgvector 扩展，Neon 免费套餐即可）
• Composio API Key（官网注册即有免费额度）
• 两个随机密钥（BETTER_AUTH_SECRET 和 CRON_SECRET，用 openssl rand -base64 32 生成）

部署完成后，AI 通过 Vercel AI Gateway 路由到 LLM 提供商（如 Claude），用户无需单独持有 Anthropic 或 OpenAI 的 API Key，降低了使用门槛。

⚠️ 注意：TrustClaw 目前没有提供 Dockerfile，不支持 Docker Compose 部署，完全依赖 Vercel 平台运行。如果你希望完全自托管（在自己的服务器上运行），需要额外做二次开发。

适用人群与局限

适合你吗？

• ✅ 想要个人 AI 助手，连接 Gmail/GitHub/Slack 等日常工作工具
• ✅ 希望 AI 能在后台定时执行任务（如每天汇总邮件、每周生成报告）
• ✅ 需要 Telegram 随时随地与 AI 交互
• ✅ 对数据隐私有要求，希望自己掌控数据存储

需要考虑的点：

• ❌ 目前只能部署到 Vercel，不支持纯 Docker 自托管
• ❌ LLM 调用依赖 Composio API Key（免费额度有限，高频使用需要付费）
• ❌ 定时任务（Cron Jobs）目前需要通过 API 配置，缺少可视化 UI
• ❌ 数据库使用 PostgreSQL，需要自己维护（有 Neon 等托管服务）

行业意义：Personal AI Agent 的平民化实践

TrustClaw 出现的大背景是 Personal AI Agent 概念正在从极客圈走向大众。2024 年下半年开始，Claude Agent、Cursor、Devin 等产品相继亮相，但大多数聚焦在代码场景。TrustClaw 的差异化在于工具连接能力——通过 Composio 的 1000+ 工具生态，它能把 AI 的能力延伸到邮件、日历、CRM、项目管理等日常办公场景。

从架构设计来看，TrustClaw 强调「安全」和「自托管」两个关键词：OAuth 授权（不存密码）、沙盒执行（任务完成后销毁环境）、向量记忆（用户数据存在自己的数据库）。这些设计选择与 OpenClaw 的「security-first」理念一脉相承，也是它区别于那些纯 API 调用的 AI 助手的核心差异。

随着 AI Agent 工具生态的成熟，像 TrustClaw 这样「开箱即用 + 工具生态 + 可自托管」的个人助手，可能会成为继日历、邮件之后的下一个「必备数字工具」。

项目基本信息

• ⭐ Stars：832 | 🍴 Forks：194
• 🏷️ License：MIT
• 🔤 语言：TypeScript
• 🏠 主页：https://github.com/ComposioHQ/trustclaw