如何配置 OpenClaw 自动切换大模型

发表于 |

前言

我目前主要使用免费大模型训练智能体，免费模型每天都有 API 调用额度限制，我希望其中一个模型额度用尽时可以自动切换模型。

很方便的是，OpenClaw 原生就支持额度耗尽自动降级。你只需要配置好 fallbacks（回退模型链），系统会在检测到 429、额度不足或 API 错误时自动切换。

基础配置

编辑配置文件 ~/.openclaw/config.json5，设置主模型和备用模型顺序：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o",        // 主模型
        "fallbacks": [
          "openai/gpt-4o-mini",           // 备用1
          "google/gemini-2.0-flash"       // 备用2
        ],
        "fallbackPolicy": {
          "maxRetries": 2,                // 重试次数
          "notifyOnFallback": true        // 切换时通知
        }
      }
    }
  }
}

触发条件：当主模型返回 insufficient_quota（额度用尽）、rate_limit（限频）或网络超时时，会自动按顺序尝试 fallbacks 中的模型。

进阶配置：多 Key 轮换（防限流）

如果你有多个同款模型的 API Key，可以在同一模型下配置多个认证（auth profiles），系统会优先在内部轮换 Key，实在不行才切模型：

1
2
3
# 添加多个 OpenAI Key（同模型不同账号）
openclaw auth add openai --name key2
openclaw auth add openai --name key3

策略：Key1 被限流 → 自动用 Key2 → Key3 → 都不可用 → 切到 fallback 模型。

验证配置

配置完成后，执行以下命令查看状态：

1
2
openclaw models status      # 查看当前模型链
openclaw models list        # 查看已配置的模型

建议：把你的主力模型（如 GPT-4o）设为主模型，把便宜/免费的模型（如 GPT-4o-mini、Gemini Flash）设为 fallback，这样既能保证质量，又能在额度见底时无缝降级。

兜底方案：之 GIT 同步

假设 openclaw 部署在第三方云端机器上，你无法通过终端控制远程机器，只能利用 openclaw 来操控服务器的所有配置。

为了防止不小心将所有模型的额度都用尽导致无法与服务器建立联系，此时我们需要一个兜底方案，那就是将配置文件乃至整个 openclaw 目录交由 Git 仓库托管，当极端情况出现的时候，我们可以在本地修改配置文件然后同步到云端服务器，从而恢复与龙虾的对话。

  1. 首先在 GitHub 或者 Gitee 上创建一个新仓库。
  2. 然后在大模型额度用尽前让智能体把需要同步的目录上传到新仓库中，同时创建定时任务，每分钟从 Git 仓库拉取最新文件：
1
2
3
4
# 编辑 crontab
crontab -e
# 添加一行（每分钟检查一次）
* * * * * cd /home/gem/workspace/agent/workspace && git pull -q origin main

在这之前需要生成专属服务器的 SSH 密钥，方便服务器对该仓库的读写操作，这一步也可以交给智能体来做。

  1. 然后在手机或者自己的电脑也安装相应的 git 工具，把仓库克隆下来，方便我们随时修改。如果你想在苹果手机上使用 GIT，推荐大家尝试一下 Working Copy 这个应用，可以免费管理一个 GIT 仓库，足够我们使用了。

本文为作者原创 转载时请注明出处 谢谢

乱码三千 – 点滴积累 ,欢迎来到乱码三千技术博客站

0%