`openclaw channels`

Verwalte Chat-Channel-Accounts und ihren Laufzeitstatus auf dem Gateway.

Verwandte Docs:

Channel-Anleitungen: Channels
Gateway-Konfiguration: Configuration

H\u00e4ufige Befehle

openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all

Accounts hinzuf\u00fcgen / entfernen

openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete

Tipp: openclaw channels add --help zeigt channel-spezifische Flags (Token, App-Token, signal-cli-Pfade, etc.).

Wenn du openclaw channels add ohne Flags ausf\u00fchrst, kann der interaktive Assistent nach Folgendem fragen:

Account-IDs pro ausgew\u00e4hltem Channel
Optionale Anzeigenamen f\u00fcr diese Accounts
Konfigurierte Channel-Accounts jetzt an Agents binden?

Wenn du das Binden best\u00e4tigst, fragt der Assistent, welcher Agent jeden konfigurierten Channel-Account besitzen soll, und schreibt account-bezogene Routing-Bindings.

Du kannst dieselben Routing-Regeln auch sp\u00e4ter mit openclaw agents bindings, openclaw agents bind und openclaw agents unbind verwalten (siehe agents).

Wenn du einen nicht-Standard-Account zu einem Channel hinzuf\u00fcgst, der noch Single-Account-Top-Level-Einstellungen verwendet (noch keine channels.<channel>.accounts-Eintr\u00e4ge), verschiebt OpenClaw account-bezogene Single-Account-Top-Level-Werte in channels.<channel>.accounts.default und schreibt dann den neuen Account. Das bewahrt das urspr\u00fcngliche Account-Verhalten und wechselt dabei zur Multi-Account-Struktur.

Das Routing-Verhalten bleibt konsistent:

Bestehende Channel-only-Bindings (ohne accountId) matchen weiterhin den Standard-Account.
channels add erstellt oder schreibt Bindings im nicht-interaktiven Modus nicht automatisch um.
Der interaktive Setup kann optional account-bezogene Bindings hinzuf\u00fcgen.

Wenn deine Config bereits in einem gemischten Zustand war (benannte Accounts vorhanden, default fehlt, und Top-Level-Single-Account-Werte noch gesetzt), f\u00fchre openclaw doctor --fix aus, um account-bezogene Werte in accounts.default zu verschieben.

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

Fehlerbehebung

F\u00fchre openclaw status --deep f\u00fcr eine breite Pr\u00fcfung aus.
Verwende openclaw doctor f\u00fcr gef\u00fchrte Reparaturen.
openclaw channels list zeigt Claude: HTTP 403 ... user:profile an -> Der Usage-Snapshot ben\u00f6tigt den user:profile-Scope. Verwende --no-usage, stelle einen claude.ai-Session-Key bereit (CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE) oder authentifiziere dich erneut \u00fcber Claude Code CLI.
openclaw channels status f\u00e4llt auf Config-only-Zusammenfassungen zur\u00fcck, wenn das Gateway nicht erreichbar ist. Wenn eine unterst\u00fctzte Channel-Anmeldeinformation \u00fcber SecretRef konfiguriert ist, aber im aktuellen Befehlspfad nicht verf\u00fcgbar, wird dieser Account als konfiguriert mit eingeschr\u00e4nkten Hinweisen angezeigt, anstatt ihn als nicht konfiguriert darzustellen.

Capabilities-Pr\u00fcfung

Provider-Capability-Hints abrufen (Intents/Scopes wo verf\u00fcgbar) plus statische Feature-Unterst\u00fctzung:

openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123

Hinweise:

--channel ist optional; lass es weg, um jeden Channel aufzulisten (einschlie\u00dflich Extensions).
--target akzeptiert channel:<id> oder eine rohe numerische Channel-ID und gilt nur f\u00fcr Discord.
Pr\u00fcfungen sind provider-spezifisch: Discord-Intents + optionale Channel-Berechtigungen; Slack-Bot + User-Scopes; Telegram-Bot-Flags + Webhook; Signal-Daemon-Version; MS Teams-App-Token + Graph-Rollen/Scopes (annotiert wo bekannt). Channels ohne Pr\u00fcfungen melden Probe: unavailable.

Namen zu IDs aufl\u00f6sen

Channel-/Usernamen \u00fcber das Provider-Verzeichnis in IDs aufl\u00f6sen:

openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"