docs: reorganize documentation structure

docs/index.md

@@ -19,8 +19,8 @@ read_when:
 <p align="center">
   <a href="https://github.com/clawdbot/clawdbot">GitHub</a> ·
   <a href="https://github.com/clawdbot/clawdbot/releases">Releases</a> ·
-  <a href="/">Docs</a> ·
-  <a href="/clawd">Clawd setup</a>
+  <a href="https://docs.clawd.bot">Docs</a> ·
+  <a href="https://docs.clawd.bot/start/clawd">Clawd setup</a>
 </p>
 
 CLAWDBOT bridges WhatsApp (via WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / discord.js), and iMessage (imsg CLI) to coding agents like [Pi](https://github.com/badlogic/pi-mono).
@@ -28,8 +28,18 @@ It’s built for [Clawd](https://clawd.me), a space lobster who needed a TARDIS.
 
 ## Start here
 
-- **New install from zero:** [Getting started](/getting-started)
-- **Guided setup (recommended):** [Wizard](/wizard) (`clawdbot onboard`)
+- **New install from zero:** https://docs.clawd.bot/start/getting-started
+- **Guided setup (recommended):** https://docs.clawd.bot/start/wizard (`clawdbot onboard`)
+- **Open the dashboard (local Gateway):** http://127.0.0.1:18789/ (or http://localhost:18789/)
+
+If the Gateway is running on the same computer, that link opens the browser Control UI
+immediately. If it fails, start the Gateway first: `clawdbot gateway`.
+
+## Dashboard (browser Control UI)
+
+The dashboard is the browser Control UI for chat, config, nodes, sessions, and more.
+Local default: http://127.0.0.1:18789/
+Remote access: https://docs.clawd.bot/web and https://docs.clawd.bot/gateway/tailscale
 
 ## How it works
 
@@ -60,8 +70,8 @@ Most operations flow through the **Gateway** (`clawdbot gateway`), a single long
 - **Loopback-first**: Gateway WS defaults to `ws://127.0.0.1:18789`.
   - For Tailnet access, run `clawdbot gateway --bind tailnet --token ...` (token is required for non-loopback binds).
 - **Bridge for nodes**: optional LAN/tailnet-facing bridge on `tcp://0.0.0.0:18790` for paired nodes (Bonjour-discoverable).
-- **Canvas host**: HTTP file server on `canvasHost.port` (default `18793`), serving `/__clawdbot__/canvas/` for node WebViews; see [`docs/configuration.md`](/configuration) (`canvasHost`).
-- **Remote use**: SSH tunnel or tailnet/VPN; see [`docs/remote.md`](/remote) and [`docs/discovery.md`](/discovery).
+- **Canvas host**: HTTP file server on `canvasHost.port` (default `18793`), serving `/__clawdbot__/canvas/` for node WebViews; see [`docs/configuration.md`](https://docs.clawd.bot/gateway/configuration) (`canvasHost`).
+- **Remote use**: SSH tunnel or tailnet/VPN; see [`docs/remote.md`](https://docs.clawd.bot/gateway/remote) and [`docs/discovery.md`](https://docs.clawd.bot/gateway/discovery).
 
 ## Features (high level)
 
@@ -135,45 +145,47 @@ Example:
 ## Docs
 
 - Start here:
-  - [Docs hubs (all pages linked)](/hubs)
-  - [FAQ](/faq) ← *common questions answered*
-  - [Configuration](/configuration)
-  - [Slash commands](/slash-commands)
-  - [Multi-agent routing](/multi-agent)
-  - [Updating / rollback](/updating)
-  - [Pairing (DM + nodes)](/pairing)
-  - [Nix mode](/nix)
-  - [Clawd personal assistant setup](/clawd)
-  - [Skills](/skills)
-  - [Skills config](/skills-config)
-  - [Workspace templates](/templates/AGENTS)
-  - [RPC adapters](/rpc)
-  - [Gateway runbook](/gateway)
-  - [Nodes (iOS/Android)](/nodes)
-  - [Web surfaces (Control UI)](/web)
-  - [Discovery + transports](/discovery)
-  - [Remote access](/remote)
+  - [Docs hubs (all pages linked)](https://docs.clawd.bot/start/hubs)
+  - [FAQ](https://docs.clawd.bot/start/faq) ← *common questions answered*
+  - [Configuration](https://docs.clawd.bot/gateway/configuration)
+  - [Slash commands](https://docs.clawd.bot/tools/slash-commands)
+  - [Multi-agent routing](https://docs.clawd.bot/concepts/multi-agent)
+  - [Updating / rollback](https://docs.clawd.bot/install/updating)
+  - [Pairing (DM + nodes)](https://docs.clawd.bot/start/pairing)
+  - [Nix mode](https://docs.clawd.bot/install/nix)
+  - [Clawd personal assistant setup](https://docs.clawd.bot/start/clawd)
+  - [Skills](https://docs.clawd.bot/tools/skills)
+  - [Skills config](https://docs.clawd.bot/tools/skills-config)
+  - [Workspace templates](https://docs.clawd.bot/reference/templates/AGENTS)
+  - [RPC adapters](https://docs.clawd.bot/reference/rpc)
+  - [Gateway runbook](https://docs.clawd.bot/gateway)
+  - [Nodes (iOS/Android)](https://docs.clawd.bot/nodes)
+  - [Web surfaces (Control UI)](https://docs.clawd.bot/web)
+  - [Discovery + transports](https://docs.clawd.bot/gateway/discovery)
+  - [Remote access](https://docs.clawd.bot/gateway/remote)
 - Providers and UX:
-  - [WebChat](/webchat)
-  - [Control UI (browser)](/control-ui)
-  - [Telegram](/telegram)
-  - [Discord](/discord)
-  - [iMessage](/imessage)
-  - [Groups](/groups)
-  - [WhatsApp group messages](/group-messages)
-  - [Media: images](/images)
-  - [Media: audio](/audio)
+  - [WebChat](https://docs.clawd.bot/web/webchat)
+  - [Control UI (browser)](https://docs.clawd.bot/web/control-ui)
+  - [Telegram](https://docs.clawd.bot/providers/telegram)
+  - [Discord](https://docs.clawd.bot/providers/discord)
+  - [iMessage](https://docs.clawd.bot/providers/imessage)
+  - [Groups](https://docs.clawd.bot/concepts/groups)
+  - [WhatsApp group messages](https://docs.clawd.bot/concepts/group-messages)
+  - [Media: images](https://docs.clawd.bot/nodes/images)
+  - [Media: audio](https://docs.clawd.bot/nodes/audio)
 - Companion apps:
-  - [macOS app](/macos)
-  - [iOS app](/ios)
-  - [Android app](/android)
-  - [Windows app](/windows)
-  - [Linux app](/linux)
+  - [macOS app](https://docs.clawd.bot/platforms/macos)
+  - [iOS app](https://docs.clawd.bot/platforms/ios)
+  - [Android app](https://docs.clawd.bot/platforms/android)
+  - [Windows app](https://docs.clawd.bot/platforms/windows)
+  - [Linux app](https://docs.clawd.bot/platforms/linux)
 - Ops and safety:
-  - [Sessions](/session)
-  - [Cron jobs](/cron-jobs)
-  - [Security](/security)
-  - [Troubleshooting](/troubleshooting)
+  - [Sessions](https://docs.clawd.bot/concepts/session)
+  - [Cron jobs](https://docs.clawd.bot/automation/cron-jobs)
+  - [Webhooks](https://docs.clawd.bot/automation/webhook)
+  - [Gmail hooks (Pub/Sub)](https://docs.clawd.bot/automation/gmail-pubsub)
+  - [Security](https://docs.clawd.bot/gateway/security)
+  - [Troubleshooting](https://docs.clawd.bot/gateway/troubleshooting)
 
 ## The name