本文作者：猫猫摸大鱼 原文地址：[https://iloli.love/archives/1772467309102](https://iloli.love/archives/1772467309102)

## 1\. 前言

本文隶属于 OpenClaw 龙虾系列教程文章，建议按顺序阅读，可以访问OpenClaw龙虾系列教程文章目录 [https://iloli.love/archives/1766849996690](https://iloli.love/archives/1766849996690) 查看其它文章

本文基于 OpenClaw 2026.3.1 官方一键脚本直装版本

本系列教程全程使用腾讯云轻量应用服务器，可以参加腾讯云OpenClaw专属活动进行购买，新客68/年起，老客99/年起

活动链接 [https://cloud.tencent.com/act/pro/lighthouse-moltbot](https://cloud.tencent.com/act/pro/lighthouse-moltbot) （无AFF） [http://to.iloli.love/openclaw](http://to.iloli.love/openclaw) （有AFF）

**就算不买也强烈推荐使用有 快照 功能的厂商的服务器进行搭建，并且一定要经常打快照，不要问为什么，血的教训，血的教训，血的教训**

![](https://developer.qcloudimg.com/http-save/yehe-6836203/0661b2a849577f096264c5c180aa7307.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/fbcd795bfb2b64f4bb27fa28ed0df1cc.png)

## 2\. 场景

刚刚由于模型限频了，出现了这样的情况，于是我就在想，能不能有降级机制，模型不可用自动回落到其它模型呢

![](https://developer.qcloudimg.com/http-save/yehe-6836203/788c71d2735584c6172a4f25f6383e19.png)

于是翻阅了一会文档，发现OpenClaw本身就有模型降级机制，那么接下来我们就开始配置

（本文中我再接入两个 `gpt-5.2-codex` 和 `qwen3-coder-plus` 作为降级模型）

## 3\. 开始配置

### 3.1 手动配置 （比较麻烦，如果不小心多或者少了字符可能导致配置文件格式错误）

打开 `/root/.openclaw/openclaw.json`

首先，为我们自建的大模型API多接入几个模型

图中 1 所指的框框，是我们的大模型API的渠道名称，如果你是跟着我的教程走的话，这里应该是 `custom-api-xxxxx-xxx` ，我们下文也都以这个为例子；图中 2 所指的框框，就是我们这个自定义渠道已经接入的模型配置

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6aa584c65046f8b8d4c3a624b8be06e2.png)

那么现在就开始多配置几个模型

复制如下代码（一定要带着缩进复制）

    ,{
                "id": "gpt-5.2-codex",
                "name": "gpt-5.2-codex",
                "reasoning": false,
                "input": [
                  "text"
                ],
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                },
                "contextWindow": 128000,
                "maxTokens": 8192
              }

然后把光标点到 `maxTokens` 下面的那个 `}` 后面

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bf4598eb8da05e096268e7afb5695ce7.png)

直接粘贴两个，然后挨个修改 ID 和 Name ，ID 一定要是模型名称，Name 随意，至于其他参数可按需修改

![](https://developer.qcloudimg.com/http-save/yehe-6836203/102f1d6dd54c1a000a5f667e31cf1dea.png)

接下来，为我们的主agent配置降级模型

复制如下代码（一定要带着缩进复制）

    ,
            "fallbacks": [
              "custom-api-xxxxx-xxx/gpt-5.2-codex",
              "custom-api-xxxxx-xxx/gpt-5.2-codex"
            ]

找到 `agents` 配置，将光标移动到 `primary` 行的 `"` 后面，直接粘贴

![](https://developer.qcloudimg.com/http-save/yehe-6836203/4639946a51e8acb4864bae3a67a5fd59.png)

将 `custom-api-xxxxx-xxx` 修改为你实际的渠道名称，然后修改模型名称

![](https://developer.qcloudimg.com/http-save/yehe-6836203/27799775e1f52e7fedcd1abd1174a8d2.png)

继续复制如下代码（一定要带着缩进复制）

    ,
            "custom-api-xxxxx-xxx/gpt-5.2-codex": {},
            "custom-api-xxxxx-xxx/gpt-5.2-codex": {}

将光标放到如图中的 `{}` 后面，直接粘贴

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bdb3c16782f13c7a3074b2cc63f76c68.png)

将 `custom-api-xxxxx-xxx` 修改为你实际的渠道名称，然后修改模型名称

![](https://developer.qcloudimg.com/http-save/yehe-6836203/f7fb31aebc1416843175f884c4111370.png)

修改完成，保存文件，然后运行以下命令重启 openclaw 网关

    openclaw gateway restart

### 3.2 直接让 Bot 帮你配置 （简单，但是AI可能会出错）

直接给Bot发消息： `将 gpt-5.2-codex 和 qwen3-coder-plus 作为当前渠道内的模型接入，复用现有模型的参数，配置进模型列表，并依次作为降级模型；接入完成后，回复我具体进行了哪些修改，并使用 openclaw doctor 测试是否存在未知问题，如果有则告诉我，并依照提示解决问题，没有问题后，再重启网关；全部完成后向我报告`

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bcc1470d4d26f7a5137f6f67bcf3a622.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/687149cfa7344ee67efcc68cf9028940.png)

可以看到，bot自己开始了配置，虽然中间出现了错误，但~~因为我们优秀的提示词~~最终还是改正了；至于最后应该是因为重启网关了，所以没有后续的消息

（该说不说，确实比手动配置爽）

本文作者：猫猫摸大鱼 原文地址：https://iloli.love/archives/1772467309102

为OpenClaw配置模型降级（故障转移）

OpenClaw 提供了模型降级（故障转移）机制，旨在主模型因限频或不可用时自动回落至备用模型。配置过程主要涉及对 openclaw.json 文件的修改

腾云先锋（TDP）成员

编程语言

轻量应用服务器

服务器

4核4G3M云服务器 新用户低至38元/年！

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

为OpenClaw配置模型降级（故障转移）-腾讯云开发者社区-腾讯云

为OpenClaw配置模型降级（故障转移）

为OpenClaw配置模型降级（故障转移）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