- 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.
1.2 KiB
1.2 KiB
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.jsonandclawdbot.plugin.json. - Export a
ChannelPlugindefinition from the main entrypoint.
2. Plugin SDK Implementation
- Implement
capabilities(polls, reactions, media). - Define
configSchemafor account settings. - Implement
gateway.startAccountfor lifecycle management. - Implement
outbound.sendTextandoutbound.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_ORDERfor 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 lintandpnpm build. - Test incoming message routing and agent reply delivery.
- Verify account linking/login flow (e.g., QR code or API key).