OpenClaw 配置
OpenClaw 是偏编程场景的终端 / Web UI 工具。它支持多种模型协议，所以配置重点不是只填一个地址，而是让 baseUrl 和 api 成对匹配。
官方信息 下载和文档以官方站点为准
这个工具是什么，用于什么
先确认协议怎么选
| 场景 | Base URL 怎么看 | api 字段怎么选 |
|---|---|---|
| OpenAI 原生 | 使用服务商给出的 OpenAI / OpenAI 兼容 API 地址，是否带 /v1 以后台为准 | openai-responses |
| Claude 原生 | 使用服务商给出的 Anthropic / Claude 接口地址 | anthropic-messages |
| Gemini 原生 | 使用服务商给出的 Google / Gemini 接口地址 | google-generative-ai |
| 兼容模式 | 服务商的 OpenAI 兼容接口地址 | openai-completions |
如果服务商页面分了 OpenAI、Claude、Gemini 三个接口，不要只复制域名，要把对应协议的完整地址一起复制。
配置片段参考
配置文件通常在 ~/.openclaw/openclaw.json。如果初始化向导无法正确填写中转站地址，可以先跳过模型选择，再手动编辑配置文件。
OpenClaw 单个 Provider 示例片段
"models": { "providers": { "mz-openai": { "baseUrl": "https://你的服务商API地址", "apiKey": "你的_Key", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "服务商后台模型 ID 或模型名", "name": "页面里显示的名称", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }保存后怎么检查
- 先只配置一个 Provider，不要一次添加很多模型。
- 进入测试项目，选择刚添加的模型。
- 发送最短问题，例如“请只回复配置成功”。
- 如果报协议错误，先核对 api 字段和 Base URL 是否来自同一类接口。
新手常见问题
| 现象 | 优先检查 | 处理 |
|---|---|---|
| 协议相关报错 | api 字段和 Base URL 是否匹配 | OpenAI、Claude、Gemini 不要混用；按服务商对应协议填写 |
| 模型列表为空 | 服务商是否支持拉取模型列表 | 拉取失败时手动填后台给出的模型 ID / 模型名 |
| 配置文件改了但不生效 | 是否编辑了 OpenClaw 实际读取的配置文件 | 重启 OpenClaw 后再测试；不要同时改多个配置位置 |
| Key 正确但仍失败 | 当前 Provider 的 auth 和 apiKey 字段 | 确认 Key 属于当前协议和当前服务商 |
OpenClaw 官网 查看工具介绍和入口。
OpenClaw 中转站配置参考 参考不同协议下 baseUrl 与 api 字段成对配置的思路。