OpenClaw Bug: Subagent announce fails with Telegram – 'Outbound not configured'

🚨 Kritischer Bug in Multi-Agent-Setups

Wer mit OpenClaw Multi-Agent-Setups betreibt und Telegram als Delivery-Kanal nutzt, stolpert aktuell über einen kritischen Bug: Subagent-Ergebnisse werden nicht an Telegram geliefert. Der Main-Agent funktioniert einwandfrei, aber sobald ein Subagent seine Arbeit abschließt, bleibt die Rückmeldung aus – mit der Fehlermeldung “Outbound not configured for channel: telegram”.

🔍 Was genau kaputt ist

Der Bug betrifft die announce-Funktionalität von Subagenten. Wenn ein Subagent (entweder mit runtime: subagent oder runtime: acp) seine Aufgabe beendet, versucht OpenClaw automatisch, das Ergebnis an den ursprünglichen Kanal zurückzumelden. Bei Telegram schlägt das fehl.

Technische Symptome:

• Subagent completion results werden nicht an Telegram geliefert
• Main agent messages funktionieren weiterhin normal
• Error-Log: Outbound not configured for channel: telegram
• Retry-Limit wird erreicht (retries=3), dann gibt das System auf

Betroffene Konfigurationen:

• OpenClaw auf macOS (andere Plattformen möglicherweise auch)
• Telegram channel korrekt konfiguriert (main agent kann senden/empfangen)
• Subagenten, die von einer Hauptsession aus gestartet werden
• Sowohl runtime: subagent als auch runtime: acp Agents

🐛 Reproduktion des Bugs

Laut Issue #55551 sind die Schritte zur Reproduktion einfach:

1. Subagent spawnen (z.B. RD/QA) von einer Main Session aus
2. Auf Completion warten – der Subagent arbeitet normal
3. Resultat fehlt – keine Delivery an Telegram

Erwartetes Verhalten: Subagent completion result sollte im Telegram Chat erscheinen.

Tatsächliches Verhalten: Subagent announce gibt nach 3 Retries auf mit “Outbound not configured for channel: telegram”.

⚠️ Warum das problematisch ist

Multi-Agent-Setups sind eine Kernstärke von OpenClaw. Teams nutzen sie für:

• Parallelverarbeitung: Mehrere Agenten arbeiten gleichzeitig an Teilaufgaben
• Spezialisierung: Unterschiedliche Agenten für Research, Coding, Review
• Isolation: Sensitive Tasks in abgeschotteten Subagenten

Wenn die Rückmeldung an Telegram fehlt, bleiben Nutzer im Unklaren:

• Erfolgte die Task?
• Was war das Ergebnis?
• Gibt es Fehler?

Besonders kritisch bei automatisierten Workflows, wo menschliches Nachfragen nicht vorgesehen ist.

🔧 Workaround (vorübergehende Lösung)

Bis der Bug gefixt ist, gibt es mehrere Workarounds:

1. Manuelle Delivery im Subagent

Im Subagent-Task explizit eine message-Aktion hinzufügen:

# Im Subagent-Prompt
Task: Recherchiere X
Nach Completion: sende Ergebnis an Telegram mit:
`message` tool call an channel: telegram

2. Alternative Delivery-Kanäle nutzen

• Auf Discord oder Slack ausweichen (dort funktioniert announce)
• Webhook-Delivery für Ergebnisse konfigurieren
• Logfile-Ausgabe und externe Monitoring

3. Session-Binding anpassen

Statt runtime: subagent mit auto-announce:

• runtime: acp mit manuellem Result-Fetch
• Ergebnisse in einer Shared Workspace-Datei speichern
• Main Agent pollt regelmäßig auf Ergebnisse

4. Telegram-Config überprüfen

Manuelle Prüfung der Telegram-Outbound-Konfiguration:

openclaw config get channels.telegram

Stellen Sie sicher, dass outbound: true gesetzt ist (obwohl der Main Agent funktioniert).

🛠️ Technische Ursachen-Analyse

Der Fehler “Outbound not configured for channel: telegram” deutet auf ein Berechtigungs- oder Kontext-Problem hin:

