Utiliser KwaFlux depuis Hermes Agent et OpenClaw (configuration MCP)

L’essentiel

• Hermes Agent ajoute KwaFlux avec une seule commande hermes mcp add, ou avec une entrée kwaflux sous la clé de premier niveau mcp_servers de ~/.hermes/config.yaml.
• OpenClaw ajoute KwaFlux avec openclaw mcp set, qui l’inscrit sous mcp.servers dans la configuration d’OpenClaw.
• Les deux agents lancent le serveur de KwaFlux comme un programme local : l’agent doit donc tourner sur le même ordinateur que KwaFlux, pas sur un serveur distant.
• Avant votre première vraie demande, utilisez la vérification propre à chaque agent : hermes mcp test ou openclaw mcp show.

Hermes Agent et OpenClaw sont des agents IA personnels capables d’utiliser des outils MCP, et tous deux peuvent piloter KwaFlux grâce au serveur MCP local installé avec l’application. Les Paramètres de KwaFlux génèrent la configuration et la commande d’installation pour chacun. La règle qui compte le plus : l’agent doit tourner sur l’ordinateur où tourne KwaFlux.

Dans ce guide, vous verrez comment ajouter KwaFlux à Hermes et à OpenClaw, comment vérifier la connexion, où l’on se trompe le plus souvent et quoi demander en premier.

Sommaire

1. Pourquoi l’agent doit être sur le même ordinateur
2. Avant de commencer
3. Hermes Agent : ajouter KwaFlux
4. Hermes Agent : vérifier et limiter les outils
5. OpenClaw : ajouter KwaFlux
6. OpenClaw : vérifier l’entrée
7. Vos premières demandes
8. Dépannage
9. Questions fréquentes

Pourquoi l’agent doit être sur le même ordinateur

Le serveur MCP de KwaFlux est un serveur stdio : l’agent le lance comme processus enfant et communique avec lui par l’entrée et la sortie standard. Ce processus se connecte ensuite à l’application KwaFlux par un canal qui ne fonctionne que sur le même ordinateur.

Beaucoup font tourner OpenClaw ou Hermes sur un serveur allumé en permanence, comme un VPS ou un serveur domestique, et discutent avec lui depuis leur téléphone. Une telle installation ne peut pas atteindre KwaFlux sur votre PC. Pour utiliser KwaFlux, faites tourner l’agent, ou au moins la partie qui lance les serveurs MCP, sur le PC ou le Mac où KwaFlux est installé et ouvert.

Avant de commencer

• KwaFlux 1.0.14 ou plus récent, ouvert.
• Node.js 18 ou plus récent, dans le PATH. Vérifiez avec node --version. La carte des Paramètres de KwaFlux cherche aussi Node.js et écrit son chemin complet dans la configuration, comme dans les exemples ci-dessous ; si elle ne le trouve pas, elle le signale et écrit node à la place.
• Dans KwaFlux : Paramètres › Agent (MCP), puis choisissez Hermes ou OpenClaw sous Hôte MCP.

Hermes Agent : ajouter KwaFlux

En ligne de commande. Cliquez sur Copier la commande d’install et lancez-la. Pour une installation Windows par défaut :

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

Hermes se connecte au serveur et affiche une liste de ses outils : gardez ceux que vous voulez.

En modifiant la configuration. Cliquez sur Copier la config et ajoutez-la à ~/.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 le fichier contient déjà une clé mcp_servers:, ajoutez seulement le bloc kwaflux: en dessous. Ne l’imbriquez pas sous mcp: › servers: : Hermes lit la clé de premier niveau mcp_servers. Lancez ensuite /reload-mcp dans une session.

Hermes Agent : vérifier et limiter les outils

