【养虾活动】openclaw不入门教程之模型篇

小龙虾系列文章：

• openclaw虚拟机部署不入门教程
• 为 OpenClaw 添加超能力：Skill不入门教程
• openclaw配置企业微信Bot
  

这次把使用放前面，基本概念放在后面，但是还是建议看看，毕竟多知道点总是不会错的。就像我明明可以问我的虾获取答案了，但是我教程写的还是命令行和指令。

使用方法

1、添加模型

在刚开始运行交互式新手引导的时候，就会有模型的配置，如果那时候我们没有设置，或者比如像联子这样自带了模型跳过了设置，那我们可以使用openclaw configure命令来配置模型：


2、查看模型

使用openclaw models status命令来查看已解析的主模型、回退模型、图像模型，以及已配置提供商的凭证概览。如果想运行实时认证探测的话，可以加 --probe参数。


如果只想单纯的查看列表可以使用：

1. # 模型列表：
   
2. openclaw models list
   
3. 
   
4. # 别名列表
   
5. openclaw models aliases list
   
6. 
   
7. # 回退列表
   
8. openclaw models fallbacks list
   
9. 
   
10. # 图片模型回退列表
    
11. openclaw models image-fallbacks list

复制代码

3、切换模型

比如我想把当前默认模型设成gpt-5.4模型，我就可以运行openclaw models set gpt-5.4。

如果省略提供商，OpenClaw 会将输入视为别名或默认提供商的模型（仅在模型 ID 不包含 `/` 时有效）。

1. # 设置默认模型，接受 provider/model 或别名
   
2. openclaw models set <model-or-alias>

复制代码

4、指令

当然，我们也可以在对话框使用指令来查看和切换模型。在对话框中输入/model，我们可以收到会回复：

• Current： 当前使用的模型
• Switch：模型切换
• Browse：浏览供应商列表、供应商模型列表
• More：更详细的信息
  

1. # 浏览供应商列表
   
2. /models
   
3. 
   
4. # 浏览供应商模型列表
   
5. /models <provider>
   
6. 
   
7. # 切换模型，接受 provider/model 或别名
   
8. /model <model-or-alias>
   
9. 
   
10. # 显示详细视图，包括在可用时配置的提供商端点（baseUrl）和 API 模式（api）。
    
11. /model status

复制代码

5、配置文件修改

修改之前建议先看看下面的基本概念部分，了解下基本知识。

1、可以在webui页面修改openclaw.json文件有关模型的部分，或者使用vim等编辑器来修改json文件。

2、如果只需要修改某项，可以直接使用config命令行：

1. # 查看主模型
   
2. openclaw config get agents.defaults.model.primary
   
3. 
   
4. # 修改主模型
   
5. openclaw config set agents.defaults.model.primary <provider/model>

复制代码

基本概念

1、提供商与模型

• Provider（提供商）：提供大语言模型（LLM）的公司、平台或服务，是模型的来源。比如我们常听说的OpenAI、绿联🦞模型所属的MiniMax。当然除了商业平台，也可以是私有化部署的开源模型服务。
• Model（模型）：指由提供商发布、具备特定能力、参数规模与版本的具体 AI 模型实例，比如gpt-5.4、MiniMax 2.1。
• 关系：同一个 Provider 可以提供多个 Model，例如 OpenAI 同时提供 GPT-5.4 和 GPT-5.3。
  

2、模型配置

如果我们查看了openclaw.json文件，会发现关于模型它的配置是这样的：

1. "models": {
   
2.     "providers": {
   
3.           "longCat": {
   
4.             "baseUrl": "https://api.longcat.chat/openai",
   
5.             "apiKey": "ak_**********",
   
6.             "api": "openai-completions",
   
7.             "models": [
   
8.                 {
   
9.                   "id": "LongCat-Flash-Lite",
   
10.                   "name": "LongCat-Flash-Lite",
    
11.                   "reasoning": false,
    
12.                   "input": ["text"],
    
13.                   "contextWindow": 200000,
    
14.                   "maxTokens": 8192
    
15.                 }
    
16.             ]
    
17.           }
    
18.         }
    
19.   }
    
20. }

复制代码

模型提供商配置：

• longCat（Endpoint ID）: 提供商内部名称
• baseUrl（API Base URL）：提供商API 服务地址
• apiKey（API Key）: 提供商API密钥
• api（Endpoint compatibility）: 提供商API 接口
• models: 提供商的模型列表，可以多个
  

