From 82a847f3b4f1cc72da9ac916fac079e01e01b559 Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Thu, 23 Apr 2026 13:16:45 -0700
Subject: [PATCH] docs(providers): standardize Related card titles,
 config-reference links, and Advanced heading

---
 docs/providers/bedrock-mantle.md       | 2 +-
 docs/providers/chutes.md               | 2 +-
 docs/providers/claude-max-api-proxy.md | 4 ++--
 docs/providers/comfy.md                | 2 +-
 docs/providers/glm.md                  | 2 +-
 docs/providers/huggingface.md          | 4 ++--
 docs/providers/inferrs.md              | 4 ++--
 docs/providers/kilocode.md             | 2 +-
 docs/providers/litellm.md              | 4 ++--
 docs/providers/moonshot.md             | 2 +-
 docs/providers/nvidia.md               | 2 +-
 docs/providers/ollama.md               | 2 +-
 docs/providers/opencode-go.md          | 2 +-
 docs/providers/opencode.md             | 2 +-
 docs/providers/openrouter.md           | 2 +-
 docs/providers/perplexity-provider.md  | 2 +-
 docs/providers/qianfan.md              | 2 +-
 docs/providers/qwen.md                 | 2 +-
 docs/providers/runway.md               | 2 +-
 docs/providers/stepfun.md              | 4 ++--
 docs/providers/synthetic.md            | 2 +-
 docs/providers/together.md             | 2 +-
 docs/providers/vercel-ai-gateway.md    | 2 +-
 docs/providers/vllm.md                 | 2 +-
 docs/providers/volcengine.md           | 2 +-
 docs/providers/xiaomi.md               | 2 +-
 26 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/docs/providers/bedrock-mantle.md b/docs/providers/bedrock-mantle.md
index e125b56993a..e4ff1f3a400 100644
--- a/docs/providers/bedrock-mantle.md
+++ b/docs/providers/bedrock-mantle.md
@@ -130,7 +130,7 @@ If you prefer explicit config instead of auto-discovery:
 }
 ```
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Reasoning support">
diff --git a/docs/providers/chutes.md b/docs/providers/chutes.md
index 726a59b030f..ff9732a7e82 100644
--- a/docs/providers/chutes.md
+++ b/docs/providers/chutes.md
@@ -137,7 +137,7 @@ The bundled fallback catalog includes current Chutes refs:
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Provider rules, model refs, and failover behavior.
   </Card>
   <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
diff --git a/docs/providers/claude-max-api-proxy.md b/docs/providers/claude-max-api-proxy.md
index 6d22a1e3d72..6386c45cab5 100644
--- a/docs/providers/claude-max-api-proxy.md
+++ b/docs/providers/claude-max-api-proxy.md
@@ -103,7 +103,7 @@ The proxy:
 | `claude-sonnet-4` | Claude Sonnet 4 |
 | `claude-haiku-4`  | Claude Haiku 4  |
 
-## Advanced
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Proxy-style OpenAI-compatible notes">
@@ -179,7 +179,7 @@ For native Anthropic integration with Claude CLI or API keys, see [Anthropic pro
   <Card title="OpenAI provider" href="/providers/openai" icon="robot">
     For OpenAI/Codex subscriptions.
   </Card>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
   <Card title="Configuration" href="/gateway/configuration" icon="gear">
diff --git a/docs/providers/comfy.md b/docs/providers/comfy.md
index 624b9b25844..7cbd5df13bf 100644
--- a/docs/providers/comfy.md
+++ b/docs/providers/comfy.md
@@ -346,7 +346,7 @@ The `image` and `video` sections also support:
   <Card title="Provider Directory" href="/providers/index" icon="layers">
     Overview of all providers and model refs.
   </Card>
-  <Card title="Configuration Reference" href="/gateway/configuration-reference#agent-defaults" icon="gear">
+  <Card title="Configuration reference" href="/gateway/configuration-reference#agent-defaults" icon="gear">
     Full config reference including agent defaults.
   </Card>
 </CardGroup>
diff --git a/docs/providers/glm.md b/docs/providers/glm.md
index da09328543e..db0ac4985c1 100644
--- a/docs/providers/glm.md
+++ b/docs/providers/glm.md
@@ -81,7 +81,7 @@ The default bundled model ref is `zai/glm-5.1`. GLM versions and availability
 can change; check Z.AI's docs for the latest.
 </Note>
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Endpoint auto-detection">
diff --git a/docs/providers/huggingface.md b/docs/providers/huggingface.md
index 994e2d093a1..63600402083 100644
--- a/docs/providers/huggingface.md
+++ b/docs/providers/huggingface.md
@@ -87,7 +87,7 @@ Model refs use the form `huggingface/<org>/<model>` (Hub-style IDs). The list be
 You can append `:fastest` or `:cheapest` to any model id. Set your default order in [Inference Provider settings](https://hf.co/settings/inference-providers); see [Inference Providers](https://huggingface.co/docs/inference-providers) and **GET** `https://router.huggingface.co/v1/models` for the full list.
 </Tip>
 
