诊断 OpenClaw 的模型路由、fallback 使用情况与 CLI 中断原因

这个技能帮助你把 OpenClaw 的 Agent 配置、provider 注册信息和运行日志串起来，判断“请求到底发到了哪里、为什么某个模型没有被实际使用、fallback 是否真的发生过”，并补充分析 ClaudeCodeCLI 协作执行中断的根因。

When to use this skill

• 当用户怀疑“模型明明配置了，但实际没在跑”，需要区分“已注册可用”与“已绑定到执行链路”。
• 当用户要你结合 OpenClaw 当前配置和日志，判断主模型、fallback 链、provider 命中情况，而不是只做静态配置解读。
• 当用户问“是否所有请求都成功”“有没有进入 fallback”“为什么感觉都在走 GPT / 没走 Claude”。
• 当 OpenClaw 调起 ClaudeCodeCLI 失败，出现 Exec failed、code 143、中途被杀、无 stdout 等现象，需要给出可执行的规避方案。

Steps

1. 先区分用户到底在问“provider 没被调用”，还是“provider 下某个模型没被调用”

   • 要做什么：先把问题拆成两层再分析：
     • local-router 这个 provider 是否被请求命中
     • local-router/claude-opus-4-6-thinking 这个具体模型是否被 Agent 主链或 fallback 链使用
   • 为什么：这两件事最容易被混为一谈；provider 有流量，不代表 provider 里的每个模型都有流量。

2. 读取当前各 Agent 的主模型配置

   • 要做什么：核对 main、coder、writer 当前绑定的模型。
   • 已验证结论：
     • main → local-router/gpt-5.4
     • coder → local-router/gpt-5.4
     • writer → local-router/gpt-5.4
   • 为什么：用户的体感常来自“回答风格不像预期模型”，而主模型配置是最直接的证据链起点。

3. 读取默认 fallback 链，而不是只看 provider 的 models 列表

   • 要做什么：核对 agents.defaults.model 的 primary 和 fallbacks。
   • 已验证结论：
     • primary: local-router/gpt-5.4
     • fallbacks:
       1. aigocode-gpt/gpt-5.4-codex
       2. openai-codex/gpt-5.4
       3. local-router/gpt-5.3-codex
       4. aigocode-gpt/gpt-5.3-codex
   • 为什么：模型是否“会自然切到某个候选”，取决于 fallback 链有没有引用它，而不是 provider 是否声明过它可用。

4. 检查目标模型只是“已注册”，还是“已绑定”

   • 要做什么：确认 local-router/claude-opus-4-6-thinking 所在位置。
   • 已验证结论：
     • 它存在于 models.providers.local-router.models[]
     • 但当前没有任何 Agent 主模型引用它
     • 默认 fallback 链也没有引用它
   • 为什么：provider 中存在 只表示“可选”，不表示“当前执行链会使用”。

5. 给出第一层诊断结论：为什么用户感觉没请求发到某个模型

   • 要做什么：明确输出这类结论：
     • 如果用户特指 local-router/claude-opus-4-6-thinking，那“感觉没流量”是正确的
     • 因为它当前既不是主模型，也不在默认 fallback 链里
   • 为什么：这能把“错觉”变成“配置导致的必然结果”，降低误判。

6. 同时纠正另一种常见误解：不能把“没打到目标模型”误说成“没打到 provider”

   • 要做什么：说明当前主模型本身就是 local-router/gpt-5.4，所以请求确实在打 local-router provider。
   • 已验证线索：
     • 日志中大量出现：OpenClaw fallback model: gpt-5.4 via http://localhost:8317/v1
   • 为什么：用户往往观察的是模型风格或某个具体模型名，而不是 provider 维度的流量。

7. 补充历史与当前状态的区别，避免把旧日志当成当前事实

   • 要做什么：如果系统里有历史上目标模型被调用的痕迹，要明确说明“曾经用过”不等于“现在还在用”。
   • 已验证历史线索：
     • 曾出现过 requested=local-router/claude-opus-4-6-thinking
     • 曾出现 candidate_failed... reason=rate_limit
     • 然后 fallback 到 aigocode-gpt/gpt-5.4-codex
   • 为什么：日志回看很容易把旧配置时期的调用轨迹误判为当前链路。

8. 检查辅助链路，避免只盯主 Agent

   • 要做什么：同时看 memory/plugin 等辅助组件的模型。
   • 已验证线索：
     • memos-local-openclaw-plugin 的 summarizer 使用 claude-sonnet-4-6
     • endpoint 为 http://localhost:8317/v1
   • 为什么：系统可能“用了 local-router”，但用在插件辅助链路，而不是主 Agent；这会影响用户体感。