Docs: fix internal links

docs/start/clawd.md

@@ -101,7 +101,7 @@ Tip: treat this folder like Clawd’s “memory” and make it a git repo (ideal
 clawdbot setup
 ```
 
-Full workspace layout + backup guide: [`docs/agent-workspace.md`](/concepts/agent-workspace)
+Full workspace layout + backup guide: [Agent workspace](/concepts/agent-workspace)
 
 Optional: choose a different workspace with `agents.defaults.workspace` (supports `~`).
 

docs/start/hubs.md

@@ -9,167 +9,167 @@ Use these hubs to discover every page, including deep dives and reference docs t
 
 ## Start here
 
-- [Index](https://docs.clawd.bot)
-- [Getting Started](https://docs.clawd.bot/start/getting-started)
-- [Onboarding](https://docs.clawd.bot/start/onboarding)
-- [Wizard](https://docs.clawd.bot/start/wizard)
-- [Setup](https://docs.clawd.bot/start/setup)
+- [Index](/)
+- [Getting Started](/start/getting-started)
+- [Onboarding](/start/onboarding)
+- [Wizard](/start/wizard)
+- [Setup](/start/setup)
 - [Dashboard (local Gateway)](http://127.0.0.1:18789/)
-- [FAQ](https://docs.clawd.bot/start/faq)
-- [Configuration](https://docs.clawd.bot/gateway/configuration)
-- [Configuration examples](https://docs.clawd.bot/gateway/configuration-examples)
-- [Clawdbot assistant (Clawd)](https://docs.clawd.bot/start/clawd)
-- [Showcase](https://docs.clawd.bot/start/showcase)
-- [Lore](https://docs.clawd.bot/start/lore)
+- [FAQ](/start/faq)
+- [Configuration](/gateway/configuration)
+- [Configuration examples](/gateway/configuration-examples)
+- [Clawdbot assistant (Clawd)](/start/clawd)
+- [Showcase](/start/showcase)
+- [Lore](/start/lore)
 
 ## Installation + updates
 
-- [Docker](https://docs.clawd.bot/install/docker)
-- [Nix](https://docs.clawd.bot/install/nix)
-- [Updating / rollback](https://docs.clawd.bot/install/updating)
-- [Bun workflow](https://docs.clawd.bot/install/bun)
+- [Docker](/install/docker)
+- [Nix](/install/nix)
+- [Updating / rollback](/install/updating)
+- [Bun workflow](/install/bun)
 
 ## Core concepts
 
-- [Architecture](https://docs.clawd.bot/concepts/architecture)
-- [Agent runtime](https://docs.clawd.bot/concepts/agent)
-- [Agent workspace](https://docs.clawd.bot/concepts/agent-workspace)
-- [Agent loop](https://docs.clawd.bot/concepts/agent-loop)
+- [Architecture](/concepts/architecture)
+- [Agent runtime](/concepts/agent)
+- [Agent workspace](/concepts/agent-workspace)
+- [Agent loop](/concepts/agent-loop)
 - [Streaming + chunking](/concepts/streaming)
-- [Multi-agent routing](https://docs.clawd.bot/concepts/multi-agent)
-- [Compaction](https://docs.clawd.bot/concepts/compaction)
-- [Sessions](https://docs.clawd.bot/concepts/session)
-- [Sessions (alias)](https://docs.clawd.bot/concepts/sessions)
-- [Session pruning](https://docs.clawd.bot/concepts/session-pruning)
-- [Session tools](https://docs.clawd.bot/concepts/session-tool)
-- [Queue](https://docs.clawd.bot/concepts/queue)
-- [Slash commands](https://docs.clawd.bot/tools/slash-commands)
-- [RPC adapters](https://docs.clawd.bot/reference/rpc)
-- [TypeBox schemas](https://docs.clawd.bot/concepts/typebox)
-- [Timezone handling](https://docs.clawd.bot/concepts/timezone)
-- [Presence](https://docs.clawd.bot/concepts/presence)
-- [Discovery + transports](https://docs.clawd.bot/gateway/discovery)
-- [Bonjour](https://docs.clawd.bot/gateway/bonjour)
-- [Provider routing](https://docs.clawd.bot/concepts/provider-routing)
-- [Groups](https://docs.clawd.bot/concepts/groups)
-- [Group messages](https://docs.clawd.bot/concepts/group-messages)
-- [Model failover](https://docs.clawd.bot/concepts/model-failover)
-- [OAuth](https://docs.clawd.bot/concepts/oauth)
+- [Multi-agent routing](/concepts/multi-agent)
+- [Compaction](/concepts/compaction)
+- [Sessions](/concepts/session)
+- [Sessions (alias)](/concepts/sessions)
+- [Session pruning](/concepts/session-pruning)
+- [Session tools](/concepts/session-tool)
+- [Queue](/concepts/queue)
+- [Slash commands](/tools/slash-commands)
+- [RPC adapters](/reference/rpc)
+- [TypeBox schemas](/concepts/typebox)
+- [Timezone handling](/concepts/timezone)
+- [Presence](/concepts/presence)
+- [Discovery + transports](/gateway/discovery)
+- [Bonjour](/gateway/bonjour)
+- [Provider routing](/concepts/provider-routing)
+- [Groups](/concepts/groups)
+- [Group messages](/concepts/group-messages)
+- [Model failover](/concepts/model-failover)
+- [OAuth](/concepts/oauth)
 
 ## Providers + ingress
 
-- [WhatsApp](https://docs.clawd.bot/providers/whatsapp)
-- [Telegram](https://docs.clawd.bot/providers/telegram)
-- [Telegram (grammY notes)](https://docs.clawd.bot/providers/grammy)
-- [Slack](https://docs.clawd.bot/providers/slack)
-- [Discord](https://docs.clawd.bot/providers/discord)
-- [Signal](https://docs.clawd.bot/providers/signal)
-- [iMessage](https://docs.clawd.bot/providers/imessage)
-- [Location parsing](https://docs.clawd.bot/providers/location)
-- [WebChat](https://docs.clawd.bot/web/webchat)
-- [Webhooks](https://docs.clawd.bot/automation/webhook)
-- [Gmail Pub/Sub](https://docs.clawd.bot/automation/gmail-pubsub)
+- [WhatsApp](/providers/whatsapp)
+- [Telegram](/providers/telegram)
+- [Telegram (grammY notes)](/providers/grammy)
+- [Slack](/providers/slack)
+- [Discord](/providers/discord)
+- [Signal](/providers/signal)
+- [iMessage](/providers/imessage)
+- [Location parsing](/providers/location)
+- [WebChat](/web/webchat)
+- [Webhooks](/automation/webhook)
+- [Gmail Pub/Sub](/automation/gmail-pubsub)
 
 ## Gateway + operations
 
-- [Gateway runbook](https://docs.clawd.bot/gateway)
-- [Gateway pairing](https://docs.clawd.bot/gateway/pairing)
-- [Gateway lock](https://docs.clawd.bot/gateway/gateway-lock)
-- [Background process](https://docs.clawd.bot/gateway/background-process)
-- [Health](https://docs.clawd.bot/gateway/health)
-- [Heartbeat](https://docs.clawd.bot/gateway/heartbeat)
-- [Doctor](https://docs.clawd.bot/gateway/doctor)
-- [Logging](https://docs.clawd.bot/gateway/logging)
-- [Sandboxing](https://docs.clawd.bot/gateway/sandboxing)
-- [Dashboard](https://docs.clawd.bot/web/dashboard)
-- [Control UI](https://docs.clawd.bot/web/control-ui)
-- [Remote access](https://docs.clawd.bot/gateway/remote)
-- [Remote gateway README](https://docs.clawd.bot/gateway/remote-gateway-readme)
-- [Tailscale](https://docs.clawd.bot/gateway/tailscale)
-- [Security](https://docs.clawd.bot/gateway/security)
-- [Troubleshooting](https://docs.clawd.bot/gateway/troubleshooting)
+- [Gateway runbook](/gateway)
+- [Gateway pairing](/gateway/pairing)
+- [Gateway lock](/gateway/gateway-lock)
+- [Background process](/gateway/background-process)
+- [Health](/gateway/health)
+- [Heartbeat](/gateway/heartbeat)
+- [Doctor](/gateway/doctor)
+- [Logging](/gateway/logging)
+- [Sandboxing](/gateway/sandboxing)
+- [Dashboard](/web/dashboard)
+- [Control UI](/web/control-ui)
+- [Remote access](/gateway/remote)
+- [Remote gateway README](/gateway/remote-gateway-readme)
+- [Tailscale](/gateway/tailscale)
+- [Security](/gateway/security)
+- [Troubleshooting](/gateway/troubleshooting)
 
 ## Tools + automation
 
-- [Tools surface](https://docs.clawd.bot/tools)
-- [CLI reference](https://docs.clawd.bot/cli)
-- [Bash tool](https://docs.clawd.bot/tools/bash)
-- [Elevated mode](https://docs.clawd.bot/tools/elevated)
-- [Cron jobs](https://docs.clawd.bot/automation/cron-jobs)
-- [Thinking + verbose](https://docs.clawd.bot/tools/thinking)
-- [Models](https://docs.clawd.bot/concepts/models)
-- [Sub-agents](https://docs.clawd.bot/tools/subagents)
-- [Agent send CLI](https://docs.clawd.bot/tools/agent-send)
-- [Terminal UI](https://docs.clawd.bot/tui)
-- [Browser control](https://docs.clawd.bot/tools/browser)
-- [Browser (Linux troubleshooting)](https://docs.clawd.bot/tools/browser-linux-troubleshooting)
-- [Polls](https://docs.clawd.bot/automation/poll)
+- [Tools surface](/tools)
+- [CLI reference](/cli)
+- [Bash tool](/tools/bash)
+- [Elevated mode](/tools/elevated)
+- [Cron jobs](/automation/cron-jobs)
+- [Thinking + verbose](/tools/thinking)
+- [Models](/concepts/models)
+- [Sub-agents](/tools/subagents)
+- [Agent send CLI](/tools/agent-send)
+- [Terminal UI](/tui)
+- [Browser control](/tools/browser)
+- [Browser (Linux troubleshooting)](/tools/browser-linux-troubleshooting)
+- [Polls](/automation/poll)
 
 ## Nodes, media, voice
 
-- [Nodes overview](https://docs.clawd.bot/nodes)
-- [Camera](https://docs.clawd.bot/nodes/camera)
-- [Images](https://docs.clawd.bot/nodes/images)
-- [Audio](https://docs.clawd.bot/nodes/audio)
-- [Location command](https://docs.clawd.bot/nodes/location-command)
-- [Voice wake](https://docs.clawd.bot/nodes/voicewake)
-- [Talk mode](https://docs.clawd.bot/nodes/talk)
+- [Nodes overview](/nodes)
+- [Camera](/nodes/camera)
+- [Images](/nodes/images)
+- [Audio](/nodes/audio)
+- [Location command](/nodes/location-command)
+- [Voice wake](/nodes/voicewake)
+- [Talk mode](/nodes/talk)
 
 ## Platforms
 
-- [Platforms overview](https://docs.clawd.bot/platforms)
-- [macOS](https://docs.clawd.bot/platforms/macos)
-- [iOS](https://docs.clawd.bot/platforms/ios)
-- [Android](https://docs.clawd.bot/platforms/android)
-- [Windows (WSL2)](https://docs.clawd.bot/platforms/windows)
-- [Linux](https://docs.clawd.bot/platforms/linux)
-- [Web surfaces](https://docs.clawd.bot/web)
+- [Platforms overview](/platforms)
+- [macOS](/platforms/macos)
+- [iOS](/platforms/ios)
+- [Android](/platforms/android)
+- [Windows (WSL2)](/platforms/windows)
+- [Linux](/platforms/linux)
+- [Web surfaces](/web)
 
 ## macOS companion app (advanced)
 
-- [macOS dev setup](https://docs.clawd.bot/platforms/mac/dev-setup)
-- [macOS menu bar](https://docs.clawd.bot/platforms/mac/menu-bar)
-- [macOS voice wake](https://docs.clawd.bot/platforms/mac/voicewake)
-- [macOS voice overlay](https://docs.clawd.bot/platforms/mac/voice-overlay)
-- [macOS WebChat](https://docs.clawd.bot/platforms/mac/webchat)
-- [macOS Canvas](https://docs.clawd.bot/platforms/mac/canvas)
-- [macOS child process](https://docs.clawd.bot/platforms/mac/child-process)
-- [macOS health](https://docs.clawd.bot/platforms/mac/health)
-- [macOS icon](https://docs.clawd.bot/platforms/mac/icon)
-- [macOS logging](https://docs.clawd.bot/platforms/mac/logging)
-- [macOS permissions](https://docs.clawd.bot/platforms/mac/permissions)
-- [macOS remote](https://docs.clawd.bot/platforms/mac/remote)
-- [macOS signing](https://docs.clawd.bot/platforms/mac/signing)
-- [macOS release](https://docs.clawd.bot/platforms/mac/release)
-- [macOS bundled gateway (Node)](https://docs.clawd.bot/platforms/mac/bundled-gateway)
-- [macOS XPC](https://docs.clawd.bot/platforms/mac/xpc)
-- [macOS skills](https://docs.clawd.bot/platforms/mac/skills)
-- [macOS Peekaboo](https://docs.clawd.bot/platforms/mac/peekaboo)
+- [macOS dev setup](/platforms/mac/dev-setup)
+- [macOS menu bar](/platforms/mac/menu-bar)
+- [macOS voice wake](/platforms/mac/voicewake)
+- [macOS voice overlay](/platforms/mac/voice-overlay)
+- [macOS WebChat](/platforms/mac/webchat)
+- [macOS Canvas](/platforms/mac/canvas)
+- [macOS child process](/platforms/mac/child-process)
+- [macOS health](/platforms/mac/health)
+- [macOS icon](/platforms/mac/icon)
+- [macOS logging](/platforms/mac/logging)
+- [macOS permissions](/platforms/mac/permissions)
+- [macOS remote](/platforms/mac/remote)
+- [macOS signing](/platforms/mac/signing)
+- [macOS release](/platforms/mac/release)
+- [macOS bundled gateway (Node)](/platforms/mac/bundled-gateway)
+- [macOS XPC](/platforms/mac/xpc)
+- [macOS skills](/platforms/mac/skills)
+- [macOS Peekaboo](/platforms/mac/peekaboo)
 
 ## Workspace + templates
 
-- [Skills](https://docs.clawd.bot/tools/skills)
-- [ClawdHub](https://docs.clawd.bot/tools/clawdhub)
-- [Skills config](https://docs.clawd.bot/tools/skills-config)
-- [Default AGENTS](https://docs.clawd.bot/reference/AGENTS.default)
-- [Templates: AGENTS](https://docs.clawd.bot/reference/templates/AGENTS)
-- [Templates: BOOTSTRAP](https://docs.clawd.bot/reference/templates/BOOTSTRAP)
-- [Templates: HEARTBEAT](https://docs.clawd.bot/reference/templates/HEARTBEAT)
-- [Templates: IDENTITY](https://docs.clawd.bot/reference/templates/IDENTITY)
-- [Templates: SOUL](https://docs.clawd.bot/reference/templates/SOUL)
-- [Templates: TOOLS](https://docs.clawd.bot/reference/templates/TOOLS)
-- [Templates: USER](https://docs.clawd.bot/reference/templates/USER)
+- [Skills](/tools/skills)
+- [ClawdHub](/tools/clawdhub)
+- [Skills config](/tools/skills-config)
+- [Default AGENTS](/reference/AGENTS.default)
+- [Templates: AGENTS](/reference/templates/AGENTS)
+- [Templates: BOOTSTRAP](/reference/templates/BOOTSTRAP)
+- [Templates: HEARTBEAT](/reference/templates/HEARTBEAT)
+- [Templates: IDENTITY](/reference/templates/IDENTITY)
+- [Templates: SOUL](/reference/templates/SOUL)
+- [Templates: TOOLS](/reference/templates/TOOLS)
+- [Templates: USER](/reference/templates/USER)
 
 ## Experiments (exploratory)
 
-- [Onboarding config protocol](https://docs.clawd.bot/experiments/onboarding-config-protocol)
-- [Cron hardening notes](https://docs.clawd.bot/experiments/plans/cron-add-hardening)
-- [Group policy hardening notes](https://docs.clawd.bot/experiments/plans/group-policy-hardening)
-- [Research: memory](https://docs.clawd.bot/experiments/research/memory)
-- [Model config exploration](https://docs.clawd.bot/experiments/proposals/model-config)
+- [Onboarding config protocol](/experiments/onboarding-config-protocol)
+- [Cron hardening notes](/experiments/plans/cron-add-hardening)
+- [Group policy hardening notes](/experiments/plans/group-policy-hardening)
+- [Research: memory](/experiments/research/memory)
+- [Model config exploration](/experiments/proposals/model-config)
 
 ## Testing + release
 
-- [Testing](https://docs.clawd.bot/reference/test)
-- [Release checklist](https://docs.clawd.bot/reference/RELEASING)
-- [Device models](https://docs.clawd.bot/reference/device-models)
+- [Testing](/reference/test)
+- [Release checklist](/reference/RELEASING)
+- [Device models](/reference/device-models)

docs/start/setup.md

@@ -17,7 +17,7 @@ Last updated: 2026-01-01
 ## Prereqs (from source)
 - Node `>=22`
 - `pnpm`
-- Docker (optional; only for containerized setup/e2e — see [`docs/docker.md`](/install/docker))
+- Docker (optional; only for containerized setup/e2e — see [Docker](/install/docker))
 
 ## Tailoring strategy (so updates don’t hurt)
 
@@ -121,12 +121,12 @@ sudo loginctl enable-linger $USER
 ```
 
 For always-on or multi-user servers, consider a **system** service instead of a
-user service (no lingering needed). See [`docs/gateway.md`](/gateway) for the systemd notes.
+user service (no lingering needed). See [Gateway runbook](/gateway) for the systemd notes.
 
 ## Related docs
 
-- [`docs/gateway.md`](/gateway) (Gateway runbook; flags, supervision, ports)
-- [`docs/configuration.md`](/gateway/configuration) (config schema + examples)
-- [`docs/discord.md`](/providers/discord) and [`docs/telegram.md`](/providers/telegram) (reply tags + replyToMode settings)
-- [`docs/clawd.md`](/start/clawd) (Clawdbot assistant setup)
-- [`docs/macos.md`](/platforms/macos) (macOS app behavior; gateway lifecycle + “Attach only”)
+- [Gateway runbook](/gateway) (flags, supervision, ports)
+- [Gateway configuration](/gateway/configuration) (config schema + examples)
+- [Discord](/providers/discord) and [Telegram](/providers/telegram) (reply tags + replyToMode settings)
+- [Clawdbot assistant setup](/start/clawd)
+- [macOS app](/platforms/macos) (gateway lifecycle + “Attach only”)

docs/start/wizard.md

@@ -92,7 +92,7 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
 3) **Workspace**
    - Default `~/clawd` (configurable).
    - Seeds the workspace files needed for the agent bootstrap ritual.
