diff --git a/docs/ANTIGRAVITY_AUTH.md b/docs/ANTIGRAVITY_AUTH.md
index 360efa137..d88d73c8d 100644
--- a/docs/ANTIGRAVITY_AUTH.md
+++ b/docs/ANTIGRAVITY_AUTH.md
@@ -584,7 +584,7 @@ Each SSE message (`data: {...}`) is wrapped in a `response` field:
   ],
   "agents": {
     "defaults": {
-      "model": "gemini-flash"
+      "model_name": "gemini-flash"
     }
   }
 }
diff --git a/docs/credential_encryption.md b/docs/credential_encryption.md
index 96000bb65..dde8c782c 100644
--- a/docs/credential_encryption.md
+++ b/docs/credential_encryption.md
@@ -30,6 +30,7 @@ enc://AAAA...base64...
   "model_list": [
     {
       "model_name": "gpt-4o",
+      "model": "openai/gpt-4o",
       "api_key": "enc://AAAA...base64...",
       "api_base": "https://api.openai.com/v1"
     }
diff --git a/docs/providers.md b/docs/providers.md
index e62cbb969..12006b583 100644
--- a/docs/providers.md
+++ b/docs/providers.md
@@ -95,7 +95,7 @@ This design also enables **multi-agent support** with flexible provider selectio
   ],
   "agents": {
     "defaults": {
-      "model": "gpt-5.4"
+      "model_name": "gpt-5.4"
     }
   }
 }
@@ -268,7 +268,7 @@ The old `providers` configuration is **deprecated** but still supported for back
   ],
   "agents": {
     "defaults": {
-      "model": "glm-4.7"
+      "model_name": "glm-4.7"
     }
   }
 }
@@ -300,7 +300,7 @@ This keeps the runtime lightweight while making new OpenAI-compatible backends m
   "agents": {
     "defaults": {
       "workspace": "~/.picoclaw/workspace",
-      "model": "glm-4.7",
+      "model_name": "glm-4.7",
       "max_tokens": 8192,
       "temperature": 0.7,
       "max_tool_iterations": 20
@@ -330,12 +330,11 @@ picoclaw agent -m "Hello"
 {
   "agents": {
     "defaults": {
-      "model": "anthropic/claude-opus-4-5"
+      "model_name": "anthropic/claude-opus-4-5"
     }
   },
   "session": {
-    "dm_scope": "per-channel-peer",
-    "backlog_limit": 20
+    "dm_scope": "per-channel-peer"
   },
   "providers": {
     "openrouter": {