docs(gateway): split configuration-reference by extracting channels cluster into config-channels

vincentkoc · vincentkoc · commit f051204bea1e · 2026-04-23T20:12:09.000-07:00
diff --git a/docs/channels/discord.md b/docs/channels/discord.md
@@ -1134,7 +1134,7 @@ openclaw logs --follow
 
 ## Configuration reference
 
-Primary reference: [Configuration reference - Discord](/gateway/configuration-reference#discord).
+Primary reference: [Configuration reference - Discord](/gateway/config-channels#discord).
 
 <Accordion title="High-signal Discord fields">
 
diff --git a/docs/channels/imessage.md b/docs/channels/imessage.md
@@ -23,7 +23,7 @@ Status: legacy external CLI integration. Gateway spawns `imsg rpc` and communica
   <Card title="Pairing" icon="link" href="/channels/pairing">
     iMessage DMs default to pairing mode.
   </Card>
-  <Card title="Configuration reference" icon="settings" href="/gateway/configuration-reference#imessage">
+  <Card title="Configuration reference" icon="settings" href="/gateway/config-channels#imessage">
     Full iMessage field reference.
   </Card>
 </CardGroup>
@@ -413,7 +413,7 @@ imsg send <handle> "test"
 
 ## Configuration reference pointers
 
-- [Configuration reference - iMessage](/gateway/configuration-reference#imessage)
+- [Configuration reference - iMessage](/gateway/config-channels#imessage)
 - [Gateway configuration](/gateway/configuration)
 - [Pairing](/channels/pairing)
 - [BlueBubbles](/channels/bluebubbles)
diff --git a/docs/channels/matrix.md b/docs/channels/matrix.md
@@ -670,7 +670,7 @@ If multiple Matrix accounts are configured and one account id is `default`, Open
 If you configure multiple named accounts, set `defaultAccount` or pass `--account <id>` for CLI commands that rely on implicit account selection.
 Pass `--account <id>` to `openclaw matrix verify ...` and `openclaw matrix devices ...` when you want to override that implicit selection for one command.
 
-See [Configuration reference](/gateway/configuration-reference#multi-account-all-channels) for the shared multi-account pattern.
+See [Configuration reference](/gateway/config-channels#multi-account-all-channels) for the shared multi-account pattern.
 
 ## Private/LAN homeservers
 
diff --git a/docs/channels/signal.md b/docs/channels/signal.md
@@ -99,7 +99,7 @@ Example:
 }
 ```
 
-Multi-account support: use `channels.signal.accounts` with per-account config and optional `name`. See [`gateway/configuration`](/gateway/configuration-reference#multi-account-all-channels) for the shared pattern.
+Multi-account support: use `channels.signal.accounts` with per-account config and optional `name`. See [`gateway/configuration`](/gateway/config-channels#multi-account-all-channels) for the shared pattern.
 
 ## Setup path B: register dedicated bot number (SMS, Linux)
 
diff --git a/docs/channels/slack.md b/docs/channels/slack.md
@@ -785,7 +785,7 @@ Same-chat `/approve` also works in Slack channels and DMs that already support c
 
 ## Configuration reference
 
-Primary reference: [Configuration reference - Slack](/gateway/configuration-reference#slack).
+Primary reference: [Configuration reference - Slack](/gateway/config-channels#slack).
 
 <Accordion title="High-signal Slack fields">
 
diff --git a/docs/channels/telegram.md b/docs/channels/telegram.md
@@ -885,7 +885,7 @@ More help: [Channel troubleshooting](/channels/troubleshooting).
 
 ## Configuration reference
 
-Primary reference: [Configuration reference - Telegram](/gateway/configuration-reference#telegram).
+Primary reference: [Configuration reference - Telegram](/gateway/config-channels#telegram).
 
 <Accordion title="High-signal Telegram fields">
 
diff --git a/docs/channels/whatsapp.md b/docs/channels/whatsapp.md
@@ -558,7 +558,7 @@ Example:
 
 Primary reference:
 
-- [Configuration reference - WhatsApp](/gateway/configuration-reference#whatsapp)
+- [Configuration reference - WhatsApp](/gateway/config-channels#whatsapp)
 
 High-signal WhatsApp fields:
 
diff --git a/docs/docs.json b/docs/docs.json
@@ -1367,6 +1367,7 @@
                       "gateway/configuration",
                       "gateway/configuration-reference",
                       "gateway/config-agents",
+                      "gateway/config-channels",
                       "gateway/configuration-examples",
                       "gateway/authentication",
                       "auth-credential-semantics",
diff --git a/docs/gateway/config-channels.md b/docs/gateway/config-channels.md
diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md
diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md

Original file line number	Diff line number	Diff line change
`@@ -99,7 +99,7 @@ Example:`
`99`	`99`	`}`
`100`	`100`	```
`101`	`101`
`102`		-Multi-account support: use `channels.signal.accounts` with per-account config and optional `name`. See [`gateway/configuration`](/gateway/configuration-reference#multi-account-all-channels) for the shared pattern.
	`102`	+Multi-account support: use `channels.signal.accounts` with per-account config and optional `name`. See [`gateway/configuration`](/gateway/config-channels#multi-account-all-channels) for the shared pattern.
`103`	`103`
`104`	`104`	`## Setup path B: register dedicated bot number (SMS, Linux)`
`105`	`105`