OpenClaw小白多模型设置教程及避坑指南

#文件路径C:\Users\你的用户名\.openclaw\openclaw.json

{  "env": {}，     #环境变量  "auth": {}，    #认证配置，内置模型提供商的认证信息  "models": {}，  #模型配置，自定义模型提供商  "agents": {}，  #代理配置，设置默认使用的模型和工作参数}

{  //认证配置，内置模型提供商的认证信息  "auth": {    "profiles": {      "openrouter:default": {        "provider": "openrouter",        "mode": "api_key"      },      "opencode:default": {        "provider": "opencode",        "mode": "api_key"      }    }  }}

{  //自定义模型提供商配置，定义了可用的模型及其参数  "models": {    "mode": "merge",//多模型配置，这个必须要有    "providers": {      //商汤      "sensenova": {        "baseUrl": "https://token.sensenova.cn/v1",        "apiKey": {          "source": "env",          "provider": "default",          "id": "SENSENOVA_API_KEY"        },        "api": "openai-completions",        "models": [          {            "id": "deepseek-v4-flash",            "name": "商汤Deepseek v4 flash",            "reasoning": false,            "input": [              "text"            ],            "contextWindow": 1048576,            "maxTokens": 65535          }        ]      },      //Agnes      "agnes": {        "baseUrl": "https://apihub.agnes-ai.com/v1",        "apiKey": {          "source": "env",          "provider": "default",          "id": "AGNES_API_KEY"        },        "api": "openai-completions",        "models": [          {            "id": "agnes-2.0-flash",            "name": "Agnes2.0",            "reasoning": false,            "input": [              "text",              "image"            ],            "contextWindow": 128000,            "maxTokens": 4096          }        ]      }    }  },}

{    "agents": {    "defaults": {      "model": {        //主力模型        "primary": "sensenova/deepseek-v4-flash",        //备用模型        "fallbacks": [          "opencode/deepseek-v4-flash-free",          "agnes/agnes-2.0-flash",                 "opencode/qwen3.6-plus-free",          "opencode/mimo-v2.5-free",          "opencode/minimax-m3-free"        ]      },      //白名单      "models": {        "opencode/deepseek-v4-flash-free": {},        "opencode/qwen3.6-plus-free": {},        "opencode/mimo-v2.5-free": {},        "opencode/minimax-m3-free": {},        "sensenova/deepseek-v4-flash": {},        "agnes/agnes-2.0-flash": {}      },     }   } }

#文件路径C:\Users\你的用户名\.openclaw\agents\main\agent\plugins

#文件路径C:\Users\你的用户名\.openclaw\agents\main\agent\openclaw-agent.sqlite

#文件路径C:\Users\你的用户名\.openclaw\agents\main\agent\models.json

#文件路径C:\Users\你的用户名\.openclaw\.evn# OpenCodeOPENCODE_API_KEY=你的api key# 商汤$SENSENOVA_API_KEY=你的api key# AGNESAGNES_API_KEY=你的api key# OpenRouterOPENROUTER_API_KEY=你的api key

  "env": {    "shellEnv": {      "enabled": true    }  },

自定义provider有几个要点：

• • baseUrl 是你的API地址，可以是本地（LM Studio、Ollama）、局域网、或者某个中转服务
• • api 告诉OpenClaw用什么协议。大部分用 openai-completions，如果后端支持也可以用 openai-responses
• • models 列表里，id 不要带 provider 前缀，比如 qwen3.6-plus 就行，完整引用是 qwen-free/qwen3.6-plus
• • 如果模型支持看图，记得设 input: [“text”, “image”]

allowlist 这个东西，我一开始完全没搞懂干嘛用的。直到有一次我手滑切到了一个没配API Key的模型，OpenClaw直接甩了一句：

这个功能我太喜欢了。

OpenClaw可以在聊着天的过程中随时换模型，不用重启，不用断会话。在聊天框里输入：

/model

弹出一个列表，给你编号选：

0: sensenova/deepseek-v4-flash1: nvidia/moonshotai/kimi-k2.62: nvidia/deepseek-ai/deepseek-v4-pro

输入 /model 2 就切过去了。或者直接输模型引用：

/model nvidia/moonshotai/kimi-k2.6

想回到默认模型就：

/model default

通过 /model 切换是「严格模式」。如果你手切到了某个模型，而这个模型恰好挂了，OpenClaw会直接报错告诉你它连不上，不会偷偷帮你fallback到其他模型。这是故意的——你既然手动指定了，它就尊重你的选择。

但配置里设的 primary 和 fallback 不是严格模式。primary 挂了，它会按fallback列表依次尝试。

还有一个经常踩的坑：如果你用 /model 切过模型，然后改配置文件里的 primary，切过的会话不会自动跟着变。你得先 /model default 让它继承新配置才行。

写到这里，你可能觉得这就是配几个模型的事。但用下来，OpenClaw的模型配置背后有一个很清晰的设计思路：

不是让你选一个模型用到死，而是让你拥有一个模型军团。

primary 是将军，fallback 是预备队，allowlist 是兵工厂，/model 实时切换是你随时可以换将的令牌。

遇到某个模型崩了，不会影响你整个智能助手的使用体验。你甚至察觉不到——它已经悄悄切到下一个继续干活了。

这个思路跟传统的「选好就用」完全不同。OpenClaw是「搭好体系，让它自己跑」。这可能才是AI助手该有的样子。

写配置的路上，踩了不少坑。挑几个重要的说：

1. fallback排太前了会变成主力。你把免费模型排在fallback第一位，它响应比主力快，就会被经常选中。建议把跟主力同等级的模型排在前面。

2. 别忘了配置 models.mode。

{  models: {    mode: "merge"  }}

默认就是 merge，但你如果改了 replace，自定义的 provider 会把内置的全部覆盖掉，后果就是一堆模型找不到了。

3. /model 切换是会话级的，不是永久的。用 /model 切到别的模型，只影响当前会话。新会话还是会用配置文件里的 primary。想要一直用，得改配置文件。

其实吧，模型配置这件事，说复杂也复杂，说简单也简单。

第一，设好主力模型。

第二，配好fallback梯队。

第三，用好allowlist。

搞定这三样，你的OpenClaw模型配置就基本毕业了。剩下的都是锦上添花。

我现在每天用OpenClaw，根本不用操心模型的事。主力不行了自动切，切完了自动探恢复，恢复了自己切回来。我就安安心心写我的文章、查我的资料。

以上，如果觉得不错，随手点个赞、在看、转发三连吧，如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章，我们，下次再见。

本文基于 OpenClaw 2026.6.11 版本

我的Openclaw教程