Documentation : Intégration de Knodge.eu dans OpenClaw.ai

Documentation : Intégration de Knodge.eu dans OpenClaw.ai

Cette documentation décrit la synergie entre la plateforme de connaissances Knodge.eu (mémoire centrale et ensemble de règles) et le framework d'agents OpenClaw.ai (exécution locale et automatisation).

1. Exemple phare : Système intelligent d'embarquement

Dans ce scénario, l'IA s'entretient avec un nouvel utilisateur, apprend ses préférences et OpenClaw configure ensuite automatiquement l'environnement de travail local.

Ce que l'utilisateur doit faire dans Knodge.eu :

  • Créer un portail: Créer un portail (par exemple internal-onboarding) via le tableau de bord ou l'interface API.
    Télécharger l'instruction: Télécharge le modèle _instruction_onboarding.md dans les documents du portail.
  • Définir les préférences: Adapte les questions dans le fichier (par ex. selon les langages de programmation ou les préférences d'outils) qui sont importantes pour la configuration locale.
  • Sauvegarder la clé API: Copier la clé API pour ton portail afin de permettre la communication externe.

Ce qui doit être fait dans OpenClaw :

  • Lien API: Configurer une compétence qui envoie des requêtes à https://knodge.eu/api/portal/:slug/api-chat avec l'en-tête X-API-Key.
  • Définir les déclencheurs: Créer une tâche qui réagit au mot-clé #onboarding.
  • Permissions locales: Permettre à OpenClaw d'accéder au terminal (shell) pour exécuter des commandes de configuration (par exemple git config) basées sur les résultats de l'IA.

Le flux de travail :

  1. l'utilisateur démarre le chat dans OpenClaw avec #onboarding.
  2. OpenClaw transmet le message à l'API Knodge, qui active le modèle d'embarquement.
  3. l'IA collecte des informations telles que le nom, la salutation et les intérêts.
  4. après la conversation, l'IA utilise l'outil save_user_data pour enregistrer un profil en tant que _user_{userId}.md dans Knodge.
  5. OpenClaw lit ce profil et exécute localement les configurations appropriées.

2ème exemple : Expert-Review & Compliance Fix

L'IA analyse les fichiers locaux selon les normes professionnelles et OpenClaw effectue les corrections nécessaires directement dans le système de fichiers.

Ce que l'utilisateur doit faire dans Knodge.eu :

Fournir des règles expertes: Télécharger _instruction_expert.md et _instruction_checklist.md dans ton portail.
Déposer des connaissances: Télécharger des documents PDF avec des normes de codage ou des directives juridiques qui doivent servir de référence.

Ce qui doit être fait dans OpenClaw :

Accès aux fichiers: Donne à OpenClaw les droits de lecture et d'écriture pour le dossier du projet qui doit être examiné.

  • Commande d'analyse: Implémenter une commande qui envoie le contenu d'un fichier local avec le mot-clé #expert à l'API Knodge.

Le flux de travail :

  1. tu dis à OpenClaw : "Vérifie config.py avec #expert".
  2. OpenClaw envoie le contenu du fichier à Knodge ; Knodge applique l'analyse en profondeur et la terminologie technique.
  3. Knodge identifie les problèmes et, si nécessaire, crée une liste de contrôle étape par étape via #checklist.
  4. OpenClaw traite cette liste de contrôle, corrige le code localement et valide les modifications par une commande de terminal.

Configuration technique & Future List

Résumé de la configuration

composant Knodge.eu (mémoire) OpenClaw (exécution)
Authentification En-tête X-API-Key Enregistrer la clé API en toute sécurité dans .env
Contrôle logique Fichiers avec préfixe _instruction_ Reconnaissance de mots-clés (par ex. #summary)
Sauvegarde Outil save_user_data (fichiers Markdown) Appel de l'outil via le pont API
Langues Support natif de DeepL Saisie de commandes possible en 6 langues

Future List (fonctionnalités prévues)

Intégration de plugin natif: Un plugin officiel OpenClaw qui intègre les portails Knodge comme stockage de fichiers natif (Cloud-Vault).
Dynamic Prompting: Mise à jour automatique des fichiers #instruction dans Knodge basée sur le succès des actions locales d'OpenClaw.
Mémoire partagée pour les équipes d'agents: Plusieurs instances d'OpenClaw accèdent à un profil d'utilisateur commun via Knodge afin de résoudre des tâches coordonnées.

  • Log d'audit automatisé: OpenClaw enregistre chaque commande shell exécutée sous forme de document vérifié dans le portail Knodge pour la sécurité de l'audit.