Documentación: Integración de Knodge.eu en OpenClaw.ai

Documentación: Integración de Knodge.eu en OpenClaw.ai

Esta documentación describe la sinergia entre la plataforma de conocimiento Knodge.eu (memoria central y reglas) y el framework de agentes OpenClaw.ai (ejecución local y automatización).

#1 Ejemplo principal: Integración inteligente de sistemas

En este escenario, la IA mantiene una conversación con un nuevo usuario, aprende sus preferencias y OpenClaw configura automáticamente el entorno de trabajo local.

Lo que el usuario tiene que hacer en Knodge.eu:

  • Crear portal: Crear un portal (por ejemplo internal-onboarding) a través del panel de control o la interfaz API.
    **Subir la plantilla _instruction_onboarding.md a los documentos del portal.
  • Definir preferencias:** Personalizar las preguntas del archivo (por ejemplo, según los lenguajes de programación o las preferencias de la herramienta) que son importantes para la configuración local.
  • Guardar clave API: Copie la clave API de su portal para permitir la comunicación externa.

Lo que hay que hacer en OpenClaw:

  • Conexión API: Configurar una habilidad que envíe peticiones a https://knodge.eu/api/portal/:slug/api-chat con la cabecera X-API-Key.
  • Definir trigger:** Crear una tarea que reaccione a la palabra clave #onboarding.
    Permisos locales: Permitir a OpenClaw acceder al terminal (shell) para ejecutar comandos de configuración (por ejemplo git config) basados en los resultados de la IA.

El flujo de trabajo:

  1. el usuario inicia el chat en OpenClaw con #onboarding.
  2. OpenClaw reenvía el mensaje a la API de Knodge, que activa la plantilla de onboarding.
  3. la IA recoge información como nombre, saludo e intereses.
  4. tras la conversación, la IA utiliza la herramienta save_user_data para guardar un perfil como _user_{userId}.md en Knodge.
  5. OpenClaw lee este perfil y ejecuta localmente las configuraciones adecuadas.

2. ejemplo superior: Expert-Review & Compliance Fix

La IA analiza los archivos locales según normas profesionales y OpenClaw realiza las correcciones necesarias directamente en el sistema de archivos.

Lo que el usuario tiene que hacer en Knodge.eu:

  • Proporcionar reglas expertas: Subir _instruction_expert.md y _instruction_checklist.md a su portal.
  • Almacenar conocimiento: Subir documentos PDF con normas de codificación o directrices legales para que sirvan de referencia.

Lo que hay que hacer en OpenClaw:

  • Acceso a archivos: Dar a OpenClaw permisos de lectura y escritura en la carpeta del proyecto a revisar.
  • Comando de análisis: Implementar un comando que envíe el contenido de un archivo local junto con la palabra clave #experto a la API de Knodge.

El flujo de trabajo:

  1. le dices a OpenClaw "Comprueba config.py con #expert".
  2. OpenClaw envía el contenido del fichero a Knodge; Knodge aplica un análisis profundo y terminología técnica.
  3. Knodge identifica los problemas y crea una lista de comprobación paso a paso mediante #checklist si es necesario.
  4. OpenClaw revisa esta lista de comprobación, corrige el código localmente y valida los cambios mediante un comando de terminal.

Configuración técnica y lista futura

Resumen de configuración

| Componente Knodge.eu (memoria) OpenClaw (ejecución)
| --- | --- | --- |
| Autenticación** Cabecera X-API-Key Almacenar API-Key de forma segura en .env.
| Control lógico | Archivos con el prefijo _instruction_ | Reconocimiento de palabras clave (por ejemplo #summary) | |
Guardado | Herramienta save_user_data (archivos Markdown) | Llamada a la herramienta a través del puente API |
| Idiomas | Soporte nativo DeepL | Entrada de comandos posible en 6 idiomas |

Lista futura (características previstas)

** Integración nativa de plugins:** Un plugin oficial de OpenClaw que integra portales Knodge como almacenamiento nativo de archivos (bóveda en la nube).
**Actualización automática de los ficheros #instruction en Knodge basada en el éxito de las acciones locales de OpenClaw.
*Memoria compartida para equipos de agentes:**Múltiples instancias de OpenClaw acceden a un perfil de usuario compartido a través de Knodge para resolver tareas coordinadas.
Registro de auditoría automatizado: OpenClaw guarda cada comando shell ejecutado como un documento verificado en el portal Knodge para seguridad de la auditoría.