2026 OpenClaw kanalseitiges Troubleshooting: Gruppen-@mention, Pairing-Freigaben & Slack/Discord-Bot-Checkliste (verbunden, keine Antwort)

1. Drei Schmerzklassen

Logs sagen „verarbeitet“, Nutzer sehen nichts—meist Kanalrichtlinie. Trennen Sie Plattform-zu-Bot und Gateway-zu-Modell.

1. @mention/requireMention: Ohne @Bot verwirft die Policy; DMs nicht. Testkanäle, Allowlists, Doku. Unterschiedliche Kanäle: pro Raum überschrieben?
2. Pairing: Ohne pairing approve kein Modellpfad. Hardening hilft, Policy vs. Auth zu trennen.
3. Slack/Discord: Fehlende chat:write, Bot nicht im Kanal, Discord ohne Message Content Intent. Webhook ≠ Socket-Scopes. Mehrere Slack-Workspaces: richtige Installation, Event-URL = Produktions-Gateway. Dashboard-„grün“ bedeutet oft nur einen erfolgreichen Health-Check, nicht dass jede Workspace-Instanz Events liefert—vergleichen Sie Zeitstempel in Slack-Delivery-Logs mit dem Gateway-access.log.

Viele Teams wechseln zuerst das Modell oder führen npm ci aus, obwohl die Policy-Schicht die Nachricht gar nicht erst an den Router übergibt. Die Frage lautet: sehen Sie im Plattform-Webhook oder im Socket-Fenster einen eingehenden Payload, wenn der Nutzer tippt? Wenn nein, ist es kein Prompt-Engineering-Problem.

Zwei Runbooks: kanalseitig nur Probe, Pairing, Mention-Flags, OAuth-Scopes, Callback-URL und Installationsumfang; session/modellseitig models status, Thinking, Heartbeat und Cron. Matrix ok, IM nicht → fast immer IM-Policies. Eine Änderung pro Wartungsfenster; notieren Sie vor/nach jeweils eine [OC-PROBE]-Nachricht.

Nach Major-Upgrades oder beim Zusammenführen von openclaw.json-Fragmenten werden Pairing-Defaults gern zurückgesetzt—tragen Sie „Pairing-Liste leeren/prüfen“ explizit in die Release-Checkliste ein, analog zu SecretRef-Migrationen in Upgrade-Artikeln.

2. Symptommatrix

Die Spalte „Zurückstellen“ soll häufige Fehlspuren bremsen: Wenn Port 18789 wirklich dicht wäre, fielen meist auch DMs aus—bei isolierten Gruppenproblemen Firewall-Regeln nicht zuerst anfassen. Temperature und Top-p verändern nur die Generierung, nicht die Event-Zustellung von Discord; dort lohnt sich Arbeit an Intents und Kanal-ACLs.

3. Sechs Schritte

Reihenfolge von außen nach innen; pro Schritt genau eine Hypothese testen, sonst ist ein Postmortem nicht reproduzierbar.

1. Probe: openclaw channels status --probe—Latenz und OK/Fail je Kanal notieren. Intermittierend: Reverse-Proxy-Timeouts, TLS-Ketten, oder Health-Checks nur auf / statt auf dem tatsächlichen Webhook-Pfad.
2. Pairing: openclaw pairing list --channel slack|discord|…; Masseneinladungen erzeugen oft über Nacht vollständige Pending-Queues.
3. Mention: requireMention in Sandbox deaktivieren oder Allowlist; mit und ohne @ vergleichen. Tests mit normalem Nutzerkonto, nicht nur Admin—Admins stehen manchmal auf Ausnahmelisten.
4. Doctor: openclaw doctor; bei Docker dieselbe Datei im Container und auf dem Host checksum-vergleichen.
5. Logs: openclaw logs --follow parallel zur [OC-PROBE]-Nachricht; nach Strings wie policy, mention, pairing filtern.
6. Persistenz: Unter launchd müssen WorkingDirectory und die gelesene openclaw.json mit Ihrer SSH-Session übereinstimmen—sonst „manuell ok, Daemon alt“, wie bei PATH/ENV unter launchd.

