Trustclaw

Was ist Trustclaw?

Trustclaw ist ein selbsthostbarer persönlicher KI-Agent, der wiederkehrende Aufgaben ausführen kann, während du abwesend bist. Er verbindet sich über OAuth mit Composio-Tool-Integrationen, führt Tool-Calls in einer isolierten Remote-Umgebung aus und bietet eine Chat-Erfahrung über ein Web-Dashboard (Next.js) sowie einen Telegram-Bot.

Das Projekt ist für sicheren Betrieb konzipiert, im Vergleich zum direkten Ausführen von KI-Agenten auf einem lokalen Rechner: Es vermeidet die Übergabe roher API-Schlüssel an den Agenten und verhindert die Ausführung von Code auf dem Gerät des Nutzers während der Tool-Ausführung. Es enthält außerdem ein Langzeitgedächtnis auf Basis von Postgres und pgvector mit einem mehrstufigen Kontext-Management-Ansatz.

Wichtige Funktionen

• Selbsthostbare Web-App und Telegram-Bot: Nutze die Next.js-Oberfläche oder interagiere über Telegram für tägliche Chats und Aufgabenbearbeitung.
• OAuth-only Tool-Zugriff (Composio-Integrationen): Tool-Calls werden über die verbundenen Konten des Nutzers autorisiert, statt Passwörter an den Agenten weiterzugeben.
• Isolierte Ausführung von Tool-Aktionen: Jede Aktion läuft in einer isolierten Remote-Umgebung und wird nach Abschluss der Aufgabe entfernt, wodurch das Risiko lokaler Code-Ausführung reduziert wird.
• Langzeitgedächtnis mit Postgres + pgvector: Speichert und ruft Speicher für längere Gespräche ab, unter Verwendung eines 3-Schichten-Kontext-Managements (Pruning, Memory Flush, Zusammenfassung/Kompaktierung).
• Automatisierte wiederkehrende Arbeit via Cron: Eine cron-gesteuerte Agenten-Laufzeit unterstützt wiederkehrende Aufgaben im Autopilot-Modus.
• Große Tool-Oberfläche via Composio (1000+ Integrationen): Integrationen umfassen Dienste wie Gmail, GitHub, Slack, Notion, Linear, Calendar, Drive, Stripe und HubSpot (unter anderen), beschränkt auf die verbundenen Konten des Nutzers.

So nutzt du Trustclaw

1. Schnell deployen (Vercel-Template) oder CLI verwenden: Das Repo beschreibt die Bereitstellung über ein Vercel-Template oder die Ausführung von npx @composio/trustclaw deploy.
2. Voraussetzungen einmalig einrichten: Der CLI-Flow erfordert ein Vercel-Konto (npx vercel login once) und ein GitHub-Konto (gh auth login once).
3. Trustclaw-CLI-Tools installieren: Installiere die CLI mit dem bereitgestellten Installationsbefehl (curl -fsSL https://composio.dev/install | bash).
4. Composio-API-Schlüssel bereitstellen: Die Anleitung fordert einen kostenlosen Composio-API-Schlüssel, der mit der CLI verwendet wird.
5. Den Agenten nutzen: Nach der Bereitstellung chattest du über das Web-Dashboard oder Telegram und planst wiederkehrende Aufgaben über die Agenten-Laufzeit.

Hinweise zur LLM-/Embeddings-Routing aus der Quelle: LLM- und Embedding-Aufrufe werden über den Vercel AI Gateway geroutet, und das Projekt gibt an, dass keine Anthropic- oder OpenAI-API-Schlüssel für dieses Setup erforderlich sind.

Anwendungsfälle

• Wiederkehrende Posteingangs- oder E-Mail-bezogene Workflows: Nutze die Gmail-Integration des Agenten, um laufende Aufgaben mit Cron-Scheduling zu automatisieren, statt manuell zu prüfen.
• Software-Workflow-Unterstützung für Entwickler: Verbinde GitHub (und verwandte Tools wie Slack oder Linear) und lass den Agenten geplante Aktionen ausführen oder über die Zeit auf Anfragen reagieren.
• Persönlicher Produktivitätsassistent mit Dokumenten- und Kalenderkontext: Nutze Integrationen wie Notion und Calendar, um wiederkehrende Aktivitäten zu koordinieren und relevante Details mit Langzeitgedächtnis zu behalten.
• Operative Aufgaben mit Zahlungs- oder CRM-Tools: Nutze Stripe- und HubSpot-Integrationen für automatisierte wiederkehrende Prozesse, beschränkt auf die verbundenen Konten des Nutzers.
• Praktische Experimente mit einer sicheren Agenten-Architektur: Für Entwickler, die sicherere Agenten-Muster evaluieren, bietet Trustclaw eine Architektur, die OAuth-Tool-Zugriff und remote isolierte Ausführung betont.

FAQ

• Ist Trustclaw wirklich selbsthostbar? Das Projekt beschreibt sich als selbsthostbar und bietet einen Bereitstellungspfad über Vercel (inklusive Template) sowie einen CLI-Flow.

• Benötigt der Agent rohe API-Schlüssel für jedes Tool? Die Quelle gibt an, dass das Design die Übergabe roher API-Schlüssel an den Agenten vermeidet; Tool-Zugriff wird über Composio OAuth für jede Integration vermittelt.

• Wo findet die Tool-Ausführung statt? Tool-Calls werden in einer isolierten remote-sandboxed Umgebung ausgeführt; die Quelle weist außerdem darauf hin, dass kein langlebiger Shell-Zugriff auf dem Gerät des Nutzers besteht.

• Wie funktioniert das Langzeitgedächtnis? Das Gedächtnis basiert auf Postgres mit pgvector, und der Agent verwendet ein 3-Schichten-Kontext-Management (Pruning, Memory Flush und Zusammenfassung/Kompaktierung).

• Gibt es Bereitstellungsbeschränkungen auf dem Vercel Free (Hobby)-Plan? Ja. Die Quelle warnt, dass auf Vercel Hobby Cron-Jobs einmal pro Tag laufen (mit einem 60-Minuten-Fenster) und Cron-Ausdrücke, die häufiger als täglich sind, die Bereitstellung fehlschlagen lassen; Funktionen sind auf 300 Sekunden begrenzt. Die CLI passt vercel.json auf täglich an, wenn Hobby verwendet wird, und höhere Präzision erfordert ein Upgrade.

Alternativen

• Lokale KI-Agent-Frameworks mit Tool-Calling: Diese führen in der Regel mehr Logik auf dem Gerät des Nutzers aus. Im Vergleich zu Trustclaw können sie mehr Konfiguration erfordern und bieten möglicherweise nicht dieselbe Remote-Sandboxing- und OAuth-only-Tool-Brokerage-Lösung.
• Gehostete persönliche Automatisierungs- und Chat-Assistenten: Cloud-Dienste ermöglichen Planung und Tool-Integrationen ohne Self-Hosting. Im Vergleich zu Trustclaw verzichtet man auf die Kontrolle durch Self-Hosting zugunsten einer schlüsselfertigen Lösung.
• Weitere Open-Source-Agent-Laufzeiten mit Persistenz: Suchen Sie nach Projekten, die Tool-Ausführung mit einer Persistenzschicht (Vektordatenbank/Speicher) und Agenten-Planung kombinieren. Unterschiede liegen meist darin, wie sie Anmeldedaten (OAuth vs. Schlüssel) handhaben und wo Code- und Tool-Aufrufe ausgeführt werden (lokal vs. remote in der Sandbox).