openclaw - 💡(How to fix) Fix Heartbeat agent ignores its own fallback chain, uses agents.defaults.model.fallbacks instead [1 participants]

[model-fallback] model fallback decision: decision=candidate_failed requested=mistral/mistral-large-latest candidate=mistral/mistral-large-latest reason=auth next=zai/glm-5

Note: zai/glm-5 is NOT in the heartbeat's configured fallback chain - it comes from agents.defaults.model.fallbacks.

TL;DR

The heartbeat agent can be fixed by passing the agent-specific fallback chain via fallbacksOverride to runWithModelFallback or by modifying the model selection logic to use the agent's configured fallbacks.

Guidance

• Verify that the fallbacksOverride parameter is not being passed to runWithModelFallback in the current implementation.
• Check the model selection logic to see if it is using the global defaults (agents.defaults.model.fallbacks) instead of the agent's configured fallbacks (agents.list[].model.fallbacks).
• Update the heartbeat runner to pass the agent-specific fallback chain via fallbacksOverride to runWithModelFallback.
• Consider modifying the model selection logic to prioritize the agent's configured fallbacks over the global defaults.

Example

// Example of passing agent-specific fallback chain via fallbacksOverride
{
  "id": "heartbeat",
  "model": {
    "primary": "mistral/mistral-large-latest",
    "fallbacks": [
      "openrouter/openrouter/free",
      "zai/glm-4.7",
      "codestral/codestral-latest",
      "groq/openai/gpt-oss-120b"
    ]
  }
}

// In the heartbeat runner code
runWithModelFallback({
  // ...
  fallbacksOverride: agent.model.fallbacks
})

Notes

The exact implementation details may vary depending on the specific codebase and requirements. It is essential to review the code and test the changes thoroughly to ensure the fix works as expected.

Recommendation

Apply workaround by passing the agent-specific fallback chain via fallbacksOverride to runWithModelFallback, as this approach is more targeted and less likely to introduce unintended side effects.