Channels
CLI reference for openclaw channels (accounts, status, login/logout, logs).
Manage chat channel accounts on the gateway and their runtime state.
Related docs:
- Channels guide: ''Channels''
- Gateway configuration: ''Configuration''
Common commands
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
Add/remove accounts
openclaw channels add --channel telegram --token <bot-token> openclaw channels remove --channel telegram --delete
Tip: ''openclaw channels add --help'' shows flags for each channel (token, app token, signal-cli path, etc.).
Login/logout (interactive)
openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp
Troubleshooting
- Run ''openclaw status --deep'' for extensive probing.
- Use ''openclaw doctor'' for guided fixes.
- ''openclaw channels list'' prints ''Claude: HTTP 403 ... user:profile'' β Using snapshots requires ''user:profile'' scope. Use ''--no-usage'', or provide claude.ai session key (''CLAUDE_WEB_SESSION_KEY'' / ''CLAUDE_WEB_COOKIE''), or re-authenticate via Claude Code CLI.
Capabilities probing
Get provider capability hints (available intents/scopes) and static capability support:
openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123
Notes:
- ''--channel'' is optional; omitting it lists each channel (including extensions).
- ''--target'' accepts ''channel:<id>'' or raw numeric channel ID, Discord-only.
- Probing is provider-specific: Discord intents + optional channel permissions; Slack bot + user scopes; Telegram bot flags + webhook; Signal daemon version; MS Teams app token + Graph roles/scopes (annotated when known). Channels without probes report ''Probe: unavailable''.
Resolve names to IDs
Use provider directory to resolve channel/usernames to IDs:
openclaw channels resolve --channel slack "#general" "@jane" openclaw channels resolve --channel discord "My Server/#support" "@someone" openclaw channels resolve --channel matrix "Project Room"
Notes:
- Use ''--kind user|group|auto'' to force target type. Resolution prefers active matches when multiple entries share the same name.