KwaFlux mit Hermes Agent und OpenClaw nutzen (MCP-Einrichtung)

Das Wichtigste in Kürze

• Hermes Agent bindet KwaFlux mit einem einzigen hermes mcp add-Befehl ein oder über einen Eintrag kwaflux unter dem Schlüssel mcp_servers auf oberster Ebene der ~/.hermes/config.yaml.
• OpenClaw bindet KwaFlux mit openclaw mcp set ein; der Befehl schreibt den Eintrag unter mcp.servers in die Konfiguration von OpenClaw.
• Beide Agenten starten den Server von KwaFlux als lokales Programm. Der Agent muss deshalb auf demselben Computer laufen wie KwaFlux, nicht auf einem entfernten Server.
• Nutzen Sie vor der ersten echten Anfrage die Prüfung des jeweiligen Agenten, hermes mcp test oder openclaw mcp show.

Hermes Agent und OpenClaw sind persönliche KI-Agenten, die MCP-Tools nutzen können, und beide können KwaFlux über den lokalen MCP-Server steuern, der mit der App installiert wird. Die Einstellungen von KwaFlux erzeugen für beide die Konfiguration und den Installationsbefehl. Die wichtigste Regel: Der Agent muss auf dem Computer laufen, auf dem auch KwaFlux läuft.

In diesem Leitfaden erfahren Sie, wie Sie KwaFlux zu Hermes und zu OpenClaw hinzufügen, wie Sie die Verbindung prüfen, wo es meistens hakt und worum Sie zuerst bitten.

Inhalt

1. Warum der Agent auf demselben Computer laufen muss
2. Bevor Sie beginnen
3. Hermes Agent: KwaFlux hinzufügen
4. Hermes Agent: Tools prüfen und eingrenzen
5. OpenClaw: KwaFlux hinzufügen
6. OpenClaw: den Eintrag prüfen
7. Ihre ersten Anfragen
8. Fehlerbehebung
9. Häufige Fragen

Warum der Agent auf demselben Computer laufen muss

Der MCP-Server von KwaFlux ist ein stdio-Server: Der Agent startet ihn als Kindprozess und spricht mit ihm über Standardeingabe und Standardausgabe. Dieser Prozess verbindet sich dann mit der KwaFlux-App über einen Kanal, der nur auf demselben Computer funktioniert.

Viele betreiben OpenClaw oder Hermes auf einem Server, der durchgehend läuft, etwa einem VPS oder einem Heimserver, und chatten vom Handy aus damit. So ein Aufbau erreicht KwaFlux auf Ihrem PC nicht. Um KwaFlux zu nutzen, lassen Sie den Agenten, oder zumindest den Teil, der die MCP-Server startet, auf dem PC oder Mac laufen, auf dem KwaFlux installiert und geöffnet ist.

Bevor Sie beginnen

• KwaFlux 1.0.14 oder neuer, geöffnet.
• Node.js 18 oder neuer, im PATH. Prüfen Sie das mit node --version. Die Karte in den KwaFlux-Einstellungen sucht ebenfalls nach Node.js und schreibt den vollen Pfad in die Konfiguration, wie in den Beispielen unten; findet sie Node.js nicht, sagt sie das und schreibt stattdessen node.
• In KwaFlux: Öffnen Sie Einstellungen › Agent (MCP) und wählen Sie unter MCP-Host den Eintrag Hermes oder OpenClaw.

Hermes Agent: KwaFlux hinzufügen

Per Befehlszeile. Klicken Sie auf Installationsbefehl kopieren und führen Sie den Befehl aus. Bei einer Windows-Standardinstallation:

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

Hermes verbindet sich mit dem Server und zeigt eine Auswahl seiner Tools an; behalten Sie die, die Sie brauchen.

Per Konfigurationsdatei. Klicken Sie auf Konfig kopieren und fügen Sie das Ergebnis in die ~/.hermes/config.yaml ein:

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

Enthält die Datei schon einen Schlüssel mcp_servers:, fügen Sie darunter nur den Block kwaflux: ein. Verschachteln Sie ihn nicht als mcp: › servers:; Hermes liest den Schlüssel mcp_servers auf oberster Ebene. Führen Sie danach in einer Sitzung /reload-mcp aus.

Hermes Agent: Tools prüfen und eingrenzen

