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 등 다양한 서비스를 사용자의 연결된 계정으로 제한하여 연동합니다.

사용 방법

1. Vercel 템플릿으로 빠르게 배포하거나 CLI 사용: 저장소는 Vercel 템플릿을 통한 배포 또는 npx @composio/trustclaw deploy 명령어를 안내합니다.
2. 사전 요구사항 한 번 설정: CLI 흐름은 Vercel 계정 (npx vercel login once)과 GitHub 계정 (gh auth login once)을 필요로 합니다.
3. Trustclaw CLI 도구 설치: 제공된 설치 명령어(curl -fsSL https://composio.dev/install | bash)로 CLI를 설치합니다.
4. Composio API 키 제공: CLI 사용을 위해 무료 Composio API 키가 필요합니다.
5. 에이전트 사용: 배포 후 웹 대시보드 또는 Telegram을 통해 채팅하고, 에이전트 런타임을 이용해 반복 작업을 예약합니다.

소스에서 언급된 LLM/임베딩 라우팅 관련 참고: LLM과 임베딩 호출은 Vercel AI Gateway를 통해 라우팅되며, 이 설정에서는 Anthropic 또는 OpenAI API 키가 필요하지 않습니다.

사용 사례

• 반복적인 받은편지함 또는 이메일 관련 워크플로: cron 스케줄링으로 Gmail 연동을 통해 수동 확인 대신 자동화된 작업을 수행합니다.
• 개발자를 위한 소프트웨어 워크플로 지원: GitHub(및 Slack, Linear 등 관련 도구)를 연결하여 에이전트가 예약된 작업을 실행하거나 요청에 응답하도록 합니다.
• 문서와 캘린더 컨텍스트를 활용한 개인 생산성 도우미: Notion과 Calendar 연동을 통해 반복 활동을 조율하고 장기 메모리로 관련 정보를 유지합니다.
• 결제 또는 CRM 도구를 다루는 운영 작업: Stripe와 HubSpot 연동을 통해 사용자의 연결된 계정으로 제한된 자동 반복 프로세스를 수행합니다.
• 안전한 에이전트 설정 실험: OAuth 도구 접근과 원격 샌드박스 실행을 강조하는 아키텍처를 통해 더 안전한 에이전트 패턴을 평가하는 개발자에게 적합합니다.

FAQ

• Trustclaw는 정말 셀프 호스팅 가능한가요? 프로젝트는 Vercel(템플릿 포함)과 CLI 흐름을 통한 배포 경로를 제공하며 셀프 호스팅이 가능하다고 설명합니다.

• 에이전트가 모든 도구에 원시 API 키가 필요한가요? 소스에서는 에이전트에 원시 API 키를 넘기지 않는 설계라고 명시하며, 각 연동에 대해 Composio OAuth를 통해 도구 접근을 중개합니다.

• 도구 실행은 어디서 이루어지나요? 도구 호출은 격리된 원격 샌드박스 환경에서 실행되며, 사용자 머신에 장기 셸 접근이 없다고 소스에서 언급합니다.

• 장기 메모리는 어떻게 작동하나요? 메모리는 Postgres와 pgvector를 기반으로 하며, 에이전트는 3계층 컨텍스트 관리(프루닝, 메모리 플러시, 요약/압축)를 사용합니다.

• Vercel 무료(Hobby) 플랜에 배포 제한이 있나요? 네. 소스에서는 Vercel Hobby에서 cron 작업이 하루 한 번(60분 창) 실행되며, 일일보다 빈번한 cron 표현식은 배포 시 실패한다고 경고합니다. 함수 실행 시간은 300초로 제한되며, CLI는 Hobby에서 vercel.json을 일일로 조정하고, 더 높은 정밀도는 업그레이드가 필요합니다.

대안

• 도구 호출 기능을 갖춘 로컬 AI 에이전트 프레임워크: 일반적으로 사용자 기기에서 더 많은 로직을 실행합니다. Trustclaw와 비교하면 더 많은 설정이 필요할 수 있으며, 동일한 원격 샌드박싱과 OAuth 전용 도구 중개 방식을 제공하지 않을 수 있습니다.
• 호스팅형 개인 자동화/채팅 어시스턴트: 클라우드 서비스는 셀프 호스팅 없이도 스케줄링과 도구 연동을 제공할 수 있습니다. Trustclaw와 비교하면 셀프 호스팅 제어 대신 더 즉시 사용 가능한 설정을 선택하게 됩니다.
• 지속성을 갖춘 다른 오픈소스 에이전트 런타임: 도구 실행과 지속성 계층(벡터 데이터베이스/메모리) 및 에이전트 스케줄링을 결합한 프로젝트를 찾아보세요. 차이점은 보통 자격 증명 처리 방식(OAuth vs 키)과 코드/도구 호출 실행 위치(로컬 vs 샌드박스 원격)에 따라 달라집니다.