OpenClaw配置自定义AI模型

如果你要在 OpenClaw 里接入自定义 AI 模型，最稳的方式通常是：

确认上游接口协议
在 OpenClaw 配置里新增一个模型条目
用别名调用它
重启网关生效

这篇按真实可用的思路写，尽量不走模糊说法。

一、先判断你的模型属于哪种协议

OpenClaw 常见会接这几类：

OpenAI兼容接口
其它兼容协议 Messages 接口
其它由上游平台代理成兼容协议的接口

如果你的服务商给你的信息里有这些字段，通常就是 OpenAI兼容接口兼容：

base_url
api_key
model
Chat Completions 或 Responses 风格调用

如果它明确写的是其它兼容协议 / Messages API，那就按对应类型配。

---

二、配置前要准备好的信息

至少准备这几项：

模型名称

- 例如：qwen-plus、deepseek-chat、glm-4.5

API Key
Base URL

- 例如：https://api.example.com/v1

协议类型

- 例如：openai-completions 或 anthropic-messages

你想在 OpenClaw 里显示的模型别名

- 例如：my-coder

---

三、OpenClaw 里最常用的配置思路

你通常会在 OpenClaw 的模型配置中新增一个模型条目。

常见做法

apiType 选对应协议
baseURL 填你的上游地址
apiKey 填密钥
model 填真实模型名
alias 用来给自己记忆和切换

一个常见示意（OpenAI兼容接口兼容思路）

{
  "alias": "my-coder",
  "apiType": "openai-completions",
  "baseURL": "https://api.example.com/v1",
  "apiKey": "sk-xxxx",
  "model": "deepseek-chat"
}

实际字段名可能随你的 OpenClaw 当前配置结构略有不同，但核心就是这几项。

---

四、如果是其它兼容协议协议

如果你的上游本身就是其它兼容协议 Messages 风格，那思路一样，只是类型改成：

{
  "alias": "my-anthropic",
  "apiType": "anthropic-messages",
  "baseURL": "https://api.example.com",
  "apiKey": "sk-ant-xxxx",
  "model": "glm-4.5"
}

重点不是名字，而是：

协议要对上
base URL 要对上
模型名要与上游支持的一致

---

五、配置完成后重启 OpenClaw 网关

改完配置后，直接执行：

openclaw gateway restart

这是最常见也最稳的一步。

如果你只改了文件但没重启，很多时候新模型不会立即生效。

---

六、如何验证是否配置成功

可以从这几个角度检查：

1. 看模型是否能被选中

如果你在会话里能看到新别名或能指定该模型，说明配置至少被读到了。

2. 发一个最简单的问题测试

比如：

请只回复：配置成功

如果能正常返回，说明链路通了。

3. 如果失败，优先查这三类错误

Base URL 错了
协议类型选错了
模型名与上游不一致

很多“模型不可用”并不是模型本身不行，而是这三项之一没对上。

---

七、一个实用建议：给模型起稳定别名

不要每次都直接记服务商原始模型名。

比如你可以统一起：

my-fast
my-coder
my-long

这样以后如果你换上游，只改底层配置，不改使用习惯。

---

八、排错顺序建议

如果你配完不能用，建议按这个顺序查：

API Key 是否有效
Base URL 是否带了正确路径
模型名是否与上游完全一致
API 类型是否匹配协议
改完后是否执行了 openclaw gateway restart

这个顺序通常能最快定位问题。

---

九、一句话总结

OpenClaw 配置自定义模型的关键不是“填很多项”，而是把这 4 件事对齐：

协议类型
Base URL
API Key
模型名

只要这四项对上，再重启网关，大多数自定义模型都能接进去。