diff --git a/docs/cli/acp.md b/docs/cli/acp.md
index b28e43a4f56..5d855c44e7b 100644
--- a/docs/cli/acp.md
+++ b/docs/cli/acp.md
@@ -314,3 +314,8 @@ Security note:
 - `--server-args <args...>`: extra arguments passed to the ACP server.
 - `--server-verbose`: enable verbose logging on the ACP server.
 - `--verbose, -v`: verbose client logging.
+
+## Related
+
+- [CLI reference](/cli)
+- [ACP agents](/tools/acp-agents)
diff --git a/docs/cli/backup.md b/docs/cli/backup.md
index 18c4345379e..ad47b2a564b 100644
--- a/docs/cli/backup.md
+++ b/docs/cli/backup.md
@@ -82,3 +82,7 @@ Practical limits come from the local machine and destination filesystem:
 Large workspaces are usually the main driver of archive size. If you want a smaller or faster backup, use `--no-include-workspace`.
 
 For the smallest archive, use `--only-config`.
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/browser.md b/docs/cli/browser.md
index e886837b3ef..3ca9ea0e164 100644
--- a/docs/cli/browser.md
+++ b/docs/cli/browser.md
@@ -245,3 +245,8 @@ If the Gateway runs on a different machine than the browser, run a **node host**
 Use `gateway.nodes.browser.mode` to control auto-routing and `gateway.nodes.browser.node` to pin a specific node if multiple are connected.
 
 Security + remote setup: [Browser tool](/tools/browser), [Remote access](/gateway/remote), [Tailscale](/gateway/tailscale), [Security](/gateway/security)
+
+## Related
+
+- [CLI reference](/cli)
+- [Browser](/tools/browser)
diff --git a/docs/cli/clawbot.md b/docs/cli/clawbot.md
index 37756d2006b..acb04c1522b 100644
--- a/docs/cli/clawbot.md
+++ b/docs/cli/clawbot.md
@@ -19,3 +19,7 @@ Current supported alias:
 Prefer modern top-level commands directly:
 
 - `openclaw clawbot qr` -> `openclaw qr`
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/completion.md b/docs/cli/completion.md
index 50080f08184..887a7bc2a9e 100644
--- a/docs/cli/completion.md
+++ b/docs/cli/completion.md
@@ -33,3 +33,7 @@ openclaw completion --shell bash --write-state
 - `--install` writes a small "OpenClaw Completion" block into your shell profile and points it at the cached script.
 - Without `--install` or `--write-state`, the command prints the script to stdout.
 - Completion generation eagerly loads command trees so nested subcommands are included.
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/configure.md b/docs/cli/configure.md
index 9ce6692f0fd..ee11f506cf4 100644
--- a/docs/cli/configure.md
+++ b/docs/cli/configure.md
@@ -70,3 +70,8 @@ openclaw configure --section web
 openclaw configure --section model --section channels
 openclaw configure --section gateway --section daemon
 ```
+
+## Related
+
+- [CLI reference](/cli)
+- [Configuration](/gateway/configuration)
diff --git a/docs/cli/cron.md b/docs/cli/cron.md
index a595ebda3f6..d2bcb45b1d9 100644
--- a/docs/cli/cron.md
+++ b/docs/cli/cron.md
@@ -174,3 +174,8 @@ Failure-delivery note:
   delivery mode is `webhook`.
 - If you do not set any failure destination and the job already announces to a
   channel, failure notifications reuse that same announce target.
+
+## Related
+
+- [CLI reference](/cli)
+- [Scheduled tasks](/automation/cron-jobs)
diff --git a/docs/cli/daemon.md b/docs/cli/daemon.md
index 701fa69b882..4a1f648892c 100644
--- a/docs/cli/daemon.md
+++ b/docs/cli/daemon.md
@@ -55,3 +55,8 @@ Notes:
 ## Prefer
 
 Use [`openclaw gateway`](/cli/gateway) for current docs and examples.
+
+## Related
+
+- [CLI reference](/cli)
+- [Gateway runbook](/gateway)
diff --git a/docs/cli/dashboard.md b/docs/cli/dashboard.md
index 4f6927bf5f1..40ac30851b9 100644
--- a/docs/cli/dashboard.md
+++ b/docs/cli/dashboard.md
@@ -20,3 +20,8 @@ Notes:
 - `dashboard` resolves configured `gateway.auth.token` SecretRefs when possible.
 - For SecretRef-managed tokens (resolved or unresolved), `dashboard` prints/copies/opens a non-tokenized URL to avoid exposing external secrets in terminal output, clipboard history, or browser-launch arguments.
 - If `gateway.auth.token` is SecretRef-managed but unresolved in this command path, the command prints a non-tokenized URL and explicit remediation guidance instead of embedding an invalid token placeholder.
+
+## Related
+
+- [CLI reference](/cli)
+- [Dashboard](/web/dashboard)
diff --git a/docs/cli/devices.md b/docs/cli/devices.md
index 8c5eb8e93ba..7a509cef493 100644
--- a/docs/cli/devices.md
+++ b/docs/cli/devices.md
@@ -178,3 +178,8 @@ Related:
 
 - [Dashboard auth troubleshooting](/web/dashboard#if-you-see-unauthorized-1008)
 - [Gateway troubleshooting](/gateway/troubleshooting#dashboard-control-ui-connectivity)
+
+## Related
+
+- [CLI reference](/cli)
+- [Nodes](/nodes)
diff --git a/docs/cli/directory.md b/docs/cli/directory.md
index c0e69bf3ce2..5bb7f8d2da0 100644
--- a/docs/cli/directory.md
+++ b/docs/cli/directory.md
@@ -61,3 +61,7 @@ openclaw directory groups list --channel zalouser
 openclaw directory groups list --channel zalouser --query "work"
 openclaw directory groups members --channel zalouser --group-id <id>
 ```
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/dns.md b/docs/cli/dns.md
index 56a4b05ab62..e551f74f4c1 100644
--- a/docs/cli/dns.md
+++ b/docs/cli/dns.md
@@ -46,3 +46,8 @@ Notes:
 - If `--domain` is omitted, OpenClaw uses `discovery.wideArea.domain` from config.
 - `--apply` currently supports macOS only and expects Homebrew CoreDNS.
 - `--apply` bootstraps the zone file if needed, ensures the CoreDNS import stanza exists, and restarts the `coredns` brew service.