4. Parameter und Betriebsgrößen

① Discord: Message Content Intent ist in Produktion fast immer Pflicht, wenn der Bot Nachrichteninhalte aus öffentlichen Kanälen lesen soll; Server Members Intent nur bei Bedarf (Mitgliederverwaltung), sonst unnötige Angriffsfläche. ② Slack: Scopes strikt an Event-API vs. Socket Mode anpassen; ohne Einladung des Bots in den Kanal fehlen message.channels-Events komplett.

③ HTTPS und Pfade: Öffentliche Callback-URL, interner Upstream und basePath müssen zusammenpassen—ein häufiger Fehler ist ein TLS-Terminator, der X-Forwarded-Prefix verwirft. ④ Cache: Nach OAuth-Reauth oder Intent-Änderung 2–5 Minuten Wartezeit einplanen, bevor Sie „immer noch kaputt“ eskalieren. ⑤ Dokumentation: Nutzerhinweis „In öffentlichen Kanälen @Bot“ reduziert Tickets stärker als ständiges Umschalten von Flags.

⑥ Audit: Massen-pairing approve mit Ticket-ID und Operator wie Token-Rotation in Hardening protokollieren. Als grobe Betriebsgröße: wenn die mittlere Zeit von Nutzer-Nachricht bis erstem Logeintrag am Gateway unter normaler Last >2–3 s bleibt, liegt das Problem selten an der LLM-Latenz—messen Sie zuerst Kanal-Queue und Policy.

5. Stabile Mac-Cloud

Ständiges Rotieren von Bot-Tokens verschleiert Mention- und Pairing-Probleme und macht Audits unmöglich. Die Reihenfolge Probe → Pairing → Doctor → Logs in einem Runbook zu fixieren, ist wartbarer als „neues Secret, neues Glück“.

Laptops und Heim-DSL mit Schlafmodus sind schlechte Referenz für 24/7-IM: Verbindungen brechen weich ab, Firewalls blockieren eingehende Prüfungen, und Sie interpretieren OpenClaw-Fehler als „flaky“. Ein dauerhaft eingeschalteter Serverknoten spiegelt Slack/Discord-Reconnects ehrlicher.

Reine Windows- oder Linux-VPS ohne macOS-Toolchain erhöhen den Aufwand für Apple-nahe Pipelines; VPSMAC M4 Mac-Cloud bündelt Gateway, launchd-Jobs und Logs auf einem Ökosystem. Schnellstart bleibt 5-Minuten-Guide, danach diese IM-Checkliste.

6. FAQ

Nur Gruppen?

Zuerst requireMention und Raumrichtlinien; dann identische Kurznachricht mit und ohne @Bot. Wenn nur mit @ funktioniert, Regel in der Nutzerdoku festhalten oder interne Kanäle explizit von der Mention-Pflicht ausnehmen.

Leeres Pairing?

Zurück zu channels status --probe, Bot-Scopes und logs auf policy. Prüfen, ob ein Staging-Workspace-Token in Produktion liegt, während Nutzer im Prod-Workspace schreiben.

Heartbeat?

Heartbeat und Thinking betreffen eher Cron und leere Modellausgaben; wenn nur Gruppen betroffen sind und starke Korrelation mit @ besteht, bleiben Sie kanalseitig. Bei totalem Ausfall aller Kanäle parallel Heartbeat-Artikel öffnen.

Discord intents an, Guild stumm?

View Channel, Read Message History, passende Rollen in privaten Kanälen; nach Speichern im Entwicklerportal mehrere Minuten warten.

Slack online, kein Trigger?

Request-URL der Events, vollständige Re-Autorisierung, Installation je Workspace; Slack „Event Delivery“ mit Gateway-Zugriffslogs auf die Sekunde abgleichen.