2026 OpenClaw MeshMac Mehrknoten-Praxis: Lastverteilung & Failover – reproduzierbare Konfigurationsschritte

① MeshMac Mehrknoten und OpenClaw-Deployment-Architektur (Kurzüberblick)

Bei OpenClaw auf mehreren MeshMac-Knoten steht typischerweise ein State-Server (oder Koordinator) im Zentrum; alle Mac-Knoten agieren als Agenten und verbinden sich per gRPC mit diesem Server. Die Task-Queue und der Ausführungszustand liegen zentral; Lastverteilung entsteht dadurch, dass freie Knoten Tasks aus der Queue holen. Fällt ein Knoten aus, können andere dieselbe Queue weiter nutzen – so funktioniert der Failover.

1. Für den State-Server einen Knoten festlegen und im internen Netz für alle anderen erreichbar machen.
2. Auf jedem Mac-Knoten den OpenClaw-Agenten in derselben Version installieren.
3. Alle Agenten so konfigurieren, dass sie die State-Server-Adresse und den Port für die gRPC-Verbindung verwenden.

② Installation und einheitliche Konfiguration von OpenClaw auf Mehrknoten

Reproduzierbarkeit erreichen Sie, indem Sie auf allen Knoten dieselbe OS- und Xcode-Version sowie dieselbe OpenClaw-Version verwenden. Eine zentrale Konfigurationsdatei (z. B. YAML-Profil) erstellen und auf alle Knoten identisch verteilen.

• Pro Knoten OpenClaw per curl -sSL ... | sh oder mit Docker (gleicher Tag) installieren.
• Mit openclaw onboard bzw. openclaw doctor die Funktionsfähigkeit jedes Knotens prüfen.
• State-Server-Ziel (Host und Port) in der YAML-Konfiguration auf allen Knoten gleich setzen; Profil per scp, Ansible o. Ä. zentral verteilen.

③ Lastverteilung und Task-Verteilung – reproduzierbare Konfiguration

Lastverteilung basiert auf Task-Queue plus mehreren Agenten: Freie Knoten holen sich Tasks aus der Queue; so verteilt sich die Last automatisch. Konfiguration in reproduzierbaren Schritten:

1. State-Server starten und prüfen, dass alle Agenten per gRPC verbunden sind.
2. Task-Queue (Name, Priorität) in YAML oder per API definieren und auf allen Knoten dieselbe Konfiguration verwenden.
3. Tasks nur in die Queue legen; welcher Knoten einen Task übernimmt, entscheidet sich durch „nächster verfügbarer Knoten holt aus der Queue“.
4. Optional: pro Knoten Gewichtung oder Labels setzen, z. B. „bestimmte Queue nur für bestimmte Knotengruppe“.

Details zu Retry-Strategien: Task-Queue und Wiederholungsschritte.

④ Single-Point-Failover und Health-Check – Konfigurationsschritte

Damit bei Ausfall eines Knotens andere Knoten die Tasks übernehmen, müssen Health-Check und Timeout konfiguriert werden: Der State-Server stuft nicht reagierende Knoten als ausgefallen ein und kann Tasks aus der Queue für andere Knoten freigeben.

1. Health-Check-Intervall der Agenten (z. B. 30 Sekunden) und Timeout des State-Servers für „keine Antwort“ (z. B. 90 Sekunden) in der YAML-Konfiguration setzen.
2. Zum Testen einen Agenten gezielt stoppen und prüfen, dass die zugewiesenen Tasks von anderen Knoten aus der Queue übernommen und ausgeführt werden.
3. Für höhere Verfügbarkeit des State-Servers: redundante State-Server-Architektur (separate Dokumentation) erwägen.

⑤ Häufige Fehler und Fehlersuche

• „Connection refused“ zum State-Server: State-Server-Dienst läuft? Firewall erlaubt gRPC-Port? Bei SSH-Tunneln: Bindung (localhost vs. 0.0.0.0) und Tunnel-Befehl prüfen.
• Tasks werden nicht verteilt / Timeout: Gleiche OpenClaw-Version auf allen Knoten? Logs von State-Server und Agenten auf Timeouts und Verbindungsfehler prüfen. Geordneter Neustart: zuerst State-Server, dann Agenten.
• Zustand nicht synchron / veraltete Queue: NTP auf allen Macs; große Zeitabweichungen können Queue-Logik stören. Nach Änderungen an der Konfiguration alle Dienste in definierter Reihenfolge neu starten.
• Failover greift nicht: Health-Check-Intervall und Timeout prüfen; sicherstellen, dass der State-Server ausgefallene Knoten aus dem Pool entfernt und Tasks neu zuweist.

Kurz zusammengefasst

• Architektur: ein State-Server, mehrere Agent-Knoten per gRPC; Task-Queue zentral, Lastverteilung durch „Knoten holt aus Queue“; Failover durch Übernahme aus derselben Queue.
• Installation: gleiche OS-/Xcode-/OpenClaw-Version, ein YAML-Profil für alle Knoten, State-Server-Adresse einheitlich, Verteilung per scp/Ansible.
• Lastverteilung: Queue + mehrere Agenten konfigurieren; Tasks nur in Queue legen; optional Gewichtung/Labels pro Knoten.
• Failover: Health-Check-Intervall und Timeout setzen; bei Ausfall eines Knotens übernehmen andere die Tasks aus der Queue. State-Server bei Bedarf redundanzfähig planen.