Trustclaw

Что такое Trustclaw?

Trustclaw — самохостируемый персональный AI-агент, который выполняет повторяющиеся задачи, пока вас нет. Он подключается к интеграциям Composio через OAuth, запускает вызовы инструментов в изолированной удалённой среде и предоставляет чат через веб-панель (Next.js) и Telegram-бота.

Проект создан для безопасной работы по сравнению с запуском AI-агентов напрямую на локальной машине: он не передаёт агенту сырые API-ключи и не выполняет код на устройстве пользователя при работе с инструментами. Также включена долгосрочная память на базе Postgres и pgvector с многоступенчатым управлением контекстом.

Ключевые возможности

• Самохостируемое веб-приложение и Telegram-бот: используйте интерфейс Next.js или общайтесь через Telegram для ежедневного чата и обработки задач.
• Доступ к инструментам только через OAuth (интеграции Composio): вызовы инструментов авторизуются через подключённые аккаунты пользователя, а не через передачу паролей агенту.
• Изолированное выполнение действий инструментов: каждое действие запускается в отдельной удалённой среде и удаляется после завершения задачи, снижая риск локального выполнения кода.
• Долгосрочная память на Postgres + pgvector: хранит и извлекает память для длительных разговоров с помощью трёхуровневого управления контекстом (очистка, сброс памяти, суммирование/уплотнение).
• Автоматизация повторяющихся задач через cron: запланированный по cron runtime агента поддерживает выполнение задач в автоматическом режиме.
• Большой набор инструментов через 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. Установка CLI-инструментов Trustclaw: установите CLI с помощью команды curl -fsSL https://composio.dev/install | bash.
4. Предоставьте API-ключ Composio: инструкция требует бесплатный API-ключ Composio для работы с CLI.
5. Использование агента: после развёртывания общайтесь через веб-панель или Telegram и планируйте повторяющиеся задачи через runtime агента.

Примечания по маршрутизации LLM и эмбеддингов: вызовы LLM и эмбеддингов маршрутизируются через Vercel AI Gateway, и проект не требует API-ключей Anthropic или OpenAI.

Сценарии использования

• Повторяющиеся рабочие процессы с почтой: используйте интеграцию Gmail агента для автоматизации задач с помощью cron вместо ручной проверки.
• Поддержка рабочих процессов разработчиков: подключите GitHub (и связанные инструменты Slack или Linear) и позвольте агенту выполнять запланированные действия или отвечать на запросы со временем.
• Персональный ассистент продуктивности с контекстом документов и календаря: используйте интеграции Notion и Calendar для координации повторяющихся активностей и сохранения деталей с помощью долгосрочной памяти.
• Операционные задачи с платежами или CRM: используйте интеграции Stripe и HubSpot для автоматизированных повторяющихся процессов, ограниченных подключёнными аккаунтами пользователя.
• Эксперименты с безопасной настройкой агента: для разработчиков, оценивающих более безопасные паттерны агентов, Trustclaw предлагает архитектуру с акцентом на OAuth-доступ к инструментам и удалённое изолированное выполнение.

FAQ

• Действительно ли Trustclaw самохостируемый? Проект позиционирует себя как самохостируемый и предоставляет путь развёртывания через Vercel (включая шаблон) и CLI.

• Нужны ли агенту сырые API-ключи для каждого инструмента? Источник указывает, что дизайн избегает передачи сырых API-ключей агенту; доступ к инструментам осуществляется через Composio OAuth для каждой интеграции.

• Где происходит выполнение инструментов? Вызовы инструментов выполняются в изолированной удалённой среде; источник также отмечает отсутствие долгоживущего shell-доступа на машине пользователя.

• Как работает долгосрочная память? Память основана на Postgres с pgvector, а агент использует трёхуровневое управление контекстом (очистка, сброс памяти и суммирование/уплотнение).

• Есть ли ограничения развёртывания на бесплатном плане Vercel (Hobby)? Да. Источник предупреждает, что на Vercel Hobby cron-задачи запускаются раз в день (с окном 60 минут), а cron-выражения чаще одного раза в день не проходят развёртывание; функции ограничены 300 секундами. CLI настраивает vercel.json на ежедневный запуск при использовании Hobby, а более высокая частота требует обновления плана.

Альтернативы

• Локальные фреймворки AI-агентов с вызовом инструментов: Обычно выполняют больше логики на устройстве пользователя; по сравнению с Trustclaw могут требовать больше настройки и не всегда обеспечивают удалённую песочницу и брокеринг инструментов только через OAuth.
• Облачные персональные ассистенты автоматизации и чата: Облачные сервисы предлагают планирование и интеграцию инструментов без самостоятельного хостинга. По сравнению с Trustclaw вы получаете готовое решение, но теряете контроль над хостингом.
• Другие open-source рантаймы агентов с персистентностью: Ищите проекты, сочетающие выполнение инструментов со слоем персистентности (векторная база данных/память) и планированием агентов. Основные различия обычно касаются обработки учётных данных (OAuth или ключи) и места выполнения кода/вызовов инструментов (локально или в удалённой песочнице).