← Back to Channels and integrations
OpenClaw channels

Channel setup guide

This page is the high-level setup database for channels: what layers every channel has, what to test first, and how to keep setup honest.

Setup ruleProve transport, then DM behavior, then shared-space behavior, then policy boundaries. Do not collapse those checks into one vague β€œit works.”
Universal layers

The setup layers every channel has

Credential layerThe runtime must actually read the real token, session, or homeserver credentials.
Direct-message layerDM success should be tested separately from shared-space success.
Shared-space layerChannels, rooms, groups, or guilds need their own visibility and policy checks.
Policy layerPairing, allowlists, and mention gating decide who can talk where and how.
First tests

The first three tests worth running on any channel

  1. Transport test: prove the bot/session actually connected.
  2. DM test: prove one direct path from an allowed sender.
  3. Shared-space test: prove one room/channel path and note whether mention policy explains the result.
Open deeper reference links for this page