refactor!: rename chat providers to channels

docs/gateway/configuration-examples.md

@@ -15,7 +15,7 @@ Examples below are aligned with the current config schema. For the exhaustive re
 ```json5
 {
   agent: { workspace: "~/clawd" },
-  whatsapp: { allowFrom: ["+15555550123"] }
+  channels: { whatsapp: { allowFrom: ["+15555550123"] } }
 }
 ```
 
@@ -33,9 +33,11 @@ Save to `~/.clawdbot/clawdbot.json` and you can DM the bot from that number.
     workspace: "~/clawd",
     model: { primary: "anthropic/claude-sonnet-4-5" }
   },
-  whatsapp: {
-    allowFrom: ["+15555550123"],
-    groups: { "*": { requireMention: true } }
+  channels: {
+    whatsapp: {
+      allowFrom: ["+15555550123"],
+      groups: { "*": { requireMention: true } }
+    }
   }
 }
 ```
@@ -147,52 +149,54 @@ Save to `~/.clawdbot/clawdbot.json` and you can DM the bot from that number.
   },
 
   // Providers
-  whatsapp: {
-    dmPolicy: "pairing",
-    allowFrom: ["+15555550123"],
-    groupPolicy: "allowlist",
-    groupAllowFrom: ["+15555550123"],
-    groups: { "*": { requireMention: true } }
-  },
+  channels: {
+    whatsapp: {
+      dmPolicy: "pairing",
+      allowFrom: ["+15555550123"],
+      groupPolicy: "allowlist",
+      groupAllowFrom: ["+15555550123"],
+      groups: { "*": { requireMention: true } }
+    },
 
-  telegram: {
-    enabled: true,
-    botToken: "YOUR_TELEGRAM_BOT_TOKEN",
-    allowFrom: ["123456789"],
-    groupPolicy: "allowlist",
-    groupAllowFrom: ["123456789"],
-    groups: { "*": { requireMention: true } }
-  },
+    telegram: {
+      enabled: true,
+      botToken: "YOUR_TELEGRAM_BOT_TOKEN",
+      allowFrom: ["123456789"],
+      groupPolicy: "allowlist",
+      groupAllowFrom: ["123456789"],
+      groups: { "*": { requireMention: true } }
+    },
 
-  discord: {
-    enabled: true,
-    token: "YOUR_DISCORD_BOT_TOKEN",
-    dm: { enabled: true, allowFrom: ["steipete"] },
-    guilds: {
-      "123456789012345678": {
-        slug: "friends-of-clawd",
-        requireMention: false,
-        channels: {
-          general: { allow: true },
-          help: { allow: true, requireMention: true }
+    discord: {
+      enabled: true,
+      token: "YOUR_DISCORD_BOT_TOKEN",
+      dm: { enabled: true, allowFrom: ["steipete"] },
+      guilds: {
+        "123456789012345678": {
+          slug: "friends-of-clawd",
+          requireMention: false,
+          channels: {
+            general: { allow: true },
+            help: { allow: true, requireMention: true }
+          }
         }
       }
-    }
-  },
-
-  slack: {
-    enabled: true,
-    botToken: "xoxb-REPLACE_ME",
-    appToken: "xapp-REPLACE_ME",
-    channels: {
-      "#general": { allow: true, requireMention: true }
     },
-    dm: { enabled: true, allowFrom: ["U123"] },
-    slashCommand: {
+
+    slack: {
       enabled: true,
-      name: "clawd",
-      sessionPrefix: "slack:slash",
-      ephemeral: true
+      botToken: "xoxb-REPLACE_ME",
+      appToken: "xapp-REPLACE_ME",
+      channels: {
+        "#general": { allow: true, requireMention: true }
+      },
+      dm: { enabled: true, allowFrom: ["U123"] },
+      slashCommand: {
+        enabled: true,
+        name: "clawd",
+        sessionPrefix: "slack:slash",
+        ephemeral: true
+      }
     }
   },
 
@@ -406,16 +410,18 @@ Save to `~/.clawdbot/clawdbot.json` and you can DM the bot from that number.
 ```json5
 {
   agent: { workspace: "~/clawd" },
-  whatsapp: { allowFrom: ["+15555550123"] },
-  telegram: {
-    enabled: true,
-    botToken: "YOUR_TOKEN",
-    allowFrom: ["123456789"]
-  },
-  discord: {
-    enabled: true,
-    token: "YOUR_TOKEN",
-    dm: { allowFrom: ["yourname"] }
+  channels: {
+    whatsapp: { allowFrom: ["+15555550123"] },
+    telegram: {
+      enabled: true,
+      botToken: "YOUR_TOKEN",
+      allowFrom: ["123456789"]
+    },
+    discord: {
+      enabled: true,
+      token: "YOUR_TOKEN",
+      dm: { allowFrom: ["yourname"] }
+    }
   }
 }
 ```
@@ -460,12 +466,14 @@ Save to `~/.clawdbot/clawdbot.json` and you can DM the bot from that number.
     workspace: "~/work-clawd",
     elevated: { enabled: false }
   },
-  slack: {
-    enabled: true,
-    botToken: "xoxb-...",
-    channels: {
-      "#engineering": { allow: true, requireMention: true },
-      "#general": { allow: true, requireMention: true }
+  channels: {
+    slack: {
+      enabled: true,
+      botToken: "xoxb-...",
+      channels: {
+        "#engineering": { allow: true, requireMention: true },
+        "#general": { allow: true, requireMention: true }
+      }
     }
   }
 }
@@ -507,4 +515,4 @@ Save to `~/.clawdbot/clawdbot.json` and you can DM the bot from that number.
 - If you set `dmPolicy: "open"`, the matching `allowFrom` list must include `"*"`.
 - Provider IDs differ (phone numbers, user IDs, channel IDs). Use the provider docs to confirm the format.
 - Optional sections to add later: `web`, `browser`, `ui`, `bridge`, `discovery`, `canvasHost`, `talk`, `signal`, `imessage`.
-- See [Providers](/providers/whatsapp) and [Troubleshooting](/gateway/troubleshooting) for deeper setup notes.
+- See [Providers](/channels/whatsapp) and [Troubleshooting](/gateway/troubleshooting) for deeper setup notes.