From 8240b00e7e240bdd1509ce49d7697ac2e043cac5 Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Tue, 28 Apr 2026 07:38:11 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@1dd011984a318b25824e1cb1aff1fecb5a3e67d9

---
 .openclaw-sync/source.json                    |  4 ++--
 docs/.generated/config-baseline.sha256        |  4 ++--
 .../.generated/plugin-sdk-api-baseline.sha256 |  4 ++--
 docs/gateway/configuration-reference.md       | 22 +++++++++++++++++++
 docs/reference/token-use.md                   |  7 ++++++
 5 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 69fae5c35..fd4b15e12 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "f5a7632ffc903f1118c97872cc7392e6f6eb9c69",
-  "syncedAt": "2026-04-28T07:32:23.678Z"
+  "sha": "1dd011984a318b25824e1cb1aff1fecb5a3e67d9",
+  "syncedAt": "2026-04-28T07:36:31.540Z"
 }
diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256
index d89e8c0da..7e9f4a754 100644
--- a/docs/.generated/config-baseline.sha256
+++ b/docs/.generated/config-baseline.sha256
@@ -1,4 +1,4 @@
-f888e19429506211e4b8b4113594641825d300c0c0a721121092cae2201b721f  config-baseline.json
-481eb68ecf9538d8f6d9808af1a7416b05a3b5d00080552b955a77dbd90819e3  config-baseline.core.json
+b1d76b9451b21434325e64d5bb531b9b995ba3bbf8f7b1628c09cce18f24c8e2  config-baseline.json
+58e98b59498060d301104b3772332de5600eb674687b06d0d32a202370709ee0  config-baseline.core.json
 a9f058ee9616e189dab7fc223e1207a49ae52b8490b8028935c9d0a2b16f81b2  config-baseline.channel.json
 1f5592bfd141ba1e982ce31763a253c10afb080ab4ea2b6538299b114e29cee1  config-baseline.plugin.json
diff --git a/docs/.generated/plugin-sdk-api-baseline.sha256 b/docs/.generated/plugin-sdk-api-baseline.sha256
index a9dc066c4..92c1fcae9 100644
--- a/docs/.generated/plugin-sdk-api-baseline.sha256
+++ b/docs/.generated/plugin-sdk-api-baseline.sha256
@@ -1,2 +1,2 @@
-ffc0924db91ebb9b79c488879bc9938b199047a2577fc469e194af673c9e1303  plugin-sdk-api-baseline.json
-f2445b07d3ead6c38ab2a37c2e0eccb6414ade36d3fb9eb3dd157e5104f88b0d  plugin-sdk-api-baseline.jsonl
+9a688c953f0108f85f58c173e79c28363d846a592130abec04cafbcabbb22dcc  plugin-sdk-api-baseline.json
+010252e56202abde0816787588239c41b4bfb710b930a5454848a5ae76ad6dae  plugin-sdk-api-baseline.jsonl
diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md
index e0a0269ea..d5693d1f5 100644
--- a/docs/gateway/configuration-reference.md
+++ b/docs/gateway/configuration-reference.md
@@ -57,6 +57,28 @@ Tool policy, experimental toggles, provider-backed tool config, and custom
 provider / base-URL setup moved to a dedicated page — see
 [Configuration — tools and custom providers](/gateway/config-tools).
 
+## Models
+
+Provider definitions, model allowlists, and custom provider setup live in
+[Configuration — tools and custom providers](/gateway/config-tools#custom-providers-and-base-urls).
+The `models` root also owns global model-catalog behavior.
+
+```json5
+{
+  models: {
+    // Optional. Default: true. Requires a Gateway restart when changed.
+    pricing: { enabled: false },
+  },
+}
+```
+
+- `models.mode`: provider catalog behavior (`merge` or `replace`).
+- `models.providers`: custom provider map keyed by provider id.
+- `models.pricing.enabled`: controls the background pricing bootstrap. When
+  `false`, Gateway startup skips OpenRouter and LiteLLM pricing-catalog fetches;
+  configured `models.providers.*.models[].cost` values still work for local cost
+  estimates.
+
 ## MCP
 
 OpenClaw-managed MCP server definitions live under `mcp.servers` and are
diff --git a/docs/reference/token-use.md b/docs/reference/token-use.md
index cee0d86ed..ab233f5ff 100644
--- a/docs/reference/token-use.md
+++ b/docs/reference/token-use.md
@@ -120,6 +120,13 @@ These are **USD per 1M tokens** for `input`, `output`, `cacheRead`, and
 `cacheWrite`. If pricing is missing, OpenClaw shows tokens only. OAuth tokens
 never show dollar cost.
 
+Gateway startup also performs an optional background pricing bootstrap for
+configured model refs that do not already have local pricing. That bootstrap
+fetches remote OpenRouter and LiteLLM pricing catalogs. Set
+`models.pricing.enabled: false` to skip those startup catalog fetches on offline
+or restricted networks; explicit `models.providers.*.models[].cost` entries
+continue to drive local cost estimates.
+
 ## Cache TTL and pruning impact
 
 Provider prompt caching only applies within the cache TTL window. OpenClaw can