+
+## Related
+
+- [CLI reference](/cli)
+- [Discovery](/gateway/discovery)
diff --git a/docs/cli/docs.md b/docs/cli/docs.md
index fc40c64e117..fd635f4152d 100644
--- a/docs/cli/docs.md
+++ b/docs/cli/docs.md
@@ -26,3 +26,7 @@ Notes:
 
 - With no query, `openclaw docs` opens the live docs search entrypoint.
 - Multi-word queries are passed through as one search request.
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/doctor.md b/docs/cli/doctor.md
index 54d9824c4c6..96fec5d619d 100644
--- a/docs/cli/doctor.md
+++ b/docs/cli/doctor.md
@@ -63,3 +63,8 @@ launchctl getenv OPENCLAW_GATEWAY_PASSWORD
 launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
 launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD
 ```
+
+## Related
+
+- [CLI reference](/cli)
+- [Gateway doctor](/gateway/doctor)
diff --git a/docs/cli/flows.md b/docs/cli/flows.md
index 65f3a89176c..e9bc8a201f7 100644
--- a/docs/cli/flows.md
+++ b/docs/cli/flows.md
@@ -16,3 +16,8 @@ openclaw tasks flow cancel <lookup>
 ```
 
 For full documentation see [Task Flow](/automation/taskflow) and the [tasks CLI reference](/cli/tasks).
+
+## Related
+
+- [CLI reference](/cli)
+- [Automation](/automation)
diff --git a/docs/cli/gateway.md b/docs/cli/gateway.md
index 65ce3e75fae..0a9e9e9c8eb 100644
--- a/docs/cli/gateway.md
+++ b/docs/cli/gateway.md
@@ -371,3 +371,8 @@ Notes:
 - On `local.` mDNS, `sshPort` and `cliPath` are only broadcast when
   `discovery.mdns.mode` is `full`. Wide-area DNS-SD still writes `cliPath`; `sshPort`
   stays optional there too.
