diff --git a/docs/gateway/configuration.md b/docs/gateway/configuration.md
index ffcbf3f77..87938edb6 100644
--- a/docs/gateway/configuration.md
+++ b/docs/gateway/configuration.md
@@ -571,7 +571,7 @@ Inbound messages are routed to an agent via bindings.
   - `agentDir`: default `~/.clawdbot/agents/<agentId>/agent`.
   - `model`: per-agent default model, overrides `agents.defaults.model` for that agent.
     - string form: `"provider/model"`, overrides only `agents.defaults.model.primary`
-    - object form: `{ primary, fallbacks }` overrides fallbacks as well
+    - object form: `{ primary, fallbacks }` (fallbacks override `agents.defaults.model.fallbacks`; `[]` disables global fallbacks for that agent)
   - `identity`: per-agent name/theme/emoji (used for mention patterns + ack reactions).
   - `groupChat`: per-agent mention-gating (`mentionPatterns`).
   - `sandbox`: per-agent sandbox config (overrides `agents.defaults.sandbox`).