Files

Dominic Damoah bf6df6d6b7 feat: add Mattermost channel support

Add Mattermost as a supported messaging channel with bot API and WebSocket integration. Includes channel state tracking (tint, summary, details), multi-account support, and delivery target routing. Update documentation and tests to include Mattermost alongside existing channels.

2026-01-21 18:40:56 -05:00

2.3 KiB

Raw Blame History

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/Mattermost/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 resolve --channel slack "#general" "@jane"
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).

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.

Resolve names to IDs

Resolve channel/user names to IDs using the provider directory:

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