Dokumentation: Integration von Knodge.eu in OpenClaw.ai

Dokumentation: Integration von Knodge.eu in OpenClaw.ai

Diese Dokumentation beschreibt die Synergie zwischen der Wissensplattform Knodge.eu (Zentrales Gedächtnis und Regelwerk) und dem Agenten-Framework OpenClaw.ai (Lokale Ausführung und Automatisierung).

1. Top-Beispiel: Intelligentes System-Onboarding

In diesem Szenario führt die KI ein Gespräch mit einem neuen Nutzer, lernt dessen Präferenzen und OpenClaw konfiguriert daraufhin automatisch die lokale Arbeitsumgebung.

Was der User in Knodge.eu tun muss:

  • Portal erstellen: Erstelle ein Portal (z. B. internal-onboarding) über das Dashboard oder die API-Schnittstelle.
  • Instruktion hochladen: Lade das Template _instruction_onboarding.md in die Portal-Dokumente hoch.
  • Präferenzen definieren: Passe die Fragen in der Datei an (z. B. nach Programmiersprachen oder Tool-Vorlieben), die für die lokale Konfiguration wichtig sind.
  • API-Key sichern: Kopiere den API-Key für dein Portal, um die externe Kommunikation zu ermöglichen.

Was in OpenClaw gemacht werden muss:

  • API-Anbindung: Konfiguriere einen Skill, der Anfragen an https://knodge.eu/api/portal/:slug/api-chat mit dem Header X-API-Key sendet.
  • Trigger definieren: Erstelle einen Task, der auf das Keyword #onboarding reagiert.
  • Lokale Berechtigungen: Erlaube OpenClaw den Zugriff auf das Terminal (Shell), um Konfigurationsbefehle (z. B. git config) basierend auf den KI-Ergebnissen auszuführen.

Der Workflow:

  1. Der Nutzer startet den Chat in OpenClaw mit #onboarding.
  2. OpenClaw leitet die Nachricht an die Knodge-API weiter, welche das Onboarding-Template aktiviert.
  3. Die KI sammelt Informationen wie Name, Anrede und Interessen.
  4. Nach dem Gespräch nutzt die KI das Tool save_user_data, um ein Profil als _user_{userId}.md in Knodge zu speichern.
  5. OpenClaw liest dieses Profil aus und führt lokal die passenden Setups aus.

2. Top-Beispiel: Expert-Review & Compliance Fix

Die KI analysiert lokale Dateien nach professionellen Standards und OpenClaw führt die notwendigen Korrekturen direkt im Dateisystem durch.

Was der User in Knodge.eu tun muss:

  • Experten-Regeln bereitstellen: Lade _instruction_expert.md und _instruction_checklist.md in dein Portal hoch.
  • Wissen hinterlegen: Lade PDF-Dokumente mit Coding-Standards oder rechtlichen Richtlinien hoch, die als Referenz dienen sollen.

Was in OpenClaw gemacht werden muss:

  • Dateizugriff: Gib OpenClaw Lese- und Schreibrechte für den Projektordner, der geprüft werden soll.
  • Analyse-Befehl: Implementiere einen Befehl, der den Inhalt einer lokalen Datei zusammen mit dem Keyword #expert an die Knodge-API sendet.

Der Workflow:

  1. Du sagst OpenClaw: „Prüfe config.py mit #expert“.
  2. OpenClaw sendet den Dateiinhalt an Knodge; Knodge wendet die Tiefenanalyse und technische Fachterminologie an.
  3. Knodge identifiziert Probleme und erstellt bei Bedarf eine Schritt-für-Schritt-Checkliste via #checklist.
  4. OpenClaw arbeitet diese Checkliste ab, korrigiert den Code lokal und validiert die Änderungen durch einen Terminal-Befehl.

Technische Konfiguration & Future List

Konfigurations-Zusammenfassung

Komponente Knodge.eu (Gedächtnis) OpenClaw (Ausführung)
Authentifizierung X-API-Key Header API-Key sicher in .env speichern
Logik-Steuerung Dateien mit Präfix _instruction_ Keyword-Erkennung (z.B. #summary)
Speicherung Tool save_user_data (Markdown-Dateien) Tool-Aufruf via API-Bridge
Sprachen Native DeepL-Unterstützung Befehlseingabe in 6 Sprachen möglich

Future List (Geplante Features)

  • Native Plugin-Integration: Ein offizielles OpenClaw-Plugin, das Knodge-Portale als nativen Dateispeicher (Cloud-Vault) einbindet.
  • Dynamic Prompting: Automatische Aktualisierung von #instruction-Dateien in Knodge basierend auf dem Erfolg lokaler OpenClaw-Aktionen.
  • Shared Memory für Agenten-Teams: Mehrere OpenClaw-Instanzen greifen über Knodge auf ein gemeinsames Nutzerprofil zu, um koordinierte Aufgaben zu lösen.
  • Automatisierter Audit-Log: OpenClaw speichert jeden ausgeführten Shell-Befehl als verifiziertes Dokument im Knodge-Portal zur Revisionssicherheit.