+
+## Related
+
+- [CLI reference](/cli)
+- [Gateway runbook](/gateway)
diff --git a/docs/cli/health.md b/docs/cli/health.md
index 0525669b68a..722d1b1c2a1 100644
--- a/docs/cli/health.md
+++ b/docs/cli/health.md
@@ -34,3 +34,8 @@ Notes:
 - `--verbose` forces a live probe, prints gateway connection details, and expands the
   human-readable output across all configured accounts and agents.
 - Output includes per-agent session stores when multiple agents are configured.
+
+## Related
+
+- [CLI reference](/cli)
+- [Gateway health](/gateway/health)
diff --git a/docs/cli/logs.md b/docs/cli/logs.md
index 849f9d6c7e5..63acfb622f3 100644
--- a/docs/cli/logs.md
+++ b/docs/cli/logs.md
@@ -57,3 +57,8 @@ openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
 
 - Use `--local-time` to render timestamps in your local timezone.
 - If the local loopback Gateway asks for pairing, `openclaw logs` falls back to the configured local log file automatically. Explicit `--url` targets do not use this fallback.
+
+## Related
+
+- [CLI reference](/cli)
+- [Gateway logging](/gateway/logging)
diff --git a/docs/cli/memory.md b/docs/cli/memory.md
index a24a239295b..841a7c63952 100644
--- a/docs/cli/memory.md
+++ b/docs/cli/memory.md
@@ -174,3 +174,8 @@ Notes:
 - `memory rem-backfill --path <file-or-dir> --stage-short-term` also seeds grounded durable candidates into the live short-term promotion store so the normal deep phase can rank them.
 - `memory rem-backfill --rollback` removes previously written grounded diary entries, and `memory rem-backfill --rollback-short-term` removes previously staged grounded short-term candidates.
 - See [Dreaming](/concepts/dreaming) for full phase descriptions and configuration reference.
+
+## Related
+
+- [CLI reference](/cli)
+- [Memory overview](/concepts/memory)
diff --git a/docs/cli/message.md b/docs/cli/message.md
index 0dc35220ac4..2298b886c4e 100644
--- a/docs/cli/message.md
+++ b/docs/cli/message.md
@@ -296,3 +296,8 @@ Send a Telegram image as a document to avoid compression:
 openclaw message send --channel telegram --target @mychat \
   --media ./diagram.png --force-document
 ```
+
+## Related
+
+- [CLI reference](/cli)
+- [Agent send](/tools/agent-send)
diff --git a/docs/cli/node.md b/docs/cli/node.md
index 056c4133053..7db9937c55c 100644
--- a/docs/cli/node.md
+++ b/docs/cli/node.md
@@ -135,3 +135,8 @@ For approved async node exec, OpenClaw prepares a canonical `systemRunPlan`
 before prompting. The later approved `system.run` forward reuses that stored
 plan, so edits to command/cwd/session fields after the approval request was
 created are rejected instead of changing what the node executes.
+
+## Related
+
+- [CLI reference](/cli)
+- [Nodes](/nodes)
diff --git a/docs/cli/proxy.md b/docs/cli/proxy.md
index a800832d70c..8bb547ed5e7 100644
--- a/docs/cli/proxy.md
+++ b/docs/cli/proxy.md
@@ -43,3 +43,8 @@ openclaw proxy purge
 - `start` defaults to `127.0.0.1` unless `--host` is set.
 - `run` starts a local debug proxy and then runs the command after `--`.
 - Captures are local debugging data; use `openclaw proxy purge` when finished.
+
+## Related
+
+- [CLI reference](/cli)
+- [Trusted proxy auth](/gateway/trusted-proxy-auth)
diff --git a/docs/cli/qr.md b/docs/cli/qr.md
index 06e72d86e43..c043b01ee6e 100644
--- a/docs/cli/qr.md
+++ b/docs/cli/qr.md
@@ -50,3 +50,8 @@ openclaw qr --url wss://gateway.example/ws
 - After scanning, approve device pairing with:
   - `openclaw devices list`
   - `openclaw devices approve <requestId>`
+
+## Related
+
+- [CLI reference](/cli)
+- [Pairing](/cli/pairing)
diff --git a/docs/cli/reset.md b/docs/cli/reset.md
index a968eaad6df..fa29d0bfba8 100644
--- a/docs/cli/reset.md
+++ b/docs/cli/reset.md
@@ -33,3 +33,7 @@ Notes:
 - Run `openclaw backup create` first if you want a restorable snapshot before removing local state.
 - If you omit `--scope`, `openclaw reset` uses an interactive prompt to choose what to remove.
 - `--non-interactive` is only valid when both `--scope` and `--yes` are set.
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/secrets.md b/docs/cli/secrets.md
index e0e494ac57a..0636498c4ed 100644
--- a/docs/cli/secrets.md
+++ b/docs/cli/secrets.md
@@ -195,3 +195,8 @@ openclaw secrets audit --check
 ```
 
 If `audit --check` still reports plaintext findings, update the remaining reported target paths and rerun audit.
