Model Route Guard
Fix model routing and provider endpoint conflicts.
Problem
Model routing issues cause:
- - Wrong provider endpoint used
- Duplicate provider definitions
- Agent overrides conflicting with global config
- Silent fallback to wrong model
Workflow
1. Route Audit
CODEBLOCK0
2. Fix Conflicts
CODEBLOCK1
3. Verification
CODEBLOCK2
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
- - No API keys in audit output
- Redact key values (show first 4 chars)
- Config files only, no external logging
Self-Use Trigger
Use when:
- - Model calls fail with endpoint errors
- Config shows multiple provider definitions
- After gateway restart with model issues
- Silent fallback to wrong model detected
One route. One source of truth.
模型路由防护
修复模型路由与提供商端点冲突。
问题
模型路由问题会导致:
- - 使用错误的提供商端点
- 重复的提供商定义
- 代理覆盖与全局配置冲突
- 静默回退到错误模型
工作流程
1. 路由审计
powershell
检查全局配置
$cfg = Get-Content $HOME/.openclaw/openclaw.json -Raw | ConvertFrom-Json
$globalBase = $cfg.models.providers.bailian.baseUrl
$globalModel = $cfg.agents.defaults.model.primary
检查代理覆盖
$agentCfgPath = $HOME/.openclaw/agents/main/agent/models.json
if (Test-Path $agentCfgPath) {
$agentCfg = Get-Content $agentCfgPath -Raw | ConvertFrom-Json
$agentBase = $agentCfg.providers.bailian.baseUrl
}
全局 baseUrl = $globalBase
全局 model = $globalModel
代理 baseUrl = $agentBase
检测冲突
if ($globalBase -ne $agentBase) {
Write-Warning 全局配置与代理配置的提供商URL不匹配
}
2. 修复冲突
powershell
正确的端点(coding.dashscope,而非 coding-intl)
$correctUrl = https://coding.dashscope.aliyuncs.com/v1
更新全局配置
$cfg.models.providers.bailian.baseUrl = $correctUrl
$cfg | ConvertTo-Json -Depth 10 | Out-File $HOME/.openclaw/openclaw.json -Encoding UTF8
移除冲突的代理覆盖
if (Test-Path $agentCfgPath) {
Remove-Item $agentCfgPath -Force
}
重启
openclaw gateway restart
3. 验证
powershell
测试模型调用
openclaw models list
检查活动路由
openclaw status
可执行完成标准
| 标准 | 验证方式 |
|---|
| 单一提供商URL | 配置中仅有一个 bailian.baseUrl |
| 正确端点 |
URL 为 coding.dashscope.aliyuncs.com |
| 无重复覆盖 | models.json 已移除或对齐 |
| 模型调用成功 | openclaw models list 正常工作 |
隐私/安全
- - 审计输出中不包含API密钥
- 对密钥值进行脱敏处理(仅显示前4个字符)
- 仅涉及配置文件,无外部日志记录
自我触发条件
在以下情况使用:
- - 模型调用因端点错误失败
- 配置显示多个提供商定义
- 网关重启后出现模型问题
- 检测到静默回退到错误模型
一条路由。唯一真相来源。