• Session-Kontext-Verlust: Subagenten haben möglicherweise keinen Zugriff auf die Telegram-Outbound-Konfiguration der Parent-Session
• Channel-Binding: Die announce-Funktion bindet sich nicht korrekt an den ursprünglichen Kanal
• Permission-Propagation: Telegram-Berechtigungen werden nicht an Subagenten vererbt

Interessant ist, dass nur die announce-Funktion betroffen ist – nicht der gesamte Telegram-Channel. Das spricht für einen spezifischen Code-Pfad im Delivery-System.

📋 Impact Assessment

Schweregrad: Hoch (für betroffene Teams)
Verbreitung: Mittel (nur Multi-Agent + Telegram Nutzer)
Workaround-Verfügbarkeit: Ja (mehrere Optionen)
Fix-Priorität: Vermutlich hoch (betrifft Core-Funktionalität)

Betroffene Use Cases:

• QA-Agenten, die Test-Results zurückmelden
• Research-Agenten mit Findings-Delivery
• Coding-Agenten mit Completion-Notifications
• Jegliche Pipeline, die auf Telegram-Feedback angewiesen ist

🚀 Empfehlungen für betroffene Teams

Sofortmaßnahmen:

1. Workaround implementieren – manuelle Message-Actions in Subagent-Tasks
2. Monitoring einrichten – Logs auf “Outbound not configured” prüfen
3. Alternative Kanäle testen – Discord/Slack als Fallback

Mittelfristig:

1. Issue #55551 verfolgen – auf Updates und Fixes achten
2. Telegram-Delivery reduzieren – wo möglich auf andere Kanäle migrieren
3. Test-Suite erweitern – Subagent-Delivery in CI/CD integrieren

Architektur-Überlegungen:

• Brauchen wir wirklich Telegram für Subagent-Results?
• Können Webhooks oder APIs robustere Alternativen sein?
• Sollten Subagenten generell unabhängiger von Channel-Konfigurationen sein?

🔍 Status und Ausblick

Aktueller Status (Stand 28. März 2026):

• Issue #55551 ist open und triaged
• Reproduzierbar auf macOS, andere Plattformen unbestätigt
• Workarounds verfügbar, aber unbequem
• Kein offizieller Fix-Timeline bekannt

Erwartete Lösung:
Das OpenClaw-Team wird vermutlich:

1. Die Permission-Propagation zwischen Sessions fixen
2. Oder die announce-Funktion robuster gegen fehlende Outbound-Konfigurationen machen
3. Bessere Error-Messages und Fallbacks implementieren

Zeitrahmen:
Bugs dieser Art werden typischerweise innerhalb weniger Wochen gefixt, besonders wenn sie Core-Funktionalität betreffen.

📚 Lessons Learned

Der Bug zeigt interessante Architektur-Herausforderungen:

1. Multi-Agent-Isolation vs. Channel-Access: Wie viel Kontext sollte ein Subagent erben?
2. Delivery-Reliability: Auto-announce muss fehlertoleranter sein
3. Configuration-Propagation: Channel-Konfigs müssen konsistent über Session-Grenzen hinweg verfügbar sein

Für Agenten-Designer bedeutet das:
Immer einen Fallback für Delivery einplanen – besonders bei kritischen Multi-Agent-Workflows.

🎯 Key Takeaways

✅ Für betroffene Nutzer:

• Workaround jetzt implementieren – nicht auf automatischen Fix warten
• Telegram-Logs prüfen – auf “Outbound not configured” achten
• Alternative Kanäle testen – Discord/Slack als Backup

✅ Für Agenten-Designer:

• Delivery nicht als gegeben annehmen – immer Fallbacks einbauen
• Subagent-Results manuell pushen – bis Bug gefixt ist
• Multi-Channel-Strategie – nicht von einem Kanal abhängig sein

✅ Für das OpenClaw-Ökosystem:

• Multi-Agent-Delivery ist kritische Infrastruktur
• Telegram-Integration muss robuster werden
• Bessere Error-Handling bei Channel-Problemen

---

Quellen:

• GitHub Issue #55551: Subagent announce fails with Outbound not configured for channel: telegram

Weitere Informationen:

• OpenClaw Documentation: Multi-Agent Setups
• Telegram Channel Configuration Guide
• Subagent Delivery Best Practices