Model Route Guard

---

name: model-route-guard

description: Diagnose and fix model routing conflicts. Ensure primary model uses correct provider endpoint without duplicate overrides.

---

# Model Route Guard

Fix model routing and provider endpoint conflicts.

Problem

Model routing issues cause:

Workflow

1. Route Audit

# Check global config
$cfg = Get-Content "$HOME/.openclaw/openclaw.json" -Raw | ConvertFrom-Json
$globalBase = $cfg.models.providers.bailian.baseUrl
$globalModel = $cfg.agents.defaults.model.primary

# Check agent overrides
$agentCfgPath = "$HOME/.openclaw/agents/main/agent/models.json"
if (Test-Path $agentCfgPath) {
    $agentCfg = Get-Content $agentCfgPath -Raw | ConvertFrom-Json
    $agentBase = $agentCfg.providers.bailian.baseUrl
}

"Global baseUrl = $globalBase"
"Global model   = $globalModel"
"Agent baseUrl  = $agentBase"

# Detect conflicts
if ($globalBase -ne $agentBase) {
    Write-Warning "Provider URL mismatch between global and agent config"
}

2. Fix Conflicts

# Correct endpoint (coding.dashscope, not coding-intl)
$correctUrl = "https://coding.dashscope.aliyuncs.com/v1"

# Update global config
$cfg.models.providers.bailian.baseUrl = $correctUrl
$cfg | ConvertTo-Json -Depth 10 | Out-File "$HOME/.openclaw/openclaw.json" -Encoding UTF8

# Remove conflicting agent override
if (Test-Path $agentCfgPath) {
    Remove-Item $agentCfgPath -Force
}

# Restart
openclaw gateway restart

3. Verification

# Test model call
openclaw models list

# Check active route
openclaw status

Executable Completion Criteria

| Criteria | Verification |

|----------|-------------|

| Single provider URL | Only one bailian.baseUrl in config |

| Correct endpoint | URL is coding.dashscope.aliyuncs.com |

| No duplicate overrides | models.json removed or aligned |

| Model call succeeds | `openclaw models list` works |

Privacy/Safety

Self-Use Trigger

Use when:

---

**One route. One source of truth.**