2026-04-21 OpenClaw Subagents & Kanal-Bindings — Troubleshooting auf headless gemietetem Cloud-Mac

Wenn Discord-Threads keine Subagents mehr erreichen oder Telegram still ist, während das Gateway auf 127.0.0.1:18789 lauscht, liegt ein Binding+Session-Problem vor — kein Modellausfall. Auf einem nur per SSH erreichbaren gemieteten Apple Silicon-Mac gibt es kein GUI zum Klicken. Dieses Runbook vom 2026-04-21 reiht openclaw doctor, Kanalproben, Session-Checks und kontrollierte Gateway-Neustarts und verweist auf Health-Probes, nginx-Ingress und Gateway-Upgrade/Rollback — getrennt vom Artikel Skills & ClawHub-Pinning.

Symptommuster

Beobachtung	Wahrscheinliche Schicht	Erster Schritt
Gateway gesund, Kanäle still	Token, Webhook oder Pairing	Kanalstatus + Pairing-Liste
Subagent-Fehler mit „sessions“	Dateisystempfad	Berechtigungen und Config prüfen
Flattern nach npm-Upgrade	Alte Global-Installation vs. Prozess	Gateway stoppen, openclaw --version vergleichen

Doctor, Status, Log-Korrelation

Start mit openclaw doctor, stdout in die Pipeline. Siehe doppelte LaunchAgents.

openclaw doctor 2>&1 | tee /tmp/openclaw-doctor-$CI_BUILD_ID.log

Kanalbindungen & Mention-Gates

openclaw.json muss Kanal-IDs auf Agent-IDs abbilden. requireMention kann still verwerfen. Öffentlicher Ingress: TLS auf nginx mit konservativen Ratenlimits.

Sessions & Subagent-Speicher

Upstream verschärft Validierung — Session-Dateien unter konfigurierter sessions-Root. Nach Upgrade: Diff gegen Release Notes; OPENCLAW_STATE_DIR per Secrets & launchd statt blindem chmod.

Gateway-Bounce ohne Stampede

1. Ingress pausieren — Upstream 503 mit Retry-After.
2. Stoppen per CLI oder dokumentiertem launchctl.
3. Starten, lokale Healthchecks, dann Welt öffnen.

Nginx, Health, Region-Failover

Nach lokalem curl nginx wieder an und Fehlerquoten beobachten. Ungesunder Regional-Mac: auf zweiten Knoten aus Preise wechseln statt Endlosschleife Neustart.

Verwandte Runbooks

Mesh: Tailscale. Container vs. nativ: Docker vs. npm. Felder: strukturiertes Logging.

FAQ

Frage	Antwort
Subagents einen Gateway-User teilen?	Lieber getrennte State-Dirs pro Umgebung.
Pairing automatisieren?	Nur innerhalb des Risikobudgets — Owner dokumentieren.
Incident-Tracking?	Gateway-Logs mit Provider-Dashboards; semver + SHA im Ticket.

Fazit: Kanalbindungen wie Firewall-Regeln — explizite IDs, Pfade, Neustarts — und Rollback-Tarballs bei globalen npm-Änderungen.