Transport
Transport broke
Recheck token, session, homeserver, or linked-device state before touching channel policy.
DM works, shared space fails
Treat it as a visibility or policy problem first, not a credential problem.
OpenClaw channels
Channel recovery patterns
Use this page when a channel setup is partly working and you need the fastest route back to a healthy state without restarting from scratch.
Core ideaMost channel failures are partial states, so the right recovery depends on which layer is actually broken.
Recovery ladder
Recover the broken layer instead of rebuilding everything
- confirm whether transport is healthy at all
- separate DM behavior from shared-space behavior
- verify pairing, allowlists, and mention gating separately
- confirm the bot is actually present in the target room, group, guild, or channel
- only rebuild credentials or sessions when the failure is truly at the transport layer
Common branches
The most useful operator splits
Visibility
Mentions
Shared space works only on mention
Treat it as expected mention gating until config proves otherwise.