Configure Openclaw Anyrouter Model And Fix Baseurl
v1.0.0用于在 OpenClaw 中新增或覆盖 anyrouter 模型配置、把小肠 Agent 默认模型切到 `anyrouter/claude-opus-4-6`,并结合运行日志判断是不是 `baseUrl`、网关兼容、鉴权或协议端点导致不可用。遇到“把某个供应商模型写进 openclaw.json”“切换默认模型”...
Like a lobster shell, security has layers — review code before you run it.
License
Runtime requirements
SKILL.md
配置 OpenClaw 的 AnyRouter 模型并修复 baseUrl 可用性
这个技能帮助你把 anyrouter/claude-opus-4-6 正确接入 OpenClaw、切换小肠 Agent 默认模型,并用真实日志与实测调用区分“配置已生效”和“上游实际可用”这两件事。
When to use this skill
- 当你需要把用户提供的一段 JSON 合并进
openclaw.json,并把小肠 / main Agent 的默认模型切到指定供应商模型。 - 当配置看起来已经写对,但运行时仍报
403、500、invalid claude code request,需要结合日志判断是不是baseUrl、协议端点或 key 权限问题。 - 当用户要求“确认当前小肠 Agent 到底是什么模型”“配置是否真的生效”“是否只是 fallback 在回答”。
- 当你还需要顺手检查
ClaudeCode本地配置,避免它仍指向旧网关地址。
Steps
-
先读取当前 OpenClaw 配置基线,再决定是新增还是覆盖
anyrouter。
这样做是为了避免盲写导致已有 provider、默认模型、agent 列表配置被误覆盖。
本次执行中先确认了:- 当前配置里已经存在
anyrouter - 但
baseUrl仍是旧值 - 小肠默认模型仍是
openai-codex/gpt-5.4
- 当前配置里已经存在
-
按用户给定 JSON 覆盖
models.providers.anyrouter,并保留models.mode = "merge"。
保留merge可以让新 provider 配置与现有模型体系共存,而不是整块替换掉其他 providers。
首轮实际写入的关键字段是:{ "models": { "mode": "merge", "providers": { "anyrouter": { "baseUrl": "https://a-ocnfniawgw.cn-shanghai.fcapp.run", "apiKey": "[REDACTED]", "api": "anthropic-messages", "models": [ { "id": "claude-opus-4-6", "name": "Claude Opus 4.6", "reasoning": true, "input": ["text"], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 200000, "maxTokens": 8192 } ] } } } } -
把默认模型切到
anyrouter/claude-opus-4-6,并同时确认agents.defaults与agents.list.main都已对齐。
只改默认值不检查main.model,容易出现“默认写了但主 Agent 仍走旧模型”的假生效。
本次确认后的生效状态是:agents.defaults.model.primary = anyrouter/claude-opus-4-6agents.list.main.model = anyrouter/claude-opus-4-6
-
记录当前密钥写入方式:是环境变量引用,还是明文写入。
这是后续排查权限与可维护性问题的关键,因为“能否解析环境变量”和“key 本身是否可用”是两回事。
本次两种形式都出现过:- 环境变量版:
"apiKey": "${AnyRouterKey}" - 明文版:
"apiKey": "[REDACTED]"
- 环境变量版:
-
重启 OpenClaw,并先回答“当前小肠 Agent 是什么模型”。
先确认静态配置状态,能快速回答用户最关心的问题,也为后续日志比对建立基线。
本次实际结论是:- 当前小肠 Agent:
anyrouter/claude-opus-4-6
- 当前小肠 Agent:
-
当用户怀疑
baseUrl异常时,先查日志,不要只看 JSON。
因为配置写进去只说明路由目标被设置了,不代表上游网关真的兼容该协议与模型。
本次日志里实际出现了:HTTP 500 new_api_error: invalid claude code request provider=anyrouter model=claude-opus-4-6以及:
OpenAI ... failed (403): <html><h1>403 Forbidden</h1>...随后回退为:
requested=anyrouter/claude-opus-4-6 ... next=openai-codex/gpt-5.3-codex -
基于日志判断
fcapp.run链路高概率不兼容后,把baseUrl切回https://anyrouter.top。
这样做不是因为域名“更短”,而是因为日志已经显示原链路存在网关兼容或鉴权异常,继续保留会让所有请求落入 fallback。
修复后保留不变的内容:api = "anthropic-messages"- 模型仍是
claude-opus-4-6 - 小肠默认模型仍是
anyrouter/claude-opus-4-6
-
修复后执行“真实调用验证”,不要只做静态配置检查。
真实请求能区分“OpenClaw 配对了”与“上游真能回答”这两个层次。
本次实际验证为:- 对
https://anyrouter.top/v1/messages发最小请求,model=claude-opus-4-6 - 返回:
HTTP 500new_api_error: invalid claude code request
- 对
-
继续做协议对照测试:
messages、chat/completions、responses、models分开看。
这是为了判断问题到底出在端点协议不匹配,还是模型只“可见不可调”。
本次实测结果:/v1/chat/completions+claude-opus-4-6→404 不支持该模型/v1/responses+claude-opus-4-6→404 不支持该模型/v1/models能列出模型(包含claude-opus-4-6)- 但实际调用仍被拒绝
结论:模型列表可见 ≠ 当前 key/路由可实际调用该模型。
-
检查 ClaudeCode 本地配置,把旧
fcapp地址对齐到https://anyrouter.top。
这样做是为了避免 OpenClaw 已改好,但 ClaudeCode 仍指向旧地址,导致排查结果互相打架。
本次已修正~/.claude/settings.json中相关配置,核心对齐为:ANTHROPIC_BASE_URL = https://anyrouter.top- 模型变量保持
claude-opus-4-6
-
如果上游仍不可用,给出“恢复可用态”的回退方案。
这是为了避免用户虽然坚持把主模型设成 opus,但实际每次都失败,影响日常使用。
本次实际执行过的恢复方案是:- 保留
anyrouterprovider 不删除 - 把小肠(main)默认模型切回:
openai-codex/gpt-5.4 - 重启 OpenClaw 使其恢复可用
- 保留
-
当用户后来手动又切回
claude-opus-4-6时,再次查日志核对“配置状态”和“实际运行状态”是否一致。
这一步能明确告诉用户:当前到底是主模型真在工作,还是配置虽然切了,但回答仍由 fallback 完成。
本次最终核对得到:- 配置中确实是
anyrouter/claude-opus-4-6 - 日志里也确实请求了
provider=anyrouter model=claude-opus-4-6 - 但随后
HTTP 500 new_api_error: invalid claude code request - 再进入 fallback:
openai-codex/gpt-5.3-codex
- 配置中确实是
Pitfalls and solutions
❌ 只看 openclaw.json 已改成功,就断言模型可用
→ 失败原因:配置生效只说明路由目标被设置,不代表上游网关接受该协议和模型
✅ 同时查运行日志与真实请求结果,确认有没有 403/500、有没有 fallback
❌ 看到 /v1/models 能列出 claude-opus-4-6,就认为该模型可调用
→ 失败原因:模型可见性不等于当前 key、当前路由、当前协议端点都具备实际调用权限
✅ 补做真实请求验证,至少测试 /v1/messages
❌ 把问题简单归因于“模型不存在”
→ 失败原因:本次日志明确出现的是 invalid claude code request 与 403 Forbidden,更像网关兼容或鉴权异常
✅ 按日志判断为链路/协议/权限问题,而不是盲目改模型 ID
❌ 只改 agents.defaults.model.primary,不检查 agents.list.main.model
→ 失败原因:某些场景下主 Agent 仍可能保留旧模型,造成“默认值变了但实际没切过去”
✅ 同时确认 defaults 与 main 的最终值
❌ 修复了 OpenClaw 的 baseUrl,却忘了 ClaudeCode 仍指向旧网关
→ 失败原因:两个入口的配置不一致,会导致排查结论混乱
✅ 顺手检查 ~/.claude/settings.json 并对齐 ANTHROPIC_BASE_URL
❌ 用户坚持保留不可用主模型时,不提供可用态恢复方案
→ 失败原因:系统会持续报错并依赖隐式 fallback,用户体验差且不透明
✅ 给出两类方案:临时切回稳定主模型,或保留主模型但明确 fallback 策略
Key code and configuration
1) 初始目标配置(环境变量版)
{
"models": {
"mode": "merge",
"providers": {
"anyrouter": {
"baseUrl": "https://anyrouter.top",
"apiKey": "${AnyRouterKey}",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": true,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anyrouter/claude-opus-4-6"
}
}
}
}
2) 首轮实际写入配置(fcapp.run 版)
{
"models": {
"mode": "merge",
"providers": {
"anyrouter": {
"baseUrl": "https://a-ocnfniawgw.cn-shanghai.fcapp.run",
"apiKey": "[REDACTED]",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": true,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anyrouter/claude-opus-4-6"
}
}
}
}
3) 日志分析后修复的推荐配置(切回 anyrouter.top)
{
"models": {
"mode": "merge",
"providers": {
"anyrouter": {
"baseUrl": "https://anyrouter.top",
"apiKey": "[REDACTED]",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": true,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anyrouter/claude-opus-4-6"
}
}
}
}
4) 本次排查中确认过的关键状态
agents.defaults.model.primary = anyrouter/claude-opus-4-6
agents.list.main.model = anyrouter/claude-opus-4-6
anyrouter.baseUrl = https://anyrouter.top
5) 关键错误日志
HTTP 500 new_api_error: invalid claude code request
provider=anyrouter model=claude-opus-4-6
OpenAI ... failed (403): <html><h1>403 Forbidden</h1>...
requested=anyrouter/claude-opus-4-6 ... next=openai-codex/gpt-5.3-codex
candidate_succeeded ... openai-codex/gpt-5.3-codex
6) ClaudeCode 需要对齐的关键配置项
{
"ANTHROPIC_BASE_URL": "https://anyrouter.top"
}
Environment and prerequisites
- 已安装并可重启的 OpenClaw 环境
- 有权限读取和修改当前
openclaw.json - 有权限查看 OpenClaw 运行日志
- 若需要联动排查,还需可读写
~/.claude/settings.json - 上游 anyrouter 需要提供:
- 可用
apiKey - 正确的
baseUrl - 与
anthropic-messages协议兼容的路由能力
- 可用
- 本次实测表明,即便
/v1/models可见claude-opus-4-6,仍可能无法实际调用,因此需要额外做真实请求验证
Files
2 totalComments
Loading comments…