+
+## Related
+
+- [CLI reference](/cli)
+- [Secrets management](/gateway/secrets)
diff --git a/docs/cli/security.md b/docs/cli/security.md
index 28c29127958..d40c91ee4d9 100644
--- a/docs/cli/security.md
+++ b/docs/cli/security.md
@@ -84,3 +84,8 @@ openclaw security audit --fix --json | jq '{fix: .fix.ok, summary: .report.summa
 - disable tools (`gateway`, `cron`, `exec`, etc.)
 - change gateway bind/auth/network exposure choices
 - remove or rewrite plugins/skills
+
+## Related
+
+- [CLI reference](/cli)
+- [Security audit](/gateway/security)
diff --git a/docs/cli/setup.md b/docs/cli/setup.md
index 736f63227b6..2a0d6fc50d4 100644
--- a/docs/cli/setup.md
+++ b/docs/cli/setup.md
@@ -43,3 +43,8 @@ Notes:
 
 - Plain `openclaw setup` initializes config + workspace without the full onboarding flow.
 - Onboarding auto-runs when any onboarding flags are present (`--wizard`, `--non-interactive`, `--mode`, `--remote-url`, `--remote-token`).
+
+## Related
+
+- [CLI reference](/cli)
+- [Install overview](/install)
diff --git a/docs/cli/system.md b/docs/cli/system.md
index c5e24f21f4b..90b7956dda2 100644
--- a/docs/cli/system.md
+++ b/docs/cli/system.md
@@ -69,3 +69,7 @@ Flags:
 
 - Requires a running Gateway reachable by your current config (local or remote).
 - System events are ephemeral and not persisted across restarts.
+
+## Related
+
+- [CLI reference](/cli)
diff --git a/docs/cli/tasks.md b/docs/cli/tasks.md
index bf27c781ae9..fdc76d1bc3e 100644
--- a/docs/cli/tasks.md
+++ b/docs/cli/tasks.md
@@ -94,3 +94,8 @@ openclaw tasks flow cancel <lookup>
 ```
 
 Inspects or cancels durable Task Flow state under the task ledger.
+
+## Related
+
+- [CLI reference](/cli)
+- [Background tasks](/automation/tasks)
diff --git a/docs/cli/tui.md b/docs/cli/tui.md
index 45d5859fad7..c026d484fa8 100644
--- a/docs/cli/tui.md
+++ b/docs/cli/tui.md
@@ -65,3 +65,8 @@ Then inside the TUI:
 
 Apply targeted fixes with `openclaw config set` or `openclaw configure`, then
 rerun `openclaw config validate`. See [TUI](/web/tui) and [Config](/cli/config).
+
+## Related
+
+- [CLI reference](/cli)
+- [TUI](/web/tui)
diff --git a/docs/cli/uninstall.md b/docs/cli/uninstall.md
index 3a483e0c2b3..ea9dc823a60 100644
--- a/docs/cli/uninstall.md
+++ b/docs/cli/uninstall.md
@@ -37,3 +37,8 @@ Notes:
 - Run `openclaw backup create` first if you want a restorable snapshot before removing state or workspaces.
 - `--all` is shorthand for removing service, state, workspace, and app together.
 - `--non-interactive` requires `--yes`.
+
+## Related
+
+- [CLI reference](/cli)
+- [Uninstall](/install/uninstall)
diff --git a/docs/cli/voicecall.md b/docs/cli/voicecall.md
index 8d075e2a072..17afcb5ef70 100644
--- a/docs/cli/voicecall.md
+++ b/docs/cli/voicecall.md
@@ -33,3 +33,8 @@ openclaw voicecall expose --mode off
 ```
 
 Security note: only expose the webhook endpoint to networks you trust. Prefer Tailscale Serve over Funnel when possible.
