Cómo usar KwaFlux desde Hermes Agent y OpenClaw (configuración de MCP)

Lo esencial

• Hermes Agent añade KwaFlux con un solo comando hermes mcp add o con una entrada kwaflux bajo la clave de primer nivel mcp_servers de ~/.hermes/config.yaml.
• OpenClaw añade KwaFlux con openclaw mcp set, que lo escribe bajo mcp.servers en la configuración de OpenClaw.
• Los dos agentes arrancan el servidor de KwaFlux como un programa local, así que el agente tiene que ejecutarse en el mismo ordenador que KwaFlux, no en un servidor remoto.
• Antes de la primera petición real, usa la comprobación propia de cada agente: hermes mcp test u openclaw mcp show.

Hermes Agent y OpenClaw son agentes de IA personales que pueden usar herramientas MCP, y los dos pueden manejar KwaFlux a través del servidor MCP local que se instala con la app. Los Ajustes de KwaFlux generan la configuración y el comando de instalación para cada uno. La regla que más importa: el agente tiene que ejecutarse en el ordenador donde se ejecuta KwaFlux.

En esta guía verá cómo añadir KwaFlux a Hermes y a OpenClaw, cómo comprobar la conexión, dónde suele fallar la gente y qué pedir primero.

Contenido

1. Por qué el agente debe estar en el mismo ordenador
2. Antes de empezar
3. Hermes Agent: añadir KwaFlux
4. Hermes Agent: comprobar y limitar las herramientas
5. OpenClaw: añadir KwaFlux
6. OpenClaw: comprobar la entrada
7. Tus primeras peticiones
8. Resolución de problemas
9. Preguntas frecuentes

Por qué el agente debe estar en el mismo ordenador

El servidor MCP de KwaFlux es un servidor stdio: el agente lo arranca como proceso hijo y se comunica con él por la entrada y la salida estándar. Ese proceso se conecta a su vez a la app de KwaFlux por un canal que solo funciona dentro del mismo ordenador.

Mucha gente ejecuta OpenClaw o Hermes en un servidor que permanece encendido, como un VPS o un servidor doméstico, y chatea con él desde el móvil. Con esa configuración no se llega a KwaFlux en tu PC. Para usar KwaFlux, ejecuta el agente, o al menos la parte que arranca los servidores MCP, en el PC o el Mac donde KwaFlux está instalado y abierto.

Antes de empezar

• KwaFlux 1.0.14 o posterior, abierto.
• Node.js 18 o superior, en el PATH. Compruébalo con node --version. La tarjeta de Ajustes de KwaFlux también busca Node.js y escribe su ruta completa en la configuración, como en los ejemplos de abajo; si no lo encuentra, lo indica y escribe node en su lugar.
• En KwaFlux: Ajustes › Agent (MCP) y, en Host MCP, elige Hermes u OpenClaw.

Hermes Agent: añadir KwaFlux

Desde la línea de comandos. Haz clic en Copiar comando de instalación y ejecútalo. Para una instalación predeterminada en Windows:

hermes mcp add kwaflux --command "C:\Program Files\nodejs\node.exe" --args "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Hermes se conecta al servidor y muestra un selector con sus herramientas; quédate con las que quieras.

Editando la configuración. Haz clic en Copiar config y añádela a ~/.hermes/config.yaml:

mcp_servers:
  kwaflux:
    command: 'C:\Program Files\nodejs\node.exe'
    args:
      - 'C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs'

Si el archivo ya tiene una clave mcp_servers:, añade debajo solo el bloque kwaflux:. No lo anides como mcp: › servers:; Hermes lee la clave de primer nivel mcp_servers. Después, ejecuta /reload-mcp en una sesión.

Hermes Agent: comprobar y limitar las herramientas

