gateway

gateway

3.4 models - 模型配置 models 模块定义可用的 AI 模型提供商和具体模型。这里是你的"AI 军火库":

{ “models”: { “mode”: “merge”, “providers”: { “bailian”: { “api”: “openai-completions”, “apiKey”: “sk-sp-xxx”, “baseUrl”: “https://coding.dashscope.aliyuncs.com/v1", “models”: [ {“id”: “qwen3.5-plus”, “name”: “qwen3.5-plus”}, {“id”: “qwen3-max”, “name”: “qwen3-max”} ] }, “minimax”: { “api”: “openai-completions”, “apiKey”: “sk-api-xxx”, “baseUrl”: “https://api.minimaxi.com/v1", “models”: [ { “id”: “MiniMax-M2.5-highspeed”, “name”: “MiniMax-M2.5-highspeed”, “contextWindow”: 200000, “cost”: {“input”: 0.001, “output”: 0.004} } ] } } } } 配置说明:

api

  • API 兼容模式,openai-completions 最常用(万能钥匙) baseUrl
  • API 端点地址(门牌号) contextWindow
  • 上下文窗口大小(token 数,越大越能聊) cost
  • 计费标准,输入/输出每 token 价格(美元,钱包在滴血) models.mode 枚举值详解:

枚举值 说明 效果 merge 合并模式 将配置与默认模型列表合并 override 覆盖模式 完全替换默认模型列表 none 不加载 不使用此配置 api 枚举值详解:

枚举值 说明 适用提供商 openai-completions OpenAI 兼容 API 百炼、MiniMax、大多数国产模型 anthropic Anthropic 原生 API Claude 系列 gemini Google Gemini API Google 系列模型 💡 添加新模型提供商时,确保 baseUrl 和 apiKey 正确,否则调用会失败。别指望 AI 自己猜对你的配置!

4.3 配置 API 密钥 推荐做法 - 使用 .env 文件:

~/.openclaw/.env

DASHSCOPE_API_KEY=sk-sp-xxx MINIMAX_API_KEY=sk-api-xxx

openclaw.json 中引用

“models”: { “providers”: { “bailian”: { “apiKey”: “${DASHSCOPE_API_KEY}” } } } ⚠️ 切勿将真实 API 密钥直接写入配置文件并提交到版本控制!这是安全红线,别踩!