+
+## Related
+
+- [CLI reference](/cli)
+- [Voice call plugin](/plugins/voice-call)
diff --git a/docs/cli/webhooks.md b/docs/cli/webhooks.md
index bf1257944c1..4d87ab61755 100644
--- a/docs/cli/webhooks.md
+++ b/docs/cli/webhooks.md
@@ -89,3 +89,8 @@ openclaw webhooks gmail run --account you@example.com
 ```
 
 See [Gmail Pub/Sub documentation](/automation/cron-jobs#gmail-pubsub-integration) for the end-to-end setup flow and operational details.
+
+## Related
+
+- [CLI reference](/cli)
+- [Webhook automation](/automation/webhook)
diff --git a/docs/cli/wiki.md b/docs/cli/wiki.md
index ac89d0cd2e6..5a25e8d3dfa 100644
--- a/docs/cli/wiki.md
+++ b/docs/cli/wiki.md
@@ -212,3 +212,8 @@ These require the official `obsidian` CLI on `PATH` when
 - `plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt`
 
 See [Memory Wiki plugin](/plugins/memory-wiki) for the full config model.
+
+## Related
+
+- [CLI reference](/cli)
+- [Memory wiki](/plugins/memory-wiki)
diff --git a/docs/gateway/background-process.md b/docs/gateway/background-process.md
index fcf0f7774d0..f5d42d78475 100644
--- a/docs/gateway/background-process.md
+++ b/docs/gateway/background-process.md
@@ -129,3 +129,8 @@ Paste literal text:
 ```json
 { "tool": "process", "action": "paste", "sessionId": "<id>", "text": "line1\nline2\n" }
 ```
+
+## Related
+
+- [Exec tool](/tools/exec)
+- [Exec approvals](/tools/exec-approvals)
diff --git a/docs/gateway/bridge-protocol.md b/docs/gateway/bridge-protocol.md
index cf82996bbf6..4c62fcf3411 100644
--- a/docs/gateway/bridge-protocol.md
+++ b/docs/gateway/bridge-protocol.md
@@ -87,3 +87,8 @@ Payload fields (all optional unless noted):
 The bridge was **implicit v1** (no min/max negotiation). This section is
 historical reference only; current node/operator clients use the WebSocket
 [Gateway Protocol](/gateway/protocol).
+
+## Related
+
+- [Gateway protocol](/gateway/protocol)
+- [Nodes](/nodes)
diff --git a/docs/gateway/cli-backends.md b/docs/gateway/cli-backends.md
index 796f908fc4c..d92a48ebee8 100644
--- a/docs/gateway/cli-backends.md
+++ b/docs/gateway/cli-backends.md
@@ -370,3 +370,8 @@ backend opts into bundle MCP so background runs stay isolated.
 - **No session continuity**: ensure `sessionArg` is set and `sessionMode` is not
   `none` (Codex CLI currently cannot resume with JSON output).
 - **Images ignored**: set `imageArg` (and verify CLI supports file paths).
+
+## Related
+
+- [Gateway runbook](/gateway)
+- [Local models](/gateway/local-models)
diff --git a/docs/gateway/logging.md b/docs/gateway/logging.md
index e9f59eae010..005ef554bc0 100644
--- a/docs/gateway/logging.md
+++ b/docs/gateway/logging.md
@@ -111,3 +111,8 @@ Behavior:
 - **WhatsApp message bodies** are logged at `debug` (use `--verbose` to see them)
 
 This keeps existing file logs stable while making interactive output scannable.
+
+## Related
+
+- [Logging overview](/logging)
+- [Diagnostics export](/gateway/diagnostics)
diff --git a/docs/gateway/openai-http-api.md b/docs/gateway/openai-http-api.md
index 57654543023..6fe7e7de172 100644
--- a/docs/gateway/openai-http-api.md
+++ b/docs/gateway/openai-http-api.md
@@ -278,3 +278,8 @@ Notes:
 - `openclaw/default` is always present so one stable id works across environments.
 - Backend provider/model overrides belong in `x-openclaw-model`, not the OpenAI `model` field.
 - `/v1/embeddings` supports `input` as a string or array of strings.
+
+## Related
+
+- [Configuration reference](/gateway/configuration-reference)
+- [OpenAI](/providers/openai)
diff --git a/docs/gateway/openresponses-http-api.md b/docs/gateway/openresponses-http-api.md
index 29a0c367ce1..c886879d8d2 100644
--- a/docs/gateway/openresponses-http-api.md
+++ b/docs/gateway/openresponses-http-api.md
@@ -338,3 +338,8 @@ curl -N http://127.0.0.1:18789/v1/responses \
     "input": "hi"
   }'
 ```