-## Advanced details
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Model discovery and onboarding dropdown">
@@ -220,7 +220,7 @@ You can append `:fastest` or `:cheapest` to any model id. Set your default order
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
   <Card title="Model selection" href="/concepts/models" icon="brain">
diff --git a/docs/providers/inferrs.md b/docs/providers/inferrs.md
index efd0de067e3..89c85ac898e 100644
--- a/docs/providers/inferrs.md
+++ b/docs/providers/inferrs.md
@@ -79,7 +79,7 @@ This example uses Gemma 4 on a local `inferrs` server.
 }
 ```
 
-## Advanced
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Why requiresStringContent matters">
@@ -202,7 +202,7 @@ For general help, see [Troubleshooting](/help/troubleshooting) and [FAQ](/help/f
   <Card title="Gateway troubleshooting" href="/gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail" icon="wrench">
     Debugging local OpenAI-compatible backends that pass probes but fail agent runs.
   </Card>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
 </CardGroup>
diff --git a/docs/providers/kilocode.md b/docs/providers/kilocode.md
index 54e22e74ec6..153b3b81a0b 100644
--- a/docs/providers/kilocode.md
+++ b/docs/providers/kilocode.md
@@ -127,7 +127,7 @@ includes `kilocode/kilo/auto` (`Kilo Auto`) with `input: ["text", "image"]`,
   <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Choosing providers, model refs, and failover behavior.
   </Card>
-  <Card title="Configuration reference" href="/gateway/configuration" icon="gear">
+  <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
     Full OpenClaw configuration reference.
   </Card>
   <Card title="Kilo Gateway" href="https://app.kilo.ai" icon="arrow-up-right-from-square">
diff --git a/docs/providers/litellm.md b/docs/providers/litellm.md
index bcc3bb09031..8360e660a33 100644
--- a/docs/providers/litellm.md
+++ b/docs/providers/litellm.md
@@ -106,7 +106,7 @@ export LITELLM_API_KEY="sk-litellm-key"
 }
 ```
 
