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 字段成對配置的思路。