【手把手系列】openclaw配置自定义模型

用 OpenClaw 时是不是总遇到这些问题：官方模型 API 太贵、调用受限、数据上传云端担心隐私泄露？或是想用本地部署的大模型，却不知道怎么和 OpenClaw 对接？

作为能真正操作电脑、自主执行任务的 AI 助手，OpenClaw 默认模型往往无法满足所有人的需求 —— 想要更个性化、更可控的 AI 体验，配置自定义模型是必经之路。

别担心复杂的代码和配置文件！本文「手把手系列」全程拆解，零基础也能跟着做，帮你把心仪的大模型无缝接入 OpenClaw，打造专属你的私人 AI 智能体。

命令行配置（推荐）

前置准备：确认环境与核心文件

- 已完成 OpenClaw 基础部署（本地 / 服务器均可），能正常启动WebUI页面

步骤 1：启动交互式配置向导

在 WSL / 终端中输入以下命令，回车后进入 OpenClaw 配置引导界面：

openclaw onboard

👉 效果：终端会弹出「Quick Start」配置菜单，包含模型、服务、网络等核心配置项。

步骤 2：定位到自定义模型配置项

配置向导中找到「Model Configuration」（模型配置）模块，选择「Update Value」（修改配置值）；

找到「Custom Provider」（自定义模型提供商）选项，回车进入子配置界面；

步骤 3：填写自定义模型信息（关键）

跟着终端提示，依次输入以下信息（输入完成按回车确认，无需手动拼格式）：

步骤 4：保存配置并验证

所有信息填写完成后，返回配置向导主界面，选择「Save Configuration」（保存配置）；

重启 OpenClaw 服务使配置生效：

# 停止现有服务（若已启动）openclaw stop# 启动服务openclaw start

验证配置：打开 OpenClaw WebUI，在「设置→模型选择」下拉框中能看到你配置的自定义模型（如gpt-5.2 (Custom Provider)），发送测试消息能正常回复即配置成功。

补充：命令行快速配置（进阶・一键式）

若不想用交互式向导，可直接用一行命令完成自定义模型配置（适合批量部署 / 脚本调用）：

# 一键设置自定义模型参数openclaw config set \  --key models.providers.custom-your-api-example-com-2.baseUrl \  --value "https://your-api.example.com/v1" && \openclaw config set \  --key models.providers.custom-your-api-example-com-2.apiKey \  --value "你的API密钥" && \openclaw config set \  --key models.providers.custom-your-api-example-com-2.models[0].id \  --value "gpt-5.2"

明：openclaw config set命令可直接修改指定配置项，无需进入交互式界面，参数--key对应配置路径，--value对应要设置的值。

配置文件修改

前置准备条件

找到 OpenClaw 核心配置目录
这里以windows 的WSL为例：~/.openclaw/config.json

步骤 1：梳理自定义模型的接入类型（选对应方案）

OpenClaw 支持 3 类自定义模型接入，先明确你的模型类型，再对应操作：

步骤 2：核心配置文件修改（以最常用的「第三方 API 模型」为例）

第一步，备份并打开 ~/.openclaw/config.json文件（注意，备份很重要）

第二步，将以下完整 JSON 模板粘贴到文件中同名配置项中，然后按注释提示修改「需要替换的参数」（仅改标红部分，其余保留）：

{    "models": {    "mode": "merge",  // 固定值：多模型融合模式，无需修改    "providers": {      // 自定义提供商名称（可改，建议保留格式：custom-域名-序号）      "custom-your-api-example-com-2": {        "baseUrl": "https://your-api.example.com/v1",  // 【必填】替换为你的模型API基础地址        "apiKey": "xxxxx",  // 【必填】替换为你的模型调用密钥（绝对保密！）        "api": "openai-completions",  // 【必填】API兼容类型：openai-completions/openai-chat        "models": [          {            "id": "gpt-5.2",  // 【可选】模型唯一标识（前端显示的ID，自定义）            "name": "gpt-5.2 (Custom Provider)",  // 【可选】前端显示的模型名称，自定义            "reasoning": false,  // 固定值：是否开启推理，新手保持false            "input": ["text"],  // 固定值：模型仅支持文本输入，无需修改            "cost": {  // 固定值：本地/私有模型成本为0，无需修改              "input": 0,              "output": 0,              "cacheRead": 0,              "cacheWrite": 0            },            "contextWindow": 16000,  // 【可选】模型支持的最大上下文token数，按实际修改            "maxTokens": 4096  // 【可选】单次生成的最大token数，按实际修改          }        ]      }    }  }}

第三步：关键参数修改说明（新手重点看）

只需要改 3 个核心参数，其余保持默认即可：

第四步：保存并验证配置

保存修改后的 ~/.openclaw/config.json 文件：

进阶：新增多个自定义模型（可选）

如果需要同时配置多个模型，只需在providers节点下新增一段配置即可，示例：

{    "models": {    "mode": "merge",    "providers": {      // 第一个自定义模型（你的原有配置）      "custom-your-api-example-com-2": {        "baseUrl": "https://your-api.example.com/v1",        "apiKey": "xxxxx",        "api": "openai-completions",        "models": [{"id": "gpt-5.2", "name": "gpt-5.2 (Custom Provider)", ...}]      },      // 第二个自定义模型（新增）      "custom-qwen-api": {        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",        "apiKey": "你的千问密钥",        "api": "openai-chat",        "models": [{"id": "qwen-plus", "name": "通义千问Plus", ...}]      }    }  }}