2026 OpenClaw MeshMac in der Praxis: Rate-Limit und Session-Concurrency am geteilten Gateway — minimale reproduzierbare Schritte gegen Überlast (HowTo+FAQ)

Drei Überlast-Muster am gemeinsamen Gateway

1. Burst-Kollision: Viele parallele CI-Jobs erzeugen Webhooks — der Gateway sieht RPS-Spitzen, während CPUs noch idle wirken. Ohne Bucket oder faire Queue wirkt Traffic feindlich.
2. Session-Stau: Lange Streams und offene Skill-Antworten halten Sitzungen — RPS-Limits allein reichen nicht; dokumentieren Sie max gleichzeitiger Sessions.
3. Schlechte Logs: 429/503 ohne mesh_node_id, limit_type, retry_after erzwingen Raten. Mehrknoten nützen nur mit einheitlichen Feldern.

Matrix: Token-Bucket, Verbindungsdeckel und Session-Concurrency

Schutzmechanismen nach Lastform und Ops-Aufwand für Pools mit gemeinsamem Einlass.

Kurz: Bucket glättet Spitzen; Verbindungs- und Session-Limits schützen den Host. Ein Prozess auf Miet-Mac trägt weniger gleichzeitige Last, als CPUs vermuten lassen.

CI-, Webhook- und Gateway-Parallelität — Abhängigkeiten

Summe aus CI-Jobs, Kanal-Events und offenen Sessions muss unter Ihren dokumentierten Caps bleiben — sonst 429-Kaskaden wie flaky Builds.

Sieben Minimal-Schritte: Limit-Policy, Health und Logs

1. Baseline: Pro Knoten RPS, gleichzeitige Sessions, p95, Anteil 429/503 mindestens eine Woche messen; CI- und Release-Fenster im gleichen Dashboard markieren.
2. Edge-Limit: Im TLS-Reverse-Proxy (Nginx/Caddy-Matrix) Token-Bucket pro Pfad oder Schlüssel; Webhooks per Secret oder mTLS von anonymem Health trennen.
3. Session-Cap im Gateway: max_concurrent_sessions oder Worker-Tiefe fixieren; Verhalten bei Überlauf dokumentieren (503 + Retry-After oder Queue). Gleicher Wert auf allen Pool-Knoten.
4. CI und Broker: job concurrency und prefetch so wählen, dass Summe der Aufrufe unter Edge- und Gateway-Caps bleibt; 429 mit Backoff statt sofortigem Fail, wenn SLA passt.
5. Health: Aggregierte Probe (Health-Leitfaden) um Session-Auslastung, Queue und Anteil Drosselungen erweitern; bei anhaltender Überschreitung unhealthy — Load-Balancer verteilt auf Geschwister.
6. Logs: Bei Drosselung immer request_id, mesh_node_id, limit_type, Zähler (tokens_remaining oder concurrent_sessions), http_status, retry_after_seconds, upstream_latency_ms, plus client_key_scope.
7. Rollout: Canary auf einem Gateway, dann Config-Hash auf allen Hosts; openclaw gateway status und kurze synthetische Last vor Produktionsfreigabe.

openclaw gateway status --json
curl -sS -o /dev/null -w "%{http_code}\n" -H "Authorization: Bearer $TOKEN" https://gateway.example/health

Mehrknoten: gleiche Limits auf allen Hosts und Health-gesteuerte Umverteilung schlagen asymmetrische Sonderwerte.

Zitierfähige Schwellen für Reviews und Change-Advisory

• Edge-RPS: Anonyme Pfade oft 10–30/s pro IP oder Key; Webhooks eigene Buckets mit Auth.
• Session-Cap: Ca. 0,7–0,85 des Punktes, an dem p95 vor dem Limit knickt.
• Retry-After: 1–5 s interaktiv, 5–30 s Batch, mit Jitter.
• Health: Knoten rotieren, wenn >15 % Drosselungen über 60 s oder Session >90 % der Cap — an SLO anpassen.

FAQ: Rate-Limits, 429 und Zusammenspiel mit Kanälen

Token-Bucket oder Verbindungsgrenze?

Beides: Bucket für HTTP-Bursts, Cap für FDs/TLS; Session-Cap für lange OpenClaw-Sitzungen.

Niedrige CPU, aber 429?

Limits sind pro Key/Tenant. Key-Sharing, zu kleines burst_capacity oder ein Knoten, der die ganze Last trägt, sind typisch.

Chat-Webhooks überlasten das Gateway?

Worker-Concurrency und CI an Gateway-Caps koppeln; zweites Gateway nur für Chat möglich (Load-Balance-Runbook oben verlinkt).

Pflicht-Logfelder?

request_id, mesh_node_id, limit_type, Status, retry_after_seconds, Latenz, Scope und Zähler.