← Back to Channels and integrations
OpenClaw channels

Cross-channel setup patterns

This page is the reusable setup database behind Discord, Telegram, Slack, WhatsApp, and Matrix. The brand names change; the operator pattern mostly does not.

Core ideaMost channel setup is the same problem in different clothes: credentials, runtime readability, DM policy, shared-space policy, mention behavior, and path-by-path testing.
Repeated setup ladder

The order that keeps channel rollout debuggable

  1. Get working credentials. Do not continue until the token, session, or linked device is real.
  2. Make the runtime read them. Stored somewhere is not the same as loaded by the running service.
  3. Choose DM policy. Decide who can start the direct path.
  4. Choose shared-space policy. Decide which rooms, groups, channels, or guilds are allowed.
  5. Choose mention behavior. Decide whether ambient replies are expected or explicit mentions are required.
  6. Test each path separately. DM success does not prove shared-space success.
What repeats

The concepts that show up on every platform

DMs vs shared spaces

A healthy DM path does not prove the bot is ready in rooms, channels, or groups.

Mention gating

A healthy bot can still look silent if shared-space replies require an explicit mention.

ID formats

Different platforms use different identifier shapes, but the allow/deny logic repeats.

Useful examples

Examples of what to test on every channel

DM testSend one direct message from an approved sender and confirm the reply path is visible and timely.
Shared-space testSend one explicit mention in the allowed room/channel and verify whether mention gating explains the behavior.
Policy testTry the same action from a non-allowed sender or location to make sure the boundaries behave intentionally.
Open deeper reference links for this page