+
+## Related
+
+- [OpenAI chat completions](/gateway/openai-http-api)
+- [OpenAI](/providers/openai)
diff --git a/docs/gateway/remote-gateway-readme.md b/docs/gateway/remote-gateway-readme.md
index aafcfaaf952..8d0147d0d99 100644
--- a/docs/gateway/remote-gateway-readme.md
+++ b/docs/gateway/remote-gateway-readme.md
@@ -162,3 +162,8 @@ launchctl bootout gui/$UID/ai.openclaw.ssh-tunnel
 | `RunAtLoad`                          | Starts tunnel when the agent loads                           |
 
 OpenClaw.app connects to `ws://127.0.0.1:18789` on your client machine. The SSH tunnel forwards that connection to port 18789 on the remote machine where the Gateway is running.
+
+## Related
+
+- [Remote access](/gateway/remote)
+- [Tailscale](/gateway/tailscale)
diff --git a/docs/gateway/tools-invoke-http-api.md b/docs/gateway/tools-invoke-http-api.md
index 0a8f32500c6..0a677647fcb 100644
--- a/docs/gateway/tools-invoke-http-api.md
+++ b/docs/gateway/tools-invoke-http-api.md
@@ -159,3 +159,8 @@ curl -sS http://127.0.0.1:18789/tools/invoke \
     "args": {}
   }'
 ```
+
+## Related
+
+- [Gateway protocol](/gateway/protocol)
+- [Tools and plugins](/tools)
diff --git a/docs/help/debugging.md b/docs/help/debugging.md
index 630eb20efc2..85f75c8e8be 100644
--- a/docs/help/debugging.md
+++ b/docs/help/debugging.md
@@ -321,3 +321,8 @@ Default file:
 - Raw stream logs can include full prompts, tool output, and user data.
 - Keep logs local and delete them after debugging.
 - If you share logs, scrub secrets and PII first.
+
+## Related
+
+- [Troubleshooting](/help/troubleshooting)
+- [FAQ](/help/faq)
diff --git a/docs/help/faq.md b/docs/help/faq.md
index 79906512383..cc47353e37e 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -1967,3 +1967,9 @@ moved to a dedicated page:
 ---
 
 Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/openclaw/openclaw/discussions).
+
+## Related
+
+- [FAQ — quick start and first-run setup](/help/faq-first-run)
+- [FAQ — models and auth profiles](/help/faq-models)
+- [Troubleshooting](/help/troubleshooting)
diff --git a/docs/help/gpt54-codex-agentic-parity-maintainers.md b/docs/help/gpt54-codex-agentic-parity-maintainers.md
index 81506b8e191..6a776a9218b 100644
--- a/docs/help/gpt54-codex-agentic-parity-maintainers.md
+++ b/docs/help/gpt54-codex-agentic-parity-maintainers.md
@@ -168,3 +168,7 @@ The parity harness is not the only evidence source. Keep this split explicit in
 | `/elevated full` hints were sometimes misleading            | PR B ties guidance to actual runtime capability and blocked reasons                     |
 | Long tasks could disappear into replay/compaction ambiguity | PR C emits explicit paused, blocked, abandoned, and replay-invalid state                |
 | Parity claims were anecdotal                                | PR D produces a report plus JSON verdict with the same scenario coverage on both models |
+
+## Related
+
+- [GPT-5.4 / Codex agentic parity](/help/gpt54-codex-agentic-parity)
diff --git a/docs/help/gpt54-codex-agentic-parity.md b/docs/help/gpt54-codex-agentic-parity.md
index 3f134c358b5..3457aeadd25 100644
--- a/docs/help/gpt54-codex-agentic-parity.md
+++ b/docs/help/gpt54-codex-agentic-parity.md
@@ -226,3 +226,7 @@ Keep the default contract when:
 - you want the existing looser behavior
 - you are not using GPT-5-family models
 - you are testing prompts rather than runtime enforcement
+
+## Related
+
+- [GPT-5.4 / Codex parity maintainer notes](/help/gpt54-codex-agentic-parity-maintainers)
diff --git a/docs/help/scripts.md b/docs/help/scripts.md
index 5a31b2cf8ab..0eae3c06732 100644
--- a/docs/help/scripts.md
+++ b/docs/help/scripts.md
@@ -49,3 +49,8 @@ Examples:
 
 - Keep scripts focused and documented.
 - Add a short entry in the relevant doc (or create one if missing).
+
+## Related
+
+- [Testing](/help/testing)
+- [Testing live](/help/testing-live)
diff --git a/docs/help/testing.md b/docs/help/testing.md
index 4a83df9e00e..c103d0d2fff 100644
--- a/docs/help/testing.md
+++ b/docs/help/testing.md
@@ -699,3 +699,8 @@ When you fix a provider/model issue discovered in live:
 - SecretRef traversal guardrail:
   - `src/secrets/exec-secret-ref-id-parity.test.ts` derives one sampled target per SecretRef class from registry metadata (`listSecretTargetRegistryEntries()`), then asserts traversal-segment exec ids are rejected.
   - If you add a new `includeInPlan` SecretRef target family in `src/secrets/target-registry-data.ts`, update `classifyTargetClass` in that test. The test intentionally fails on unclassified target ids so new classes cannot be skipped silently.
+
+## Related
+
+- [Testing live](/help/testing-live)
+- [CI](/ci)
diff --git a/docs/refactor/qa.md b/docs/refactor/qa.md
index c0b6b90dab1..8eabedad117 100644
--- a/docs/refactor/qa.md
+++ b/docs/refactor/qa.md
@@ -534,3 +534,8 @@ This is the smallest path that proves both goals:
 - whether artifact references should be strongly typed in schema or string-based
 - whether custom handlers should live in one registry or per-surface registries
 - whether the generated JSON compatibility file should remain checked in during migration
+
+## Related
+
+- [QA E2E automation](/concepts/qa-e2e-automation)
+- [QA refactor](/refactor/qa-refactor)
diff --git a/docs/start/docs-directory.md b/docs/start/docs-directory.md
index 346901ccdcc..6195ee8725f 100644
--- a/docs/start/docs-directory.md
+++ b/docs/start/docs-directory.md
@@ -63,3 +63,8 @@ For a complete map of the docs, see [Docs hubs](/start/hubs).
 - [Gmail hooks (Pub/Sub)](/automation/cron-jobs#gmail-pubsub-integration)
 - [Security](/gateway/security)
 - [Troubleshooting](/gateway/troubleshooting)
+
+## Related
+
+- [Getting started](/start/getting-started)
+- [Docs hubs](/start/hubs)
diff --git a/docs/start/getting-started.md b/docs/start/getting-started.md
index efaa2abb20f..dade1aa176e 100644
--- a/docs/start/getting-started.md
+++ b/docs/start/getting-started.md
@@ -144,3 +144,9 @@ openclaw dashboard
 
 Full reference: [Environment variables](/help/environment).
 </Accordion>
+
+## Related
+
+- [Install overview](/install)
+- [Channels overview](/channels)
+- [Setup](/start/setup)
diff --git a/docs/start/onboarding.md b/docs/start/onboarding.md
index d468134c880..db1871a38a4 100644
--- a/docs/start/onboarding.md
+++ b/docs/start/onboarding.md
@@ -88,3 +88,8 @@ Onboarding requests TCC permissions needed for:
   what happens on the gateway host during the first agent run.
 </Step>
 </Steps>
+
+## Related
+
+- [Onboarding overview](/start/onboarding-overview)
+- [Getting started](/start/getting-started)