-   - Full workspace layout + backup guide: [`docs/agent-workspace.md`](/concepts/agent-workspace)
+   - Full workspace layout + backup guide: [Agent workspace](/concepts/agent-workspace)
 
 4) **Gateway**
    - Port, bind, auth mode, tailscale exposure.
@@ -259,7 +259,7 @@ Sessions are stored under `~/.clawdbot/agents/<agentId>/sessions/`.
 
 ## Related docs
 
-- macOS app onboarding: [`docs/onboarding.md`](/start/onboarding)
-- Config reference: [`docs/configuration.md`](/gateway/configuration)
-- Providers: [`docs/whatsapp.md`](/providers/whatsapp), [`docs/telegram.md`](/providers/telegram), [`docs/discord.md`](/providers/discord), [`docs/signal.md`](/providers/signal), [`docs/imessage.md`](/providers/imessage)
-- Skills: [`docs/skills.md`](/tools/skills), [`docs/skills-config.md`](/tools/skills-config)
+- macOS app onboarding: [Onboarding](/start/onboarding)
+- Config reference: [Gateway configuration](/gateway/configuration)
+- Providers: [WhatsApp](/providers/whatsapp), [Telegram](/providers/telegram), [Discord](/providers/discord), [Signal](/providers/signal), [iMessage](/providers/imessage)
+- Skills: [Skills](/tools/skills), [Skills config](/tools/skills-config)