docs(concepts,automation,plugins): add Related sections to pages missing them

2026-04-30 22:12:32 +08:00 · 2026-04-23 15:48:40 -07:00
parent 6259f6addc
commit 367b9721b6
34 changed files with 190 additions and 0 deletions
--- a/docs/automation/auth-monitoring.md
+++ b/docs/automation/auth-monitoring.md
@@ -4,3 +4,8 @@ title: "Auth monitoring"
 ---

 This page moved to [Authentication](/gateway/authentication). See [Authentication](/gateway/authentication) for auth monitoring documentation.
+
+## Related
+
+- [Automation troubleshooting](/automation/troubleshooting)
+- [Hooks](/automation/hooks)
--- a/docs/automation/clawflow.md
+++ b/docs/automation/clawflow.md
@@ -4,3 +4,9 @@ title: "ClawFlow"
 ---

 ClawFlow was renamed to [Task Flow](/automation/taskflow). See [Task Flow](/automation/taskflow) for the current documentation.
+
+## Related
+
+- [Task flow](/automation/taskflow)
+- [Standing orders](/automation/standing-orders)
+- [Hooks](/automation/hooks)
--- a/docs/automation/cron-vs-heartbeat.md
+++ b/docs/automation/cron-vs-heartbeat.md
@@ -4,3 +4,8 @@ title: "Cron vs heartbeat"
 ---

 This page moved to [Automation & Tasks](/automation). See [Automation & Tasks](/automation) for the decision guide comparing cron and heartbeat.
