Skip to main content

​
clawdia channels

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

​
Common commands

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

​
Add / remove accounts

clawdia channels add --channel telegram --token <bot-token>
clawdia channels remove --channel telegram --delete
Tip: clawdia channels add --help shows per-channel flags (token, app token, signal-cli paths, etc).

​
Login / logout (interactive)

clawdia channels login --channel whatsapp
clawdia channels logout --channel whatsapp

​
Troubleshooting

  • Run clawdia status --deep for a broad probe.
  • Use clawdia doctor for guided fixes.
  • clawdia channels list prints Claude: HTTP 403 ... user:profile → usage snapshot needs the user:profile scope. Use --no-usage, or provide a claude.ai session key (CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE), or re-auth via Claude Code CLI.

​
Capabilities probe

Fetch provider capability hints (intents/scopes where available) plus static feature support: 
clawdia channels capabilities
clawdia 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.

​
Resolve names to IDs

Resolve channel/user names to IDs using the provider directory: 
clawdia channels resolve --channel slack "#general" "@jane"
clawdia channels resolve --channel discord "My Server/#support" "@someone"
clawdia channels resolve --channel matrix "Project Room"
Notes:
  • Use --kind user|group|auto to force the target type.
  • Resolution prefers active matches when multiple entries share the same name.