提供商API 接口可选：

• OpenAI-compatible：使用 /chat/completions
• Anthropic-compatible：使用 /messages
• Unknown (detect automatically)：自动检测目标提供商的 API 接口格式，检测逻辑是「先尝试 OpenAI 格式，失败后再尝试 Anthropic 格式」
  

模型配置：

• id： 模型唯一标识，调用时使用
• name： 模型显示名称，UI/列表中展示
• reasoning： 是否支持推理/思维链：true（会显示思考过程）/false（直接给答案）
• input： 支持的输入类型，有text（文本）、image（图像）、video（视频）、code（代码）
• cost：成本配置（0=免费/未计费）
• contextWindow：上下文窗口大小
• maxTokens：最大输出长度
  

成本配置项：

• input: 输入费用（每1K tokens）
• output: 输出费用（每1K tokens）
• cacheRead: 缓存读取费用
• cacheWrite: 缓存写入费用
  

3、openclaw模型选择工作原理

OpenClaw 按以下顺序选择模型：

• 智能体专属模型：通过 agents.list[].model 配置的单个智能体专属模型
• 主模型：优先读取 agents.defaults.model.primary，若 primary 未配置，则读取 agents.defaults.model
• 回退模型：主模型不可用时，按顺序尝试 agents.defaults.model.fallbacks 中的所有回退模型。
• 提供商认证故障转移：会先在模型所属的提供商内部完成认证故障转移（比如同一提供商的不同密钥），只有当该提供商所有凭证都失效后，才会切换到下一个模型。
  

说明：

• 智能体模型注册表目录默认是 ~/.openclaw/agents/<agentId>/agent/models.json
• 对于图像模型：agents.defaults.imageModel.primary 和  agents.defaults.imageModel.fallbacks 仅在主模型不支持接收图像输入时触发，是专门针对图像交互的补充模型，不参与常规文本模型的选择流程。
  

配置示例：

1. "agents": {
   
2.     "defaults": {
   
3.       "model": {
   
4.         "primary": "custom-kimi/kimi-for-coding",
   
5.         "fallbacks": [
   
6.           "longCat/LongCat-Flash-Lite"
   
7.         ]
   
8.       },
   
9.    }
   
10. }

复制代码

4、模型白名单

如果配置了 agents.defaults.models列表，该列表将作为模型白名单生效：

• /model 指令展示的可用模型清单；
• 会话中可选择的模型允许列表；
• 同时支持在该列表中配置模型别名（alias）。
  

若选择的模型不在此白名单内，OpenClaw 会返回错误：Model "provider/model" is not allowed. Use /model to list available models.

1.   "agents": {
   
2.     "defaults": {
   
3.       "models": {
   
4.         "custom-kimi/kimi-for-coding": {
   
5.           "alias": "kimi-for-coding"
   
6.         },
   
7.         "longCat/LongCat-Flash-Lite": {
   
8.           "alias": "LongCat-Flash-Lite"
   
9.         }
   
10.       }
    
11.     }
    
12.   }

复制代码

爱打松鼠的枫叶 发表于 2026-3-17 16:11
如何换回默认模型啊

切换绿联默认模型方法:

在对话框输入：/model default/MiniMax-M2.1

不行sh连接输入： openclaw config set agents.defaults.model.primary default/MiniMax-M2.1

探测一下模型方法：openclaw models status --probe --probe-provider <name> --probe-timeout 15000，把<name>改成自己的模型供应商

先看看

如何换回默认模型啊

夏夏子 发表于 2026-3-17 16:53
在对话框输入：/model default/MiniMax-M2.1

好的

爱打松鼠的枫叶 发表于 2026-3-17 17:18
好的

试试行不行

绿联应用中心装的换不了

还有怎么更换成硅基流动的模型啊

pt3Hme 发表于 2026-3-17 17:31
绿联应用中心装的换不了

能的，不过你的先添加其他模型。

爱打松鼠的枫叶 发表于 2026-3-17 17:49
还有怎么更换成硅基流动的模型啊

先添加模型呀 ，按我的第一步的来 。或者你和他说你要添加硅胶基，为了保险起见可以把我附的json内容给他 ，你叫他按照这个格式来添加