Documentazione: integrazione di Knodge.eu in OpenClaw.ai

Documentazione: integrazione di Knodge.eu in OpenClaw.ai

Questa documentazione descrive la sinergia tra la piattaforma di conoscenza Knodge.eu (memoria centrale e regole) e il framework di agenti OpenClaw.ai (esecuzione locale e automazione).

#1 Esempio top: Onboarding di un sistema intelligente

In questo scenario, l'intelligenza artificiale conversa con un nuovo utente, ne apprende le preferenze e OpenClaw configura automaticamente l'ambiente di lavoro locale.

Cosa deve fare l'utente in Knodge.eu:

  • Creare un portale: Creare un portale (ad esempio internal-onboarding) tramite la dashboard o l'interfaccia API.
    Caricare le istruzioni: Caricare il modello istruzioni_onboarding.md nei documenti del portale.
  • Definire le preferenze:** Personalizzare le domande del file (ad esempio in base ai linguaggi di programmazione o alle preferenze dello strumento) che sono importanti per la configurazione locale.
  • **Salvare la chiave API: ** Copiare la chiave API del portale per consentire la comunicazione con l'esterno.

Cosa bisogna fare in OpenClaw:

  • Connessione API: Configurare una skill che invii le richieste a https://knodge.eu/api/portal/:slug/api-chat con l'intestazione X-API-Key.
  • Definire un trigger:** Creare un task che reagisca alla parola chiave #onboarding.
    Permessi locali: Consentire a OpenClaw di accedere al terminale (shell) per eseguire comandi di configurazione (ad esempio, git config) in base ai risultati dell'IA.

Il flusso di lavoro:

  1. l'utente avvia la chat in OpenClaw con #onboarding.
  2. OpenClaw inoltra il messaggio all'API di Knodge, che attiva il modello di onboarding.
  3. l'intelligenza artificiale raccoglie informazioni come il nome, il saluto e gli interessi.
  4. dopo la conversazione, l'IA utilizza lo strumento save_user_data per salvare un profilo come _user_{userId}.md in Knodge.
  5. OpenClaw legge questo profilo ed esegue localmente le impostazioni appropriate.

2. esempio top: Expert-Review e Compliance Fix

L'AI analizza i file locali secondo gli standard professionali e OpenClaw apporta le correzioni necessarie direttamente nel file system.

Cosa deve fare l'utente in Knodge.eu:

  • Fornire regole di esperti: Caricare _istruzione_esperto.md e _istruzione_checklist.md sul proprio portale.
  • Memorizzare la conoscenza: Caricare documenti PDF con standard di codifica o linee guida legali da usare come riferimento.

Cosa bisogna fare in OpenClaw:

  • Accesso ai file: Dare a OpenClaw i permessi di lettura e scrittura alla cartella del progetto da esaminare.
  • Comando di analisi: Implementare un comando che invii il contenuto di un file locale insieme alla parola chiave #expert all'API di Knodge.

Il flusso di lavoro:

  1. si dice a OpenClaw "Controlla config.py con #expert".
  2. OpenClaw invia il contenuto del file a Knodge; Knodge applica un'analisi approfondita e una terminologia tecnica.
  3. Knodge identifica i problemi e crea una lista di controllo passo-passo tramite #checklist, se necessario.
  4. OpenClaw lavora attraverso questa lista di controllo, corregge il codice localmente e convalida le modifiche tramite un comando da terminale.

Configurazione tecnica ed elenco futuro

Riepilogo della configurazione

Componente Knodge.eu (memoria) OpenClaw (esecuzione)
Autenticazione Intestazione X-API-Key Memorizzazione sicura dell'API-Key in .env
Controllo logico File con prefisso _istruzione_ Riconoscimento di parole chiave (es. #summary)
Salvataggio strumento save_user_data (file Markdown) chiamata allo strumento tramite ponte API
Lingue Supporto nativo di DeepL Possibilità di inserire comandi in 6 lingue

Elenco futuro (funzioni previste)

** Integrazione di plugin nativi:** Un plugin ufficiale di OpenClaw che integra i portali Knodge come archivio nativo di file (cloud vault).

  • Aggiornamento automatico dei file #istruzioni in Knodge in base al successo delle azioni locali di OpenClaw.
  • Memoria condivisa per i team di agenti:** Più istanze di OpenClaw accedono a un profilo utente condiviso tramite Knodge per risolvere compiti coordinati.
    Registro di controllo automatizzato: OpenClaw salva ogni comando di shell eseguito come documento verificato nel portale Knodge per garantire la sicurezza del controllo.