OpenClaw 安装与配置教程：自定义模型服务商接入 API 快连（openclaw.json）
更新于
OpenClaw 是一个开源的个人 AI 助手，在本机运行网关，可以连接聊天软件、执行任务。它支持在配置文件里添加自定义的 OpenAI 兼容服务商。这篇讲清楚怎么安装、在 openclaw.json 里怎么写、怎么设为默认模型和验证。
📌
一句话答案：在
~/.openclaw/openclaw.json 的 models.providers 里新增一个服务商：baseUrl 填 https://apikl.ai/v1，api 填 openai-completions，并在 models 里列出要用的模型；再把 agents.defaults.model.primary 设为 apikl/gpt-5.6-sol。第一步：安装 OpenClaw
OpenClaw 最新版需要 Node.js 24（24.22.1 以上）或 26（26.12.1 以上），不支持 25，版本不对先看 Node.js 安装教程。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows · PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
安装后运行 openclaw onboard --install-daemon 完成初始化（会安装后台网关服务），再用 openclaw --version 和 openclaw doctor 确认一切正常。
第二步：添加 API 快连服务商
编辑 ~/.openclaw/openclaw.json（Windows 在用户目录下的 .openclaw 文件夹），加入下面的 models 和 agents 段。如果文件里已有这些字段，只合并新增的部分：
~/.openclaw/openclaw.json
{ models: { mode: "merge", providers: { apikl: { baseUrl: "https://apikl.ai/v1", apiKey: "sk-你的密钥", api: "openai-completions", models: [ { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", contextWindow: 200000, maxTokens: 32000 }, ], }, }, }, agents: { defaults: { model: { primary: "apikl/gpt-5.6-sol" } }, },}
| 字段 | 作用 |
|---|---|
mode: "merge" | 保留 OpenClaw 自带的服务商，只追加 API 快连 |
baseUrl | API 快连的 OpenAI 兼容地址，必须带 /v1 |
apiKey | 你的密钥。只放在本机配置文件里，不要上传或分享这个文件 |
api: "openai-completions" | 使用 OpenAI Chat Completions 格式 |
models | 必须列出要用的模型，否则选不到；id 要和平台上的模型名完全一致 |
primary | 默认模型，格式是「服务商名/模型名」 |
💡
models 里每个模型都要一一列出。一把密钥只对应一个分组，所以 GPT 和 Claude 要分成两个服务商，各填各的密钥。想同时用 Claude 模型，在 providers 里再加一个服务商（填 Claude 分组的密钥），用的时候选 apikl-claude/claude-sonnet-5-5：
providers 里追加
"apikl-claude": { baseUrl: "https://apikl.ai/v1", apiKey: "sk-Claude分组的密钥", api: "openai-completions", models: [ { id: "claude-sonnet-5-5", name: "Claude Sonnet 5.5", contextWindow: 200000, maxTokens: 32000 }, ], },
第三步：重启并验证
BASH
openclaw gateway restartopenclaw models listopenclaw doctor
openclaw models list 里能看到 apikl/gpt-5.6-sol 就说明配置已加载；然后在 OpenClaw 里发一条消息，能正常回复即接通。
模型选择
- 日常任务：
gpt-5.6-sol或claude-sonnet-5-5。 - 复杂任务：
gpt-6.1-sol或claude-opus-5-5。 contextWindow、maxTokens写的是 OpenClaw 用来规划上下文的数值，上面给的是稳妥值，一般不用改。
常见报错
- 找不到模型 / 列表里没有 apikl：
models数组没写，或改完没有执行openclaw gateway restart。 - 401 invalid_api_key：apiKey 填错，或 baseUrl 不是 API 快连地址。看 401 排查。
- model not found：id 和平台模型名不一致，或密钥分组不对。看 模型不存在排查。
- 配置文件报格式错误：运行
openclaw doctor查看具体位置；也可以先openclaw gateway stop停掉网关，再用openclaw config set写入（新版要求网关停止时才能用这个命令），写完openclaw gateway start。