OpenClaw 实战指南：配置第三方 API 接入大模型

OpenClaw 作为轻量高效的 AI Agent 调度平台，支持灵活的扩展性。官方默认配置仅支持有限接口，接入第三方 API 是更优解，能降低 token 消耗并规避网络环境限制。

一、前置准备

1. 已安装 OpenClaw（版本 ≥ 1.8.0，低于该版本请先执行 brew upgrade openclaw 升级）；
2. 已获取 API Key；
3. 熟悉基础的 JSON 语法。

二、核心配置流程

第一步：准确定位 OpenClaw 配置文件

OpenClaw 的所有模型、渠道配置都集中在 openclaw.json 文件中，不同操作系统的默认路径如下：

操作系统	配置文件默认路径	快速打开方式
Windows	C:\Users <你的用户名>.openclaw\openclaw.json	按 Win+R，输入路径直接跳转
macOS	~/.openclaw/openclaw.json	终端执行 `open ~/.openclaw/openclaw.json`
Linux	~/.openclaw/openclaw.json	终端执行 `vim ~/.openclaw/openclaw.json`

提示：如果找不到文件，先执行 openclaw init 初始化配置（执行后会自动生成配置文件）。

第二步：添加自定义 Provider

我们需要在 openclaw.json 中定义「能用 AI API」的 Provider，让 OpenClaw 大模型。具体操作如下：

1. 用文本编辑器打开 openclaw.json；
2. 找到 models.providers 节点（如果没有，直接新增该层级）；
3. 复制以下 JSON 代码片段，粘贴到 providers 中（注意替换 API Key）：

{
  "meta": {
    "lastTouchedVersion": "2026.2.26",
    "lastTouchedAt": "2026-02-28T12:23:56.399Z"
  },
  "wizard": {
    "lastRunAt"