+
+## Related
+
+- [Scheduled tasks](/automation/cron-jobs)
+- [Background tasks](/automation/tasks)
--- a/docs/automation/gmail-pubsub.md
+++ b/docs/automation/gmail-pubsub.md
@@ -4,3 +4,8 @@ title: "Gmail PubSub"
 ---

 This page moved to [Scheduled Tasks](/automation/cron-jobs#gmail-pubsub-integration). See [Scheduled Tasks](/automation/cron-jobs#gmail-pubsub-integration) for Gmail PubSub documentation.
+
+## Related
+
+- [Webhook](/automation/webhook)
+- [Automation troubleshooting](/automation/troubleshooting)
--- a/docs/automation/poll.md
+++ b/docs/automation/poll.md
@@ -4,3 +4,9 @@ title: "Polls"
 ---

 This page moved to [Message tool](/cli/message). See [Message tool](/cli/message) for poll documentation.
+
+## Related
+
+- [Webhook](/automation/webhook)
+- [Scheduled tasks](/automation/cron-jobs)
+- [Background tasks](/automation/tasks)
--- a/docs/automation/troubleshooting.md
+++ b/docs/automation/troubleshooting.md
@@ -4,3 +4,9 @@ title: "Automation troubleshooting"
 ---

 This page moved to [Scheduled Tasks](/automation/cron-jobs#troubleshooting). See [Scheduled Tasks](/automation/cron-jobs#troubleshooting) for troubleshooting documentation.
+
+## Related
+
+- [Hooks](/automation/hooks)
+- [Background tasks](/automation/tasks)
+- [Gateway troubleshooting](/gateway/troubleshooting)
--- a/docs/automation/webhook.md
+++ b/docs/automation/webhook.md
@@ -4,3 +4,9 @@ title: "Webhooks"
 ---

 This page moved to [Scheduled Tasks](/automation/cron-jobs#webhooks). See [Scheduled Tasks](/automation/cron-jobs#webhooks) for webhook documentation.
+
+## Related
+
+- [Poll](/automation/poll)
+- [Gmail PubSub](/automation/gmail-pubsub)
+- [Hooks](/automation/hooks)
--- a/docs/concepts/agent.md
+++ b/docs/concepts/agent.md
@@ -125,3 +125,9 @@ At minimum, set:
 ---

 _Next: [Group Chats](/channels/group-messages)_ 🦞
+
+## Related
+
+- [Agent workspace](/concepts/agent-workspace)
+- [Multi-agent routing](/concepts/multi-agent)
+- [Session management](/concepts/session)
--- a/docs/concepts/delegate-architecture.md
+++ b/docs/concepts/delegate-architecture.md
@@ -303,3 +303,9 @@ The delegate model works for any small organization:
 6. **Review and adjust** the capability tier as trust builds.

 Multiple organizations can share one Gateway server using multi-agent routing — each org gets its own isolated agent, workspace, and credentials.
+
+## Related
+
+- [Agent runtime](/concepts/agent)
+- [Sub-agents](/tools/subagents)
+- [Multi-agent routing](/concepts/multi-agent)
--- a/docs/concepts/experimental-features.md
+++ b/docs/concepts/experimental-features.md
@@ -43,3 +43,8 @@ If a feature is experimental, OpenClaw should say so plainly in docs and in the
 config path itself. What it should **not** do is smuggle preview behavior into a
 stable-looking default knob and pretend that is normal. That's how config
 surfaces get messy.
+
+## Related
+
+- [Features](/concepts/features)
+- [Release channels](/install/development-channels)
--- a/docs/concepts/features.md
+++ b/docs/concepts/features.md
@@ -72,3 +72,8 @@ title: "Features"
 - Web search (Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG, Tavily)
 - Cron jobs and heartbeat scheduling
 - Skills, plugins, and workflow pipelines (Lobster)
+
+## Related
+
+- [Experimental features](/concepts/experimental-features)
+- [Agent runtime](/concepts/agent)
--- a/docs/concepts/markdown-formatting.md
+++ b/docs/concepts/markdown-formatting.md
@@ -126,3 +126,8 @@ SPOILER style ranges. Other channels treat them as plain text.
 - Signal style ranges depend on UTF-16 offsets; do not use code point offsets.
 - Preserve trailing newlines for fenced code blocks so closing markers land on
  their own line.
+
+## Related
+
+- [Streaming and chunking](/concepts/streaming)
+- [System prompt](/concepts/system-prompt)
--- a/docs/concepts/memory-builtin.md
+++ b/docs/concepts/memory-builtin.md
@@ -101,3 +101,9 @@ For embedding provider setup, hybrid search tuning (weights, MMR, temporal
 decay), batch indexing, multimodal memory, sqlite-vec, extra paths, and all
 other config knobs, see the
 [Memory configuration reference](/reference/memory-config).
+
+## Related
+
+- [Memory overview](/concepts/memory)
+- [Memory search](/concepts/memory-search)
+- [Active memory](/concepts/active-memory)
--- a/docs/concepts/memory-honcho.md
+++ b/docs/concepts/memory-honcho.md
@@ -136,3 +136,9 @@ openclaw honcho search <query> [-k N] [-d D] # Semantic search over memory
 - [Honcho OpenClaw integration guide](https://docs.honcho.dev/v3/guides/integrations/openclaw)
 - [Memory](/concepts/memory) -- OpenClaw memory overview
 - [Context Engines](/concepts/context-engine) -- how plugin context engines work
+
+## Related
+
+- [Memory overview](/concepts/memory)
+- [Builtin memory engine](/concepts/memory-builtin)
+- [QMD memory engine](/concepts/memory-qmd)
--- a/docs/concepts/memory-qmd.md
+++ b/docs/concepts/memory-qmd.md
@@ -185,3 +185,9 @@ cycle-safe traversal or explicit exclusion controls.
 For the full config surface (`memory.qmd.*`), search modes, update intervals,
 scope rules, and all other knobs, see the
 [Memory configuration reference](/reference/memory-config).
+
+## Related
+
+- [Memory overview](/concepts/memory)
+- [Builtin memory engine](/concepts/memory-builtin)
+- [Honcho memory](/concepts/memory-honcho)
--- a/docs/concepts/memory-search.md
+++ b/docs/concepts/memory-search.md
@@ -143,3 +143,9 @@ earlier conversations. This is opt-in via
 - [Active Memory](/concepts/active-memory) -- sub-agent memory for interactive chat sessions
 - [Memory](/concepts/memory) -- file layout, backends, tools
 - [Memory configuration reference](/reference/memory-config) -- all config knobs
+
+## Related
+
+- [Memory overview](/concepts/memory)
+- [Active memory](/concepts/active-memory)
+- [Builtin memory engine](/concepts/memory-builtin)
--- a/docs/concepts/memory.md
+++ b/docs/concepts/memory.md
@@ -186,3 +186,10 @@ openclaw memory index --force   # Rebuild the index
  from short-term recall to long-term memory
 - [Memory configuration reference](/reference/memory-config) -- all config knobs
 - [Compaction](/concepts/compaction) -- how compaction interacts with memory
+
+## Related
+
+- [Active memory](/concepts/active-memory)
+- [Memory search](/concepts/memory-search)
+- [Builtin memory engine](/concepts/memory-builtin)
+- [Honcho memory](/concepts/memory-honcho)
--- a/docs/concepts/presence.md
+++ b/docs/concepts/presence.md
@@ -98,3 +98,8 @@ indicator (Active/Idle/Stale) based on the age of the last update.
  - confirm clients send a stable `client.instanceId` in the handshake
  - confirm periodic beacons use the same `instanceId`
  - check whether the connection‑derived entry is missing `instanceId` (duplicates are expected)
+
+## Related
+
+- [Typing indicators](/concepts/typing-indicators)
+- [Streaming and chunking](/concepts/streaming)
--- a/docs/concepts/queue.md
+++ b/docs/concepts/queue.md
@@ -87,3 +87,8 @@ Defaults: `debounceMs: 1000`, `cap: 20`, `drop: summarize`.

 - If commands seem stuck, enable verbose logs and look for “queued for …ms” lines to confirm the queue is draining.
 - If you need queue depth, enable verbose logs and watch for queue timing lines.
+
+## Related
+
+- [Session management](/concepts/session)
+- [Retry policy](/concepts/retry)
--- a/docs/concepts/retry.md
+++ b/docs/concepts/retry.md
@@ -77,3 +77,8 @@ Set retry policy per provider in `~/.openclaw/openclaw.json`:

 - Retries apply per request (message send, media upload, reaction, poll, sticker).
 - Composite flows do not retry completed steps.
+
+## Related
+
+- [Model failover](/concepts/model-failover)
+- [Command queue](/concepts/queue)
--- a/docs/concepts/session-pruning.md
+++ b/docs/concepts/session-pruning.md
@@ -88,3 +88,9 @@ compaction cycles.
 - [Compaction](/concepts/compaction) -- summarization-based context reduction
 - [Gateway Configuration](/gateway/configuration) -- all pruning config knobs
  (`contextPruning.*`)
+
+## Related
+
+- [Session management](/concepts/session)
+- [Session tools](/concepts/session-tool)
+- [Context engine](/concepts/context-engine)
--- a/docs/concepts/session-tool.md
+++ b/docs/concepts/session-tool.md
@@ -145,3 +145,8 @@ config.
 - [ACP Agents](/tools/acp-agents) -- external harness spawning
 - [Multi-agent](/concepts/multi-agent) -- multi-agent architecture
 - [Gateway Configuration](/gateway/configuration) -- session tool config knobs
+
+## Related
+
+- [Session management](/concepts/session)
+- [Session pruning](/concepts/session-pruning)
--- a/docs/concepts/session.md
+++ b/docs/concepts/session.md
@@ -116,3 +116,9 @@ Preview with `openclaw sessions cleanup --dry-run`.
 - [Multi-Agent](/concepts/multi-agent) — routing and session isolation across agents
 - [Background Tasks](/automation/tasks) — how detached work creates task records with session references
 - [Channel Routing](/channels/channel-routing) — how inbound messages are routed to sessions
+
+## Related
+
+- [Session pruning](/concepts/session-pruning)
+- [Session tools](/concepts/session-tool)
+- [Command queue](/concepts/queue)
--- a/docs/concepts/system-prompt.md
+++ b/docs/concepts/system-prompt.md
@@ -204,3 +204,9 @@ package docs) and also notes the public mirror, source repo, community Discord,
 ClawHub ([https://clawhub.ai](https://clawhub.ai)) for skills discovery. The prompt instructs the model to consult local docs first
 for OpenClaw behavior, commands, configuration, or architecture, and to run
 `openclaw status` itself when possible (asking the user only when it lacks access).
+
+## Related
+
+- [Agent runtime](/concepts/agent)
+- [Agent workspace](/concepts/agent-workspace)
+- [Context engine](/concepts/context-engine)
--- a/docs/concepts/typebox.md
+++ b/docs/concepts/typebox.md
@@ -305,3 +305,8 @@ published raw file is typically available at:
   node scope classification.
 4. Run `pnpm protocol:check`.
 5. Commit the regenerated schema + Swift models.
+
+## Related
+
+- [Rich output protocol](/reference/rich-output-protocol)
+- [RPC adapters](/reference/rpc-adapters)
--- a/docs/concepts/typing-indicators.md
+++ b/docs/concepts/typing-indicators.md
@@ -71,3 +71,8 @@ You can override mode or cadence per session:
  channel does not support typing.
 - `typingIntervalSeconds` controls the **refresh cadence**, not the start time.
  The default is 6 seconds.
+
+## Related
+
+- [Presence](/concepts/presence)
+- [Streaming and chunking](/concepts/streaming)
--- a/docs/concepts/usage-tracking.md
+++ b/docs/concepts/usage-tracking.md
@@ -55,3 +55,9 @@ Usage is hidden when no usable provider usage auth can be resolved. Providers
 can supply plugin-specific usage auth logic; otherwise OpenClaw falls back to
 matching OAuth/API-key credentials from auth profiles, environment variables,
 or config.
+
+## Related
+
+- [Token use and costs](/reference/token-use)
+- [API usage and costs](/reference/api-usage-costs)
+- [Prompt caching](/reference/prompt-caching)
--- a/docs/plugins/agent-tools.md
+++ b/docs/plugins/agent-tools.md
@@ -8,3 +8,8 @@ title: "Registering tools"
 # Registering Tools in Plugins

 This page has moved. See [Building Plugins: Registering agent tools](/plugins/building-plugins#registering-agent-tools).
+
+## Related
+
+- [Building plugins](/plugins/building-plugins)
+- [Plugin SDK setup](/plugins/sdk-setup)
--- a/docs/plugins/architecture.md
+++ b/docs/plugins/architecture.md
@@ -1517,3 +1517,9 @@ That keeps the rule simple:
 - vendor plugins own vendor implementations
 - feature/channel plugins consume runtime helpers
 - contract tests keep ownership explicit
+
+## Related
+
+- [Building plugins](/plugins/building-plugins)
+- [Plugin SDK setup](/plugins/sdk-setup)
+- [Plugin manifest](/plugins/manifest)
--- a/docs/plugins/building-extensions.md
+++ b/docs/plugins/building-extensions.md
@@ -6,3 +6,8 @@ read_when:
 ---

 This page has moved to [Building Plugins](/plugins/building-plugins).
+
+## Related
+
+- [Building plugins](/plugins/building-plugins)
+- [Plugin architecture](/plugins/architecture)
--- a/docs/plugins/sdk-channel-plugins.md
+++ b/docs/plugins/sdk-channel-plugins.md
@@ -652,3 +652,9 @@ surface unless you are maintaining that bundled plugin family directly.
 - [SDK Overview](/plugins/sdk-overview) — full subpath import reference
 - [SDK Testing](/plugins/sdk-testing) — test utilities and contract tests
 - [Plugin Manifest](/plugins/manifest) — full manifest schema
+
+## Related
+
+- [Plugin SDK setup](/plugins/sdk-setup)
+- [Building plugins](/plugins/building-plugins)
+- [Agent harness plugins](/plugins/sdk-agent-harness)
--- a/docs/plugins/sdk-provider-plugins.md
+++ b/docs/plugins/sdk-provider-plugins.md
@@ -718,3 +718,9 @@ providers:
 - [SDK Runtime](/plugins/sdk-runtime) — `api.runtime` helpers (TTS, search, subagent)
 - [SDK Overview](/plugins/sdk-overview) — full subpath import reference
 - [Plugin Internals](/plugins/architecture#provider-runtime-hooks) — hook details and bundled examples
+
+## Related
+
+- [Plugin SDK setup](/plugins/sdk-setup)
+- [Building plugins](/plugins/building-plugins)
+- [Building channel plugins](/plugins/sdk-channel-plugins)
--- a/docs/plugins/voice-call.md
+++ b/docs/plugins/voice-call.md
@@ -501,3 +501,9 @@ This repo ships a matching skill doc at `skills/voice-call/SKILL.md`.
 - `voicecall.speak` (`callId`, `message`)
 - `voicecall.end` (`callId`)
 - `voicecall.status` (`callId`)
+
+## Related
+
+- [Text-to-speech](/tools/tts)
+- [Talk mode](/nodes/talk)
+- [Voice wake](/nodes/voicewake)
--- a/docs/plugins/zalouser.md
+++ b/docs/plugins/zalouser.md
@@ -76,3 +76,8 @@ Tool name: `zalouser`
 Actions: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`

 Channel message actions also support `react` for message reactions.
+
+## Related
+
+- [Building plugins](/plugins/building-plugins)
+- [Community plugins](/plugins/community)