clawdbot/docs/cli/channels.md

summary, read_when

summary	read_when
CLI reference for `clawdbot channels` (accounts, status, login/logout, logs)	You want to add/remove channel accounts (WhatsApp/Telegram/Discord/Slack/Signal/iMessage) You want to check channel status or tail channel logs

clawdbot channels

Manage chat channel accounts and their runtime status on the Gateway.

Related docs:

• Channel guides: Channels
• Gateway configuration: Configuration

Common commands

clawdbot channels list
clawdbot channels status
clawdbot channels capabilities
clawdbot channels capabilities --channel discord --target channel:123
clawdbot channels logs --channel all

Add / remove accounts

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

Tip: clawdbot channels add --help shows per-channel flags (token, app token, signal-cli paths, etc).

Login / logout (interactive)

clawdbot channels login --channel whatsapp
clawdbot channels logout --channel whatsapp

Troubleshooting

• Run clawdbot status --deep for a broad probe.
• Use clawdbot doctor for guided fixes.

Capabilities probe

Fetch provider capability hints (intents/scopes where available) plus static feature support:

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

Notes:

• --channel is optional; omit it to list every channel (including extensions).
• --target accepts channel:<id> or a raw numeric channel id and only applies to Discord.
• Probes are 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 where known). Channels without probes report Probe: unavailable.