Trustclaw

Qu’est-ce que Trustclaw ?

Trustclaw est un agent IA personnel auto-hébergeable capable d’exécuter des tâches récurrentes pendant votre absence. Il se connecte aux intégrations Composio via OAuth, exécute les appels d’outils dans un environnement distant isolé et propose une interface de chat via un tableau de bord web (Next.js) et un bot Telegram.

Le projet est conçu pour une utilisation sécurisée par rapport à l’exécution directe d’agents IA sur une machine locale : il évite de transmettre les clés API brutes à l’agent et ne lance pas de code sur l’appareil de l’utilisateur pendant l’exécution des outils. Il inclut également une mémoire à long terme basée sur Postgres et pgvector, avec une gestion contextuelle en plusieurs étapes.

Fonctionnalités principales

• Application web et bot Telegram auto-hébergeables : Utilisez l’interface Next.js ou interagissez via Telegram pour les conversations quotidiennes et la gestion des tâches.
• Accès aux outils uniquement via OAuth (intégrations Composio) : Les appels d’outils sont autorisés via les comptes connectés de l’utilisateur plutôt que par la distribution de mots de passe à l’agent.
• Exécution isolée des actions d’outils : Chaque action s’exécute dans un environnement distant isolé et est supprimée une fois la tâche terminée, réduisant le risque d’exécution locale de code.
• Mémoire à long terme avec Postgres + pgvector : Stocke et récupère la mémoire pour des conversations prolongées grâce à une gestion contextuelle en 3 couches (élagage, vidage mémoire, résumé/compaction).
• Travail récurrent automatisé via cron : Un agent planifié par cron prend en charge les tâches récurrentes en mode automatique.
• Large éventail d’outils via Composio (plus de 1000 intégrations) : Les intégrations incluent des services tels que Gmail, GitHub, Slack, Notion, Linear, Calendar, Drive, Stripe et HubSpot (entre autres), limités aux comptes connectés de l’utilisateur.

Comment utiliser Trustclaw

1. Déploiement rapide (modèle Vercel) ou utilisation de la CLI : Le dépôt décrit le déploiement via un modèle Vercel ou l’exécution de npx @composio/trustclaw deploy.
2. Configuration unique des prérequis : Le flux CLI nécessite un compte Vercel (npx vercel login once) et un compte GitHub (gh auth login once).
3. Installation de l’outil CLI Trustclaw : Installez la CLI avec la commande fournie (curl -fsSL https://composio.dev/install | bash).
4. Fourniture d’une clé API Composio : Les instructions demandent une clé API Composio gratuite à utiliser avec la CLI.
5. Utilisation de l’agent : Après le déploiement, discutez via le tableau de bord web ou Telegram et planifiez des tâches récurrentes avec l’agent.

Notes sur le routage LLM/embeddings : les appels LLM et embeddings sont acheminés via Vercel AI Gateway, et le projet indique qu’aucune clé API Anthropic ou OpenAI n’est requise pour cette configuration.

Cas d’usage

• Workflows récurrents liés à la boîte de réception ou aux e-mails : Utilisez l’intégration Gmail de l’agent pour automatiser des tâches continues avec planification cron plutôt que des vérifications manuelles.
• Assistance aux workflows logiciels pour développeurs : Connectez GitHub (et des outils associés comme Slack ou Linear) et laissez l’agent exécuter des actions planifiées ou répondre aux demandes au fil du temps.
• Assistant de productivité personnelle avec contexte documents et calendrier : Utilisez des intégrations comme Notion et Calendar pour coordonner des activités récurrentes et conserver les détails pertinents grâce à la mémoire à long terme.
• Tâches opérationnelles touchant aux paiements ou aux outils CRM : Utilisez les intégrations Stripe et HubSpot pour des processus récurrents automatisés, limités aux comptes connectés de l’utilisateur.
• Expérimentation pratique d’une configuration d’agent sécurisée : Pour les développeurs évaluant des modèles d’agents plus sûrs, Trustclaw propose une architecture mettant l’accent sur l’accès aux outils via OAuth et l’exécution isolée à distance.

FAQ

• Trustclaw est-il vraiment auto-hébergeable ? Le projet se décrit comme auto-hébergeable et propose un chemin de déploiement via Vercel (y compris un modèle) ainsi qu’un flux CLI.

• L’agent a-t-il besoin des clés API brutes pour chaque outil ? La source indique que la conception évite de transmettre les clés API brutes à l’agent ; l’accès aux outils est géré via Composio OAuth pour chaque intégration.

• Où s’exécutent les outils ? Les appels d’outils s’exécutent dans un environnement isolé distant ; la source précise également qu’il n’y a pas d’accès shell persistant sur la machine de l’utilisateur.

• Comment fonctionne la mémoire à long terme ? La mémoire est basée sur Postgres avec pgvector, et l’agent utilise une gestion contextuelle en 3 couches (élagage, vidage mémoire et résumé/compaction).

• Existe-t-il des limites de déploiement sur le plan gratuit Vercel (Hobby) ? Oui. La source avertit que sur Vercel Hobby, les tâches cron s’exécutent une fois par jour (avec une fenêtre de 60 minutes) et que les expressions cron plus fréquentes que quotidiennes échouent au déploiement ; les fonctions sont limitées à 300 secondes. La CLI ajuste vercel.json à une fréquence quotidienne sur Hobby, et une précision supérieure nécessite une mise à niveau.

Alternatives

• Frameworks d’agents IA locaux avec appel d’outils : ils exécutent généralement plus de logique sur la machine de l’utilisateur ; par rapport à Trustclaw, ils peuvent nécessiter davantage de configuration et ne proposent pas toujours le même sandboxing distant ni la même approche de courtage d’outils uniquement via OAuth.
• Assistants d’automatisation et de chat personnels hébergés : les services cloud permettent la planification et les intégrations d’outils sans auto-hébergement. Par rapport à Trustclaw, vous échangez le contrôle de l’auto-hébergement contre une configuration plus clé en main.
• Autres environnements d’exécution d’agents open source avec persistance : recherchez des projets qui associent exécution d’outils et couche de persistance (base de données vectorielle/mémoire) ainsi que la planification d’agents. Les différences portent généralement sur la gestion des identifiants (OAuth vs clés) et sur l’endroit où s’exécutent le code et les appels d’outils (local vs sandbox distant).