-## Advanced topics
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Virtual keys">
@@ -184,7 +184,7 @@ For general provider configuration and failover behavior, see [Model Providers](
   <Card title="LiteLLM Docs" href="https://docs.litellm.ai" icon="book">
     Official LiteLLM documentation and API reference.
   </Card>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
   <Card title="Configuration" href="/gateway/configuration" icon="gear">
diff --git a/docs/providers/moonshot.md b/docs/providers/moonshot.md
index d153ae8f8b2..f05abce4870 100644
--- a/docs/providers/moonshot.md
+++ b/docs/providers/moonshot.md
@@ -286,7 +286,7 @@ Config lives under `plugins.entries.moonshot.config.webSearch`:
 }
 ```
 
-## Advanced
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Native thinking mode">
diff --git a/docs/providers/nvidia.md b/docs/providers/nvidia.md
index 3cf7c1e4798..25326f1aed7 100644
--- a/docs/providers/nvidia.md
+++ b/docs/providers/nvidia.md
@@ -64,7 +64,7 @@ If you pass `--token` instead of the env var, the value lands in shell history a
 | `nvidia/minimaxai/minimax-m2.5`            | Minimax M2.5                 | 196,608 | 8,192      |
 | `nvidia/z-ai/glm5`                         | GLM 5                        | 202,752 | 8,192      |
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Auto-enable behavior">
diff --git a/docs/providers/ollama.md b/docs/providers/ollama.md
index e511ba546e9..7ceb6a0ae5b 100644
--- a/docs/providers/ollama.md
+++ b/docs/providers/ollama.md
@@ -521,7 +521,7 @@ More help: [Troubleshooting](/help/troubleshooting) and [FAQ](/help/faq).
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
   <Card title="Model selection" href="/concepts/models" icon="brain">
diff --git a/docs/providers/opencode-go.md b/docs/providers/opencode-go.md
index d13df374c5f..cadec2ca76f 100644
--- a/docs/providers/opencode-go.md
+++ b/docs/providers/opencode-go.md
@@ -84,7 +84,7 @@ As of the bundled pi catalog, the provider includes:
 }
 ```
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Routing behavior">
diff --git a/docs/providers/opencode.md b/docs/providers/opencode.md
index fa63b8e95de..95fe54dd84d 100644
--- a/docs/providers/opencode.md
+++ b/docs/providers/opencode.md
@@ -104,7 +104,7 @@ as one OpenCode setup.
 | Runtime provider | `opencode-go`                                                            |
 | Example models   | `opencode-go/kimi-k2.5`, `opencode-go/glm-5`, `opencode-go/minimax-m2.5` |
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="API key aliases">
diff --git a/docs/providers/openrouter.md b/docs/providers/openrouter.md
index 9136a357408..907e6747ad8 100644
--- a/docs/providers/openrouter.md
+++ b/docs/providers/openrouter.md
@@ -77,7 +77,7 @@ If you repoint the OpenRouter provider at some other proxy or base URL, OpenClaw
 does **not** inject those OpenRouter-specific headers or Anthropic cache markers.
 </Warning>
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Anthropic cache markers">
diff --git a/docs/providers/perplexity-provider.md b/docs/providers/perplexity-provider.md
index ecb5a3fe341..825bbc7d269 100644
--- a/docs/providers/perplexity-provider.md
+++ b/docs/providers/perplexity-provider.md
@@ -84,7 +84,7 @@ When using the native Perplexity API, searches support the following filters:
 | Domain filters | Allowlist or denylist (max 20 domains) | `example.com`                       |
 | Content budget | Token limits per response / per page   | `max_tokens`, `max_tokens_per_page` |
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Environment variable for daemon processes">
diff --git a/docs/providers/qianfan.md b/docs/providers/qianfan.md
index cc77fc85b47..062abd33246 100644
--- a/docs/providers/qianfan.md
+++ b/docs/providers/qianfan.md
@@ -119,7 +119,7 @@ The default bundled model ref is `qianfan/deepseek-v3.2`. You only need to overr
   <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Choosing providers, model refs, and failover behavior.
   </Card>
-  <Card title="Configuration reference" href="/gateway/configuration" icon="gear">
+  <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
     Full OpenClaw configuration reference.
   </Card>
   <Card title="Agent setup" href="/concepts/agent" icon="robot">
diff --git a/docs/providers/qwen.md b/docs/providers/qwen.md
index bcb22945143..beea2510e01 100644
--- a/docs/providers/qwen.md
+++ b/docs/providers/qwen.md
@@ -193,7 +193,7 @@ To use Qwen as the default video provider:
 See [Video Generation](/tools/video-generation) for shared tool parameters, provider selection, and failover behavior.
 </Note>
 
