简要总结
Model Failover
这页说明书在讲一个“备用计划”的小秘密。当你想让电脑帮忙做事，但第一个方法（比如你常用的那个机器人）突然卡住了或者没反应了，电脑就会自动换一个方法试试。这页就是告诉你，电脑是怎么聪明地“换方法”的，它会先试试同一个机器人的其他“钥匙”，如果都不行，再换一个完全不同的机器人来帮你。
五岁小孩版解释
当你想用 OpenClaw 和机器人（我们叫它“模型”）聊天时，有时候机器人会太忙或者出点小问题。别担心，OpenClaw 有个聪明的“备用计划”，它会按顺序做两件事来帮你。
第一步：换“钥匙”
每个机器人（比如 OpenAI 或 Google）可能需要一把“钥匙”才能用。这把“钥匙”可能是你输入的密码（API key），也可能是你登录的账号（OAuth）。OpenClaw 会把你的“钥匙”都放在一个安全的小盒子里，文件在 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json。
- 如果一把“钥匙”不好用了（比如机器人说“太忙了，等会儿再来”），OpenClaw 就会从盒子里拿出另一把“钥匙”试试。
- 它会按一个顺序来选钥匙：先看你有没有在设置里指定顺序（
auth.order），如果没有，就看看盒子里有哪些钥匙，然后像轮流玩玩具一样，让每把钥匙都有机会被用到。 - 选钥匙的小规则：它会先选登录的账号（OAuth），再选密码（API key）。在每一类里，它会选最近用得最少的那把钥匙来用。
- 记住你的选择：一旦它为你的一次聊天选好了一把钥匙，在这次聊天里就会一直用这把，这样会更快。除非你开始一次新的聊天，或者这把钥匙被“冷却”了（就是暂时不能用了）。
第二步：换机器人 如果试遍了同一个机器人的所有“钥匙”都不行，那 OpenClaw 就会启动“终极备用计划”：换一个机器人！
- 它会按照你事先告诉它的名单（
agents.defaults.model.fallbacks），去找名单里的下一个机器人来帮忙。 - 这个“终极计划”只有在所有“钥匙”都因为认证失败、太忙或者超时等问题而没法用时才会启动。如果是其他小错误，就不会换机器人。
要小心和记住的事情
- “钥匙”会休息：如果一把“钥匙”因为机器人太忙或者密码错误失败了，它会被标记为“冷却”，就像玩累了要休息几分钟一样。休息时间会越来越长（1分钟，5分钟，25分钟，最多1小时）。
- “钥匙”会生病：如果失败是因为“钱不够了”这种大问题，这把“钥匙”会被标记为“禁用”，要休息更久（从5小时开始，最多24小时）。这些休息信息都记在那个安全的小盒子里。
- 你可以指定用哪把“钥匙”：如果你在聊天时特别指定了要用哪把钥匙（比如输入
/model …@<profileId>），那么在这次聊天里，OpenClaw 就会一直用这把钥匙，不会自动换。但如果这把指定的钥匙也失败了，并且你设置了可以换机器人，它就会直接跳到下一步，换一个机器人，而不是再试这个机器人的其他钥匙。 - 关于登录账号（OAuth）：如果你对一个机器人既有登录账号又有密码，它们会被当成两把不同的“钥匙”。OpenClaw 可能会在它们之间轮流换，除非你像上面说的那样指定只用其中一把。
最后 这个“备用计划”的规则，还有你可以设置哪些机器人作为备选，都可以在 OpenClaw 的设置文件里找到。你可以去看看“网关配置”和“模型”相关的说明页面，那里有更多细节。