8. 接入模型提供商：给你的网关装上大脑

大脑从哪来

OpenClaw 装好后，默认就带一个内置运行时（官方现称 openclaw，老文档常叫 Pi）。它能直接回答不少问题，不用你额外准备什么。

但很多人想换更强的模型，或想用自己账户里的额度。这就要”接模型提供商（Provider）”。

大白话：Provider 就是”卖脑子”的厂家。OpenClaw 认得几家主流的：

• OpenAI：GPT 系列。
• Anthropic：Claude 系列。
• 本地模型：Ollama、LM Studio、vLLM、SGLang 等，跑在你自己机器上。

接云模型：核心是 API Key

云模型不在你电脑里，得靠一串 API Key 去厂家那里”打卡”。这串 Key 相当于密码，谁拿到都能用你的额度。

接法有两种思路。

思路一：用向导。 跑初始化时就会问你：

openclaw onboard

中途选厂家、走 OAuth 登录，基本一路回车。新手首选。

思路二：命令行授权。 装好后单独补：

# 查看当前已接的模型
openclaw models list

# 给某个厂家做授权登录（用 --provider 指定厂家）
openclaw models auth login --provider openai

# 切换默认模型
openclaw models set openai/gpt-5.4

Key 放哪才安全

这是最容易踩坑的地方。Key 有三种放法，安全等级从高到低：

1. 环境变量（最推荐）。在运行 OpenClaw 的机器上导出：

export OPENAI_API_KEY="sk-xxxxx"
export ANTHROPIC_API_KEY="sk-xxxxx"

配置文件里只写引用，不写明文：

{
  "models": {
    "providers": {
      "openai": {
        "apiKey": "${OPENAI_API_KEY}"
      }
    }
  }
}

2. 配置项里直接写。写在 models.providers.<id>.apiKey。能用，但明文留在本地配置文件，别传上网。

3. 写进脚本或代码硬编码。千万别这么做。

几个保命习惯：

• 配置文件加进 .gitignore，绝不进版本库。
• 怀疑 Key 泄露，立刻去厂家后台轮换（revoke）旧的。
• 多人共用机器，每人用自己的 Key，别混用。

自建兼容端点：Custom Provider

有些中转站、或公司内部的推理服务，协议和 OpenAI 兼容。这种用 Custom Provider 接：

{
  "models": {
    "providers": {
      "my-endpoint": {
        "baseUrl": "https://your-endpoint.example.com/v1",
        "apiKey": "${MY_ENDPOINT_KEY}",
        "models": [{ "id": "my-model", "name": "我的模型" }]
      }
    }
  }
}

关键三样：baseUrl（常见带 /v1）、apiKey、modelId。填完 openclaw gateway restart 生效。

接本地模型：以 Ollama 为例

不想花钱、或数据不想出本机，就用本地模型。思路一样：先让模型在本地跑起来，再让 OpenClaw 连它。

Ollama 默认在 11434 端口开了一个兼容 OpenAI 的接口：

{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "api": "openai-completions"
      }
    }
  }
}

LM Studio、vLLM、SGLang 同理，都是”本地起服务 + 填 baseUrl”。区别只在端口和是否要 Key（本地一般不用）。

能同时接好几个吗

能，而且很常见。providers 是个容器，可以既有 openai、又有 anthropic、还有 ollama，同时存在。

好处是：不同智能体可以指定不同模型。闲聊用便宜的快模型，写代码用强的模型。第 12 章会讲怎么按渠道、按用途分派。

接不上的常见原因

排错按这个顺序走一遍：

1. Key 错或过期：重新 models auth login，或检查环境变量是否真的生效。
2. 网络不通：云模型需要机器能访问厂家地址；本地模型确认服务真的在跑。
3. 配置没生效：改完配置别忘了 openclaw gateway restart。
4. 模型名写错：models list 看到的 id 才是合法值。

openclaw models list
openclaw gateway status
openclaw logs --follow

模型列表里能看到新接的款、状态是 connected，就成功了。