OpenClawSkills
GitHub
CLI Reference β€’ TutorialHeader.readTime

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''

Tutorial.step

Common commands

Bash
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
Tutorial.step

Add/remove accounts

Bash
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.).

Tutorial.step

Login/logout (interactive)

Bash
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp
Tutorial.step

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.

Tutorial.step

Capabilities probing

Get provider capability hints (available intents/scopes) and static capability support:

Bash
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''.

Tutorial.step

Resolve names to IDs

Use provider directory to resolve channel/usernames to IDs:

Bash
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.