docs(providers): standardize Related card titles, config-reference links, and Advanced heading

2026-05-06 10:30:44 +00:00 · 2026-04-23 13:16:45 -07:00
parent f6336c5521
commit 82a847f3b4
26 changed files with 31 additions and 31 deletions
--- 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">
--- 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">
--- 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">
--- 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>
--- 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">
--- 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">
--- 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>
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">