• hermes mcp test kwaflux montre ce que le serveur a réellement répondu.
• Dans le chat, Hermes nomme les outils de KwaFlux mcp_kwaflux_<tool>, par exemple mcp_kwaflux_kwaflux_get_app_status.
• Pour ne charger qu’une partie des outils, ajoutez sous le serveur un bloc tools: avec include: ou exclude:. Hermes n’enregistre que les outils inclus, et include l’emporte si les deux sont définis.
• Hermes propose un champ timeout pour les appels d’outils. L’outil d’attente de KwaFlux peut patienter jusqu’à 300 secondes en un seul appel : si les longues attentes sont coupées, réglez une valeur supérieure.

OpenClaw : ajouter KwaFlux

En ligne de commande. Cliquez sur Copier la commande d’install. Sous Windows, KwaFlux la met en forme ainsi :

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

Les guillemets échappés sont prévus pour l’Invite de commandes. Si votre shell les abîme, ce que peut faire PowerShell, modifiez plutôt le fichier de configuration. Sur Mac, KwaFlux entoure le JSON de guillemets simples.

En modifiant la configuration. Cliquez sur Copier la config et fusionnez-la dans ~/.openclaw/openclaw.json :

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

Gardez les doubles barres obliques inverses : le JSON en a besoin. Certains guides tiers placent les serveurs sous mcpServers ; la documentation de la CLI d’OpenClaw utilise mcp.servers.

OpenClaw : vérifier l’entrée

• openclaw mcp list et openclaw mcp show kwaflux affichent ce qui est enregistré.
• La documentation d’OpenClaw précise que set et show ne font que lire et écrire la configuration ; elles « ne se connectent pas réellement au serveur MCP ». Une entrée enregistrée ne prouve donc pas que le serveur démarre. Pour en avoir le cœur net, demandez à l’agent d’appeler un outil KwaFlux.
• Si l’agent ne voit pas les nouveaux outils, rechargez les serveurs MCP d’OpenClaw ou redémarrez sa passerelle (gateway).

Vos premières demandes

Commencez par :

Vérifie avec les outils KwaFlux si KwaFlux est lancé et liste mes tâches récentes.

Ensuite :

Les agents personnels savent bien enchaîner les étapes. « Chaque soir, convertis pour YouTube les nouveaux clips de ce dossier » peut fonctionner, à condition que l’agent tourne sur le même PC et que KwaFlux soit ouvert à ce moment-là.

L’interpolation d’images ainsi que les outils de détourage et de remplacement restent dans l’application ; l’assistant a pour consigne de vous y renvoyer. Les téléchargements par les agents restent désactivés tant que vous n’avez pas réglé Autoriser les agents à lancer des téléchargements, sous Autorisation des agents, sur Demander à chaque fois. KwaFlux affiche alors une fenêtre pour chaque téléchargement, et l’assistant vous demande aussi de confirmer dans le chat que vous avez le droit de télécharger ce contenu.

Dépannage

Pour les problèmes communs à tous les hôtes, voyez le guide de dépannage MCP de KwaFlux.

Conclusion

Pour Hermes, lancez la commande hermes mcp add ou ajoutez un bloc kwaflux sous mcp_servers, puis /reload-mcp. Pour OpenClaw, lancez openclaw mcp set dans l’Invite de commandes ou modifiez mcp.servers dans openclaw.json. Dans les deux cas, gardez l’agent et KwaFlux sur le même ordinateur, et commencez par une vérification d’état.

Pilotez KwaFlux depuis votre agent personnel

KwaFlux intègre un serveur MCP local pour Hermes Agent, OpenClaw et d’autres applications MCP. Le traitement IA tourne sur votre propre GPU et vos fichiers média ne sont pas envoyés pour être traités. KwaFlux fonctionne sous Windows 10 (64 bits, version 1809 ou plus récente), Windows 11 et macOS 12 ou plus récent sur Apple Silicon. Importer des fichiers et explorer l’app ne demandent pas de compte. Une connexion avec un forfait payant n’est requise que pour exporter, convertir, réparer un fichier ou télécharger un fichier depuis un lien.

Télécharger KwaFlux · Voir les offres