openclaw/docs/channels/adding-channels.md
Yash Soni 5918074752 [AI-assisted] Docs: add missing documentation areas (Agent Roles, Tooling Policy, Ownership, Channel Guide)
- Created docs/reference/agent-roles.md, docs/reference/tooling-policy.md, docs/reference/ownership.md.
- Created docs/channels/adding-channels.md.
- Updated docs/reference/RELEASING.md and AGENTS.md.
- Degree of testing: documentation review.
- Confirmed understanding of codebase structure.
2026-01-27 14:14:49 +05:30

30 lines
1.2 KiB
Markdown

# New Channel Checklist
Follow this guide when adding a new messaging channel or provider to Clawdbot.
## 1. Extension Setup
- [ ] Create a new directory in `extensions/<channel-name>`.
- [ ] Initialize `package.json` and `clawdbot.plugin.json`.
- [ ] Export a `ChannelPlugin` definition from the main entrypoint.
## 2. Plugin SDK Implementation
- [ ] Implement `capabilities` (polls, reactions, media).
- [ ] Define `configSchema` for account settings.
- [ ] Implement `gateway.startAccount` for lifecycle management.
- [ ] Implement `outbound.sendText` and `outbound.sendMedia`.
## 3. Docking & Routing
- [ ] Register the channel in `src/channels/registry.ts` (if core) or via the plugin loader.
- [ ] Add the channel to `CHAT_CHANNEL_ORDER` for UI ranking.
- [ ] Verify message normalization in `src/auto-reply/dispatch.ts`.
## 4. UI & Docs
- [ ] Add UI metadata to the catalog in `src/channels/plugins/catalog.ts`.
- [ ] Create a documentation page in `docs/channels/<channel-name>.md`.
- [ ] Add the channel to the "Supported Channels" list in the main README.
## 5. Verification
- [ ] Run `pnpm lint` and `pnpm build`.
- [ ] Test incoming message routing and agent reply delivery.
- [ ] Verify account linking/login flow (e.g., QR code or API key).