diff --git a/docs/docs.json b/docs/docs.json
index 3a79d609100..5ee53ed6008 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -65,7 +65,7 @@
     },
     {
       "source": "/cron",
-      "destination": "/cron-jobs"
+      "destination": "/automation/cron-jobs"
     },
     {
       "source": "/minimax",
@@ -513,11 +513,11 @@
     },
     {
       "source": "/model",
-      "destination": "/models"
+      "destination": "/concepts/models"
     },
     {
       "source": "/model/",
-      "destination": "/models"
+      "destination": "/concepts/models"
     },
     {
       "source": "/models",
diff --git a/docs/help/troubleshooting.md b/docs/help/troubleshooting.md
index 1660100ba8c..63cfacbee50 100644
--- a/docs/help/troubleshooting.md
+++ b/docs/help/troubleshooting.md
@@ -3,7 +3,7 @@ summary: "Symptom first troubleshooting hub for OpenClaw"
 read_when:
   - OpenClaw is not working and you need the fastest path to a fix
   - You want a triage flow before diving into deep runbooks
-title: "Troubleshooting"
+title: "General Troubleshooting"
 ---
 
 # Troubleshooting
diff --git a/docs/platforms/mac/health.md b/docs/platforms/mac/health.md
index 8115dd4c250..7cda23e3221 100644
--- a/docs/platforms/mac/health.md
+++ b/docs/platforms/mac/health.md
@@ -2,7 +2,7 @@
 summary: "How the macOS app reports gateway/Baileys health states"
 read_when:
   - Debugging mac app health indicators
-title: "Health Checks"
+title: "Health Checks (macOS)"
 ---
 
 # Health Checks on macOS
diff --git a/docs/platforms/mac/skills.md b/docs/platforms/mac/skills.md
index fc1e6c6af5f..2c2b5d95924 100644
--- a/docs/platforms/mac/skills.md
+++ b/docs/platforms/mac/skills.md
@@ -3,7 +3,7 @@ summary: "macOS Skills settings UI and gateway-backed status"
 read_when:
   - Updating the macOS Skills settings UI
   - Changing skills gating or install behavior
-title: "Skills"
+title: "Skills (macOS)"
 ---
 
 # Skills (macOS)
diff --git a/docs/platforms/mac/voicewake.md b/docs/platforms/mac/voicewake.md
index 1830acb35a4..c7cacd4c5dd 100644
--- a/docs/platforms/mac/voicewake.md
+++ b/docs/platforms/mac/voicewake.md
@@ -2,7 +2,7 @@
 summary: "Voice wake and push-to-talk modes plus routing details in the mac app"
 read_when:
   - Working on voice wake or PTT pathways
-title: "Voice Wake"
+title: "Voice Wake (macOS)"
 ---
 
 # Voice Wake & Push-to-Talk
diff --git a/docs/platforms/mac/webchat.md b/docs/platforms/mac/webchat.md
index 11b500a8596..6bc27203fae 100644
--- a/docs/platforms/mac/webchat.md
+++ b/docs/platforms/mac/webchat.md
@@ -2,7 +2,7 @@
 summary: "How the mac app embeds the gateway WebChat and how to debug it"
 read_when:
   - Debugging mac WebChat view or loopback port
-title: "WebChat"
+title: "WebChat (macOS)"
 ---
 
 # WebChat (macOS app)
diff --git a/docs/providers/index.md b/docs/providers/index.md
index 82e30575bc8..7da77b34c5d 100644
--- a/docs/providers/index.md
+++ b/docs/providers/index.md
@@ -3,7 +3,7 @@ summary: "Model providers (LLMs) supported by OpenClaw"
 read_when:
   - You want to choose a model provider
   - You need a quick overview of supported LLM backends
-title: "Model Providers"
+title: "Provider Directory"
 ---
 
 # Model Providers