diff --git a/docs/guides/providers.md b/docs/guides/providers.md
index 62bbbbe56..7b078373d 100644
--- a/docs/guides/providers.md
+++ b/docs/guides/providers.md
@@ -417,10 +417,8 @@ It also applies cooldown tracking per candidate to avoid immediately retrying a
   ],
   "agents": {
     "defaults": {
-      "model": {
-        "primary": "qwen-main",
-        "fallbacks": ["deepseek-backup", "gemini-backup"]
-      }
+      "model_name": "qwen-main",
+      "model_fallbacks": ["deepseek-backup", "gemini-backup"]
     }
   }
 }
diff --git a/docs/guides/providers.zh.md b/docs/guides/providers.zh.md
index 1302407a3..4bab65f6b 100644
--- a/docs/guides/providers.zh.md
+++ b/docs/guides/providers.zh.md
@@ -362,10 +362,8 @@ PicoClaw 按下面的规则解析 `provider` 和最终发给上游的模型 ID
   ],
   "agents": {
     "defaults": {
-      "model": {
-        "primary": "qwen-main",
-        "fallbacks": ["deepseek-backup", "gemini-backup"]
-      }
+      "model_name": "qwen-main",
+      "model_fallbacks": ["deepseek-backup", "gemini-backup"]
     }
   }
 }