• hermes mcp test kwaflux zeigt, was der Server tatsächlich geantwortet hat.
• Im Chat nennt Hermes die Tools von KwaFlux mcp_kwaflux_<tool>, zum Beispiel mcp_kwaflux_kwaflux_get_app_status.
• Um nur einen Teil der Tools zu laden, ergänzen Sie unter dem Server einen Block tools: mit include: oder exclude:. Hermes registriert dann nur die eingeschlossenen Tools, und sind beide gesetzt, hat include Vorrang.
• Hermes hat ein Feld timeout für Tool-Aufrufe. Das Warte-Tool von KwaFlux kann in einem Aufruf bis zu 300 Sekunden warten; werden lange Wartevorgänge abgeschnitten, setzen Sie den Wert also auf mehr als 300 Sekunden.

OpenClaw: KwaFlux hinzufügen

Per Befehlszeile. Klicken Sie auf Installationsbefehl kopieren. Unter Windows formatiert KwaFlux den Befehl so:

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

Die maskierten Anführungszeichen sind für die Eingabeaufforderung geschrieben. Verstümmelt Ihre Shell sie, was in PowerShell passieren kann, bearbeiten Sie stattdessen die Konfigurationsdatei. Auf dem Mac setzt KwaFlux das JSON in einfache Anführungszeichen.

Per Konfigurationsdatei. Klicken Sie auf Konfig kopieren und übernehmen Sie das Ergebnis in die ~/.openclaw/openclaw.json:

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

Lassen Sie die doppelten Backslashes stehen; JSON braucht sie. Manche Anleitungen von Dritten legen Server stattdessen unter mcpServers ab; die CLI-Dokumentation von OpenClaw selbst verwendet mcp.servers.

OpenClaw: den Eintrag prüfen

• openclaw mcp list und openclaw mcp show kwaflux zeigen, was gespeichert ist.
• Die Dokumentation von OpenClaw weist darauf hin, dass set und show nur die Konfiguration lesen und schreiben; sie „verbinden sich nicht tatsächlich mit dem MCP-Server“. Ein gespeicherter Eintrag beweist also nicht, dass der Server startet. Bitten Sie den Agenten, ein KwaFlux-Tool aufzurufen, um sicherzugehen.
• Sieht der Agent die neuen Tools nicht, laden Sie die MCP-Server von OpenClaw neu oder starten Sie sein Gateway neu.

Ihre ersten Anfragen

Beginnen Sie mit:

Prüf mit den KwaFlux-Tools, ob KwaFlux läuft, und liste meine letzten Aufgaben auf.

Danach:

Persönliche Agenten sind gut darin, Schritte zu verketten. „Wandle jeden Abend die neuen Clips in diesem Ordner für YouTube um“ kann funktionieren, solange der Agent auf demselben PC läuft und KwaFlux zu dieser Zeit geöffnet ist.

Die Bildinterpolation sowie die Tools zum Freistellen und Ersetzen bleiben in der App; der Assistent ist angewiesen, Sie dafür dorthin zu schicken. Downloads durch Agenten bleiben aus, solange Sie unter Agent-Freigabe die Option Downloads durch Agenten zulassen nicht auf Jedes Mal fragen stellen. KwaFlux zeigt dann für jeden Download ein Popup, und der Assistent bittet Sie zusätzlich im Chat zu bestätigen, dass Sie diesen Inhalt herunterladen dürfen.

Fehlerbehebung

Bei Problemen, die bei jedem Host auftreten können, hilft die Anleitung zur Fehlerbehebung bei KwaFlux MCP.

Fazit

Führen Sie für Hermes die Zeile hermes mcp add aus oder ergänzen Sie einen Block kwaflux unter mcp_servers, dann /reload-mcp. Führen Sie für OpenClaw openclaw mcp set in der Eingabeaufforderung aus oder bearbeiten Sie mcp.servers in der openclaw.json. In beiden Fällen gehören der Agent und KwaFlux auf denselben Computer, und am Anfang steht eine Statusabfrage.

KwaFlux mit Ihrem persönlichen Agenten steuern

KwaFlux bringt einen lokalen MCP-Server für Hermes Agent, OpenClaw und andere MCP-Apps mit. Die KI-Verarbeitung läuft auf Ihrer eigenen GPU, und Ihre Mediendateien werden für die Verarbeitung nicht hochgeladen. KwaFlux läuft unter Windows 10 (64-Bit, Version 1809 oder neuer), Windows 11 und macOS 12 oder neuer auf Apple Silicon. Dateien importieren und die App erkunden geht ohne Konto. Anmeldung und ein bezahlter Plan sind nur für Export, Konvertierung, Dateireparatur und Datei-Download aus einem Link nötig.

KwaFlux laden · Pläne ansehen