OpenClaw 自定义模型接入：协议、目录与路由检查

OpenClaw 的模型接入需要同时处理供应商地址、模型目录和 Agent 的实际选择。只把一个兼容地址填进配置，不能说明当前会话已经切换过去。本文核验的是官方配置能力，没有对本站进行联通测试。

先选请求适配器

官方将自定义供应商放在 models.providers，其中 api 决定请求格式。Chat Completions 后端使用 openai-completions；只有服务明确支持 Responses 时，才选择 openai-responses。Anthropic Messages 也有独立适配器，不能因为模型名称带有某个厂商前缀就自动换协议。

注册一个独立供应商

以下地址仅作占位，本站没有提供这里展示的真实接口。密钥和模型也必须替换为正式服务确认的值。把片段合并到现有配置，保留原供应商，避免整份覆盖。实际密钥建议使用官方支持的秘密引用方式。

{
  "models": {
    "mode": "merge",
    "providers": {
      "guide": {
        "baseUrl": "https://80321.cn/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [{ "id": "YOUR_MODEL_ID", "name": "示例模型" }]
      }
    }
  }
}

不要照抄别人的上下文窗口、图像能力或成本数字。官方要求自定义路由的兼容能力按端点已核验的行为声明；写入配置并不会让后端获得工具调用或视觉能力。

看目录，也看当前选择

官方 CLI 提供以下检查与选择命令。第二行会改变默认模型，执行前应记录原值；这里仅展示操作，不代表已经执行。

openclaw models list
openclaw models set guide/YOUR_MODEL_ID
openclaw models status

status 不带 --probe 时不是模型请求测试，且不会检查聊天会话自己的模型覆盖。目录出现目标模型后，再在新会话确认实际模型选择，以一条不调用工具的短问题验证文本响应。

改了地址却仍走旧路由

官方说明，同名供应商在 Agent 的 models.json 中存在非空地址时，该地址优先于主配置。排查时先比较供应商 ID 和有效地址，不要盲目删除整个 Agent 目录。鉴权失败检查密钥来源；协议报错检查适配器；模型不存在则核对服务返回的精确 ID。

网络信任和工具权限分开验收

自定义 baseUrl 还会影响 OpenClaw 对该精确来源的网络信任，所以只配置可信的 HTTPS 目标。 文本响应正常后，在不含秘密的临时目录做一次经人工批准的只读工具任务。若流式工具参数无法解析，就停止接入评估，先修正后端契约；不要通过关闭证书校验、扩大网络访问范围或开放全部工具来掩盖问题。