-## Advanced
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Image and video understanding">
diff --git a/docs/providers/runway.md b/docs/providers/runway.md
index 3189dd47543..b93b7228ac6 100644
--- a/docs/providers/runway.md
+++ b/docs/providers/runway.md
@@ -64,7 +64,7 @@ Video-to-video currently requires `runway/gen4_aleph` specifically.
 }
 ```
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Environment variable aliases">
diff --git a/docs/providers/stepfun.md b/docs/providers/stepfun.md
index fcdb963439e..087a1811968 100644
--- a/docs/providers/stepfun.md
+++ b/docs/providers/stepfun.md
@@ -126,7 +126,7 @@ Choose your provider surface and follow the setup steps.
   </Tab>
 </Tabs>
 
-## Advanced
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Full config: Standard provider">
@@ -213,7 +213,7 @@ For the broader provider overview, see [Model providers](/concepts/model-provide
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Overview of all providers, model refs, and failover behavior.
   </Card>
   <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
diff --git a/docs/providers/synthetic.md b/docs/providers/synthetic.md
index ed7b33167ea..a62751caffa 100644
--- a/docs/providers/synthetic.md
+++ b/docs/providers/synthetic.md
@@ -142,7 +142,7 @@ account.
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Provider rules, model refs, and failover behavior.
   </Card>
   <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
diff --git a/docs/providers/together.md b/docs/providers/together.md
index ea3505cb029..f963d682e9f 100644
--- a/docs/providers/together.md
+++ b/docs/providers/together.md
@@ -125,7 +125,7 @@ provider selection, and failover behavior.
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Model providers" href="/concepts/model-providers" icon="layers">
+  <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Provider rules, model refs, and failover behavior.
   </Card>
   <Card title="Video generation" href="/tools/video-generation" icon="video">
diff --git a/docs/providers/vercel-ai-gateway.md b/docs/providers/vercel-ai-gateway.md
index 33c95b73b61..7566aa75f77 100644
--- a/docs/providers/vercel-ai-gateway.md
+++ b/docs/providers/vercel-ai-gateway.md
@@ -81,7 +81,7 @@ You can use either the shorthand or the fully qualified model ref in your
 configuration. OpenClaw resolves the canonical form automatically.
 </Tip>
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Environment variable for daemon processes">
diff --git a/docs/providers/vllm.md b/docs/providers/vllm.md
index 949eade18f9..12330d6baa7 100644
--- a/docs/providers/vllm.md
+++ b/docs/providers/vllm.md
@@ -108,7 +108,7 @@ Use explicit config when:
 }
 ```
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Proxy-style behavior">
diff --git a/docs/providers/volcengine.md b/docs/providers/volcengine.md
index 0f80c902b0e..7a2a1a17745 100644
--- a/docs/providers/volcengine.md
+++ b/docs/providers/volcengine.md
@@ -95,7 +95,7 @@ Both providers are configured from a single API key. Setup registers both automa
   </Tab>
 </Tabs>
 
-## Advanced notes
+## Advanced configuration
 
 <AccordionGroup>
   <Accordion title="Default model after onboarding">
diff --git a/docs/providers/xiaomi.md b/docs/providers/xiaomi.md
index 85e4a30956d..9b2c7733496 100644
--- a/docs/providers/xiaomi.md
+++ b/docs/providers/xiaomi.md
@@ -134,7 +134,7 @@ The default model ref is `xiaomi/mimo-v2-flash`. The provider is injected automa
   <Card title="Model selection" href="/concepts/model-providers" icon="layers">
     Choosing providers, model refs, and failover behavior.
   </Card>
-  <Card title="Configuration reference" href="/gateway/configuration" icon="gear">
+  <Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
     Full OpenClaw configuration reference.
   </Card>
   <Card title="Xiaomi MiMo console" href="https://platform.xiaomimimo.com" icon="arrow-up-right-from-square">