• hermes mcp test kwaflux muestra lo que ha respondido de verdad el servidor.
• En el chat, Hermes llama a las herramientas de KwaFlux mcp_kwaflux_<tool>, por ejemplo mcp_kwaflux_kwaflux_get_app_status.
• Para cargar solo algunas herramientas, añade bajo el servidor un bloque tools: con include: o exclude:. Hermes registra solo las herramientas incluidas, y si se definen los dos, manda include.
• Hermes tiene un campo timeout para las llamadas a herramientas. La herramienta de espera de KwaFlux puede esperar hasta 300 segundos en una sola llamada, así que, si las esperas largas se cortan, pon un valor superior.

OpenClaw: añadir KwaFlux

Desde la línea de comandos. Haz clic en Copiar comando de instalación. En Windows, KwaFlux te da este formato:

openclaw mcp set kwaflux "{\"command\":\"C:\\Program Files\\nodejs\\node.exe\",\"args\":[\"C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs\"]}"

Las comillas escapadas están pensadas para el Símbolo del sistema (Command Prompt). Si tu shell las estropea, como puede pasar en PowerShell, edita el archivo de configuración. En Mac, KwaFlux pone el JSON entre comillas simples.

Editando la configuración. Haz clic en Copiar config y combínala en ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "kwaflux": {
        "command": "C:\\Program Files\\nodejs\\node.exe",
        "args": [
          "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
        ]
      }
    }
  }
}

Mantén las barras invertidas dobles; JSON las necesita. Algunas guías de terceros ponen los servidores bajo mcpServers; la documentación de la propia CLI de OpenClaw usa mcp.servers.

OpenClaw: comprobar la entrada

• openclaw mcp list y openclaw mcp show kwaflux muestran lo que está guardado.
• La documentación de OpenClaw advierte que set y show solo leen y escriben la configuración; «no se conectan realmente al servidor MCP». Es decir, que la entrada esté guardada no demuestra que el servidor arranque. Para asegurarte, pide al agente que llame a una herramienta de KwaFlux.
• Si el agente no ve las herramientas nuevas, recarga los servidores MCP de OpenClaw o reinicia su gateway.

Tus primeras peticiones

Empieza por esta:

Usa las herramientas de KwaFlux para comprobar si KwaFlux se está ejecutando y muéstrame mis tareas recientes.

Después:

Los agentes personales se manejan bien encadenando pasos. Algo como «Cada noche, convierte para YouTube los clips nuevos de esta carpeta» puede funcionar, con tal de que el agente se ejecute en el mismo PC y KwaFlux esté abierto a esa hora.

La interpolación de fotogramas y las herramientas de recorte y sustitución se quedan en la app; el asistente tiene instrucciones de remitirte allí para esas funciones. Las descargas por parte de agentes siguen desactivadas salvo que, en Autorización de agentes, pongas Permitir que los agentes inicien descargas en Preguntar cada vez. Entonces KwaFlux muestra una ventana emergente para cada descarga, y el asistente también te pide que confirmes en el chat que tienes derecho a descargar ese contenido.

Resolución de problemas

Para los problemas comunes a todos los hosts, consulta la guía de resolución de problemas de KwaFlux MCP.

Conclusión

En Hermes, ejecuta la línea hermes mcp add o añade un bloque kwaflux bajo mcp_servers y, después, /reload-mcp. En OpenClaw, ejecuta openclaw mcp set en el Símbolo del sistema o edita mcp.servers en openclaw.json. En los dos casos, mantén el agente y KwaFlux en el mismo ordenador y empieza por una comprobación del estado.

Maneja KwaFlux desde tu agente personal

KwaFlux incluye un servidor MCP local para Hermes Agent, OpenClaw y otras apps MCP. El procesamiento de IA corre en tu propia GPU y tus archivos multimedia no se suben para procesarlos. Funciona en Windows 10 (64 bits, versión 1809 o posterior), Windows 11 y macOS 12 o posterior en Apple Silicon. Importar archivos y explorar la app no requieren cuenta. Iniciar sesión con un plan de pago solo hace falta para exportar, convertir, reparar un archivo o descargar un archivo desde un enlace.

Descargar KwaFlux · Ver planes