OpenClaw 添加自定义模型提供商踩坑记录

昨天给 OpenClaw 添加小米 MiMo Token Plan 模型提供商的时候，踩了好几个坑，记录一下。

背景

OpenClaw 支持自定义模型提供商，我想把 xiaomi-token-plan 加进去，这样就可以直接用小米的模型了，不用走 OpenRouter。

踩坑过程

1. 配置文件位置搞混了

一开始我以为配置都在 openclaw.json 里，但实际上 API Key 是存在另一个地方的：

openclaw.json → 定义模型配置和 auth profile 框架
agents/main/agent/auth-profiles.json → 存储实际的 API Key

这个设计其实挺合理的，把敏感信息和配置分开管理。

2. 模型配置字段不全

我一开始只写了最基本的字段，结果模型不显示。对比其他提供商的配置才发现，每个模型需要这些字段：

json 复制代码

{
  "id": "mimo-v2-pro",
  "name": "MIMO V2 Pro",
  "input": ["text"],
  "reasoning": false,
  "cost": {
    "input": 0,
    "output": 0,
    "cacheRead": 0,
    "cacheWrite": 0
  },
  "contextWindow": 200000,
  "maxTokens": 8192,
  "api": "openai-completions"
}

少了任何一个都可能导致模型不显示。

3. JSON 语法错误

第一个模型的 input 数组后面多了个逗号：

json 复制代码

"input": ["text"],  // ← 这个逗号导致 JSON 解析失败

虽然现代编辑器会提示，但复制粘贴的时候很容易忽略。

4. 三处配置缺一不可

要让模型真正出现在选择列表里，需要配置三个地方：

models.providers → 定义模型详情
agents.defaults.models → 添加模型别名
agents.defaults.model.fallbacks → 添加到 fallback 列表

少一个都不行。

最终配置

openclaw.json：

json 复制代码

{
  "auth": {
    "profiles": {
      "xiaomi-token-plan:default": {
        "provider": "xiaomi-token-plan",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "xiaomi-token-plan": {
        "baseUrl": "https://token-plan-cn.xiaomimimo.com/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "mimo-v2-pro",
            "name": "MIMO V2 Pro",
            "input": ["text"],
            "reasoning": false,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192,
            "api": "openai-completions"
          },
          {
            "id": "mimo-v2-omni",
            "name": "MIMO V2 Omni",
            "input": ["text"],
            "reasoning": false,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192,
            "api": "openai-completions"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "models": {
        "xiaomi-token-plan/mimo-v2-pro": {},
        "xiaomi-token-plan/mimo-v2-omni": {}
      },
      "model": {
        "fallbacks": [
          "xiaomi-token-plan/mimo-v2-pro",
          "xiaomi-token-plan/mimo-v2-omni"
        ]
      }
    }
  }
}

auth-profiles.json：

json 复制代码

{
  "xiaomi-token-plan:default": {
    "type": "api_key",
    "provider": "xiaomi-token-plan",
    "key": "你的API_KEY"
  }
}

总结

配置自定义模型提供商不难，但细节很多。主要就是：

API Key 和配置分开存储
模型字段要写全
JSON 语法要检查
三处配置要同步

希望这篇文章能帮到同样想添加自定义模型的朋友。