OpenClaw �� 详细的小白免费模型设置教程及避坑指南

修改完

小龙虾安装好后，最重要的是要给🦞安装大脑，就是设置各大模型厂的API Key或者签权认证，这样🦞才能正常跑起来，今天就详细的拆解多模型设置。

一、相关文件

模型配置主要涉及以下五个文件。

第一个是openclaw.json文件

这个文件也是的OpenClaw的总配置文件，所有的设置都在这个文件里。

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

基础的配置文件如下:

{  "meta": {}，    #配置文件的元数据，包括最后修改版本和时间  "env": {}，     #环境变量  "wizard": {}，  #向导工具的运行信息  "auth": {}，    #认证配置，包含不同提供者的认证信息  "models": {}，  #模型配置，定义了可用的AI模型及其参数  "agents": {}，  #代理配置，设置默认使用的模型和工作参数  "tools": {}，   #工具配置  "messages": {}，#消息处理配置  "commands": {}，#命令配置  "hooks": {}，   #钩子配置，用于扩展功能  "channels": {}，#渠道配置，如飞书集成  "gateway": {}， #网关配置，设置API访问参数  "skills" :{}，  #技能配置，启用特定功能  "plugins"：{}   #插件配置，管理扩展功能}

模型相关的配置的是auth和models，如下图，这是在安装阶段配置千问模型配置文件。

{  #............  //认证配置，包含不同提供者的认证信息  "auth": {    "profiles": {      "qwen-portal:default": {        "provider": "qwen-portal",        "mode": "oauth"      }    }  },  //模型配置，定义了可用的AI模型及其参数  "models": {    "providers": {      "qwen-portal": {        "baseUrl": "https://portal.qwen.ai/v1",        "apiKey": "qwen-oauth",        "api": "openai-completions",        "models": [          {            "id": "coder-model",            "name": "Qwen Coder",            "reasoning": false,            "input": [              "text"            ],            "cost": {              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 128000,            "maxTokens": 8192          },          {            "id": "vision-model",            "name": "Qwen Vision",            "reasoning": false,            "input": [              "text",              "image"            ],            "cost": {              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 128000,            "maxTokens": 8192          }        ]      }    }  },  //代理配置，设置默认使用的模型和工作参数  "agents": {    "defaults": {      "model": {        "primary": "qwen-portal/coder-model",        "fallbacks": [          "qwen-portal/coder-model",          "qwen-portal/vision-model"        ]      },      "models": {        "qwen-portal/coder-model": {          "alias": "qwencode"        },        "qwen-portal/vision-model": {          "alias": "qwenvision"                }      },      "workspace": "C:\\Users\\Lenovo\\.openclaw\\workspace",      "compaction": {        "mode": "safeguard"      },      "maxConcurrent": 4,      "subagents": {        "maxConcurrent": 8      }    }  },  #............}

第二个是auth-profiles.json文件

鉴权配置,这个文件保存的信息是用系统的openclaw config命令配置内置模型时的信息。

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

相关的配置的信息如下图，这是在安装阶段配置千问模型配置文件。

{  "version": 1,  "profiles": {    "qwen-portal:default": {      "type": "oauth",      "provider": "qwen-portal",      "access": "xxxxx",      "refresh": "xxxxx",      "expires": 1770714202071    }  },  "lastGood": {    "qwen-portal": "qwen-portal:default"  },  "usageStats": {    "qwen-portal:default": {      "errorCount": 0,      "lastFailureAt": 1770593447833,      "lastUsed": 1770703271288    }  }}

第三个是auth.json文件

鉴权这个文件保存的信息是用系统的openclaw config命令配置内置模型时存储的签权信息，没有其它第三方模型信息。

#文件路径C:\Users\Lenovo\.openclaw\agents\main\agent\auth.json

相关的配置的信息如下图，这是在安装阶段配置千问模型配置文件。

{  "qwen-portal": {    "type": "oauth",    "access": "XXXXX",    "refresh": "XXXXX",    "expires": 1772601764447  }}

第四个是models.json文件

所有模型的详细配置文件。

#文件路径C:\Users\Lenovo\.openclaw\agents\main\agent\models.json

相关的配置的信息如下图，这是在安装阶段配置千问模型配置文件。

{  "providers": {    "qwen-portal": {      "baseUrl": "https://portal.qwen.ai/v1",      "api": "openai-completions",      "models": [        {          "id": "coder-model",          "name": "Qwen Coder",          "reasoning": false,          "input": [            "text"          ],          "cost": {            "input": 0,            "output": 0,            "cacheRead": 0,            "cacheWrite": 0          },          "contextWindow": 128000,          "maxTokens": 8192        },        {          "id": "vision-model",          "name": "Qwen Vision",          "reasoning": false,          "input": [            "text",            "image"          ],          "cost": {            "input": 0,            "output": 0,            "cacheRead": 0,            "cacheWrite": 0          },          "contextWindow": 128000,          "maxTokens": 8192        }      ],      "apiKey": "qwen-oauth"    }  }}

第五是.evn文件

保存环境变量的文件。安全期间，将所有api key配置在这里。

#文件路径C:\Users\你的用户名\.openclaw\.evn# OpenClaw 环境变量配置# 敏感信息单独管理，配置文件使用 ${变量名} 引用# opencode API KeyOPENCODE_API_KEY=你的api key

以上五个文件是所有模型配置相关的文件，其中需要手动配置的是openclaw.json和.evn，其它文件openclaw会自动配置。

二、模型配置方式

模型配置主要有两种方式。

第一种使用openclaw config命令配置，适合openclaw内置的模型。

这里我们配置opencode的免费的模型。

在Windows (PowerShell)(管理员)命令行工具中输入openclaw config，如下，直接回车。

选Model,然后回车。

选OpenCode Zen,然后回车。

选Paste API Key now,然后回车。

注意，如果没有注册，先去https://opencode.ai/zen注册一个账号，并获取API Key，目前提供两个免费模型minimax-m2.5-free和trinity-large-preview-free。由于我已经设置在环境变量中配置了API Key，提示选择环境变量，如果你没有设置过就直接粘贴获得的API Key，然后回车。