Trustclaw

¿Qué es Trustclaw?

Trustclaw es un agente de IA personal autoalojable que puede realizar tareas recurrentes mientras estás ausente. Se conecta a integraciones de herramientas de Composio mediante OAuth, ejecuta llamadas a herramientas en un entorno remoto aislado y ofrece una experiencia de chat a través de un panel web (Next.js) y un bot de Telegram.

El proyecto está diseñado para un funcionamiento seguro en comparación con ejecutar agentes de IA directamente en una máquina local: evita entregar claves API en bruto al agente y evita ejecutar código en el dispositivo del usuario durante la ejecución de herramientas. También incluye memoria a largo plazo respaldada por Postgres y pgvector, utilizando un enfoque de gestión de contexto en varios pasos.

Características principales

• Aplicación web y bot de Telegram autoalojables: Usa la interfaz Next.js o interactúa a través de Telegram para el chat diario y la gestión de tareas.
• Acceso a herramientas solo mediante OAuth (integraciones de Composio): Las llamadas a herramientas se autorizan a través de las cuentas conectadas del usuario en lugar de distribuir contraseñas al agente.
• Ejecución aislada para acciones de herramientas: Cada acción se ejecuta en un entorno remoto aislado y se elimina al finalizar la tarea, reduciendo el riesgo de ejecución de código local.
• Memoria a largo plazo con Postgres + pgvector: Almacena y recupera memoria para conversaciones prolongadas mediante gestión de contexto en 3 capas (poda, vaciado de memoria, resumen/compresión).
• Trabajo recurrente automatizado mediante cron: Un tiempo de ejecución de agente programado por cron permite tareas recurrentes en piloto automático.
• Amplia superficie de herramientas mediante Composio (más de 1000 integraciones): Las integraciones incluyen servicios como Gmail, GitHub, Slack, Notion, Linear, Calendar, Drive, Stripe y HubSpot (entre otros), controladas por las cuentas conectadas del usuario.

Cómo usar Trustclaw

1. Despliegue rápido (plantilla de Vercel) o usa la CLI: El repositorio describe el despliegue mediante una plantilla de Vercel o ejecutando npx @composio/trustclaw deploy.
2. Configura los requisitos previos una vez: El flujo de la CLI requiere que tengas una cuenta de Vercel (npx vercel login once) y una cuenta de GitHub (gh auth login once).
3. Instala la herramienta CLI de Trustclaw: Instala la CLI mediante el comando de instalación proporcionado (curl -fsSL https://composio.dev/install | bash).
4. Proporciona una clave API de Composio: Las instrucciones requieren una clave API gratuita de Composio para usarla con la CLI.
5. Usa el agente: Tras el despliegue, chatea a través del panel web o Telegram y programa tareas recurrentes mediante el tiempo de ejecución del agente.

Notas sobre el enrutamiento de LLM/embeddings del origen: Las llamadas a LLM y embeddings se enrutan a través de Vercel AI Gateway, y el proyecto indica que no se requieren claves API de Anthropic ni OpenAI para esta configuración.

Casos de uso

• Flujos de trabajo recurrentes de bandeja de entrada o correo electrónico: Usa la integración de Gmail del agente para automatizar tareas continuas con programación cron en lugar de comprobaciones manuales.
• Soporte de flujos de trabajo de software para desarrolladores: Conecta GitHub (y herramientas relacionadas como Slack o Linear) y deja que el agente ejecute acciones programadas o responda a solicitudes a lo largo del tiempo.
• Asistente de productividad personal con contexto de documentos y calendario: Usa integraciones como Notion y Calendar para coordinar actividades recurrentes y conservar detalles relevantes mediante memoria a largo plazo.
• Tareas operativas que involucran pagos o herramientas CRM: Usa integraciones de Stripe y HubSpot para procesos recurrentes automatizados, limitados a las cuentas conectadas del usuario.
• Experimentación práctica con una configuración de agente segura: Para desarrolladores que evalúan patrones de agentes más seguros, Trustclaw proporciona una arquitectura que enfatiza el acceso a herramientas mediante OAuth y la ejecución remota aislada.

Alternativas

• Frameworks de agentes de IA locales con llamadas a herramientas: Estos suelen ejecutar más lógica en la máquina del usuario; en comparación con Trustclaw, pueden requerir más configuración y no ofrecen el mismo aislamiento remoto ni el enfoque de intermediación de herramientas solo mediante OAuth.
• Asistentes de automatización y chat personales alojados: Los servicios en la nube pueden ofrecer programación e integraciones de herramientas sin necesidad de autoalojamiento. En comparación con Trustclaw, se renuncia al control del autoalojamiento a cambio de una configuración más lista para usar.
• Otros entornos de ejecución de agentes de código abierto con persistencia: Busca proyectos que combinen la ejecución de herramientas con una capa de persistencia (base de datos vectorial/memoria) y programación de agentes. Las diferencias suelen radicar en cómo gestionan las credenciales (OAuth frente a claves) y dónde se ejecutan las llamadas a código o herramientas (local frente a remoto aislado).