跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

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

介绍如何在 OpenClaw 平台中配置第三方 API 以接入 Claude 大模型。主要步骤包括：安装并升级 OpenClaw，获取 API Key，定位并编辑 openclaw.json 配置文件，添加自定义 Provider 节点，设置默认调用模型，最后重启网关验证状态。通过修改 contextWindow 参数和 api 协议类型，可实现低成本、高稳定的模型调用，规避网络限制。

修罗发布于 2026/4/6更新于 2026/9/971 浏览
OpenClaw 实战指南：配置第三方 API 接入 Claude 模型

OpenClaw 作为轻量高效的 AI Agent 调度平台，凭借灵活的扩展性成为开发者连接多模型的首选工具。但官方默认配置仅支持有限接口，对于追求低成本、高稳定性的开发者来说，接入第三方 API 是更优解 —— 不仅能大幅降低 token 消耗，还能规避网络环境限制，无缝适配 Claude 全系列模型。

文章配图

一、前置准备

  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」，让 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"
:
"2026-02-28T12:23:56.381Z"
,
"lastRunVersion"
:
"2026.2.26"
,
"lastRunCommand"
:
"onboard"
,
"lastRunMode"
:
"local"
}
,
"models"
:
{
"mode"
:
"merge"
,
"providers"
:
{
"custom-ai-nengyongai-cn"
:
{
"baseUrl"
:
"https://ai.nengyongai.cn/v1"
,
"apiKey"
:
"sk-your-api-key"
,
"api"
:
"anthropic-messages"
,
"models"
:
[
{
"id"
:
"claude-3-7-sonnet-latest"
,
"name"
:
"claude-3-7-sonnet-latest (Custom Provider)"
,
"reasoning"
:
false
,
"input"
:
[
"text"
]
,
"cost"
:
{
"input"
:
0
,
"output"
:
0
,
"cacheRead"
:
0
,
"cacheWrite"
:
0
}
,
"contextWindow"
:
200000
,
"maxTokens"
:
4096
}
]
}
}
}
,
"agents"
:
{
"defaults"
:
{
"model"
:
{
"primary"
:
"custom-ai-nengyongai-cn/claude-3-7-sonnet-latest"
}
,
"models"
:
{
"custom-ai-nengyongai-cn/claude-3-7-sonnet-latest"
:
{
"alias"
:
"claude-3.7-sonnet"
}
}
,
"workspace"
:
"/Users/sd/.openclaw/workspace"
,
"compaction"
:
{
"mode"
:
"safeguard"
}
,
"maxConcurrent"
:
4
,
"subagents"
:
{
"maxConcurrent"
:
8
}
}
}
,
"messages"
:
{
"ackReactionScope"
:
"group-mentions"
}
,
"commands"
:
{
"native"
:
"auto"
,
"nativeSkills"
:
"auto"
,
"restart"
:
true
,
"ownerDisplay"
:
"raw"
}
,
"session"
:
{
"dmScope"
:
"per-channel-peer"
}
,
"gateway"
:
{
"port"
:
18789
,
"mode"
:
"local"
,
"bind"
:
"loopback"
,
"auth"
:
{
"mode"
:
"token"
,
"token"
:
"ec42ee176abcc18a943718bcd9f80d7635765571b2ab50d5"
}
,
"tailscale"
:
{
"mode"
:
"off"
,
"resetOnExit"
:
false
}
,
"nodes"
:
{
"denyCommands"
:
[
"camera.snap"
,
"camera.clip"
,
"screen.record"
,
"calendar.add"
,
"contacts.add"
,
"reminders.add"
]
}
}
}

注意：我们需要修改 contextWindow 这个参数，原先是 4096 我们需要改为 200000，要不然会报错。

文章配图

配置提示：api: "anthropic-messages" 是核心关键！这是 OpenClaw 识别第三方中转接口的「协议凭证」，填写错误会导致路由失败。

第三步：设置默认调用模型（让 OpenClaw 优先使用其他 API）

仅添加 Provider 还不够，需要明确告知 OpenClaw「优先调用哪个模型」，避免路由到官方接口。操作如下：

  1. 在 openclaw.json 中找到 agents.defaults 节点；
  2. 新增 / 修改 model.primary 字段，格式为「Provider 名称 / 模型 ID」（必须与第二步的配置一致）：

文章配图

第四步：保存配置文件

完成以上修改后，按 Ctrl+S（Windows）或 Cmd+S（macOS）保存文件，此时配置已初步生效。

三、配置生效与验证（关键步骤，确认接入成功）

1. 重启 OpenClaw 网关（确保配置加载）

OpenClaw 支持热重载，但部分配置修改后需要重启网关才能生效，执行以下命令：

openclaw gateway stop

停止服务后，启动服务：

openclaw gateway --port 18789

2. 验证模型挂载状态

通过命令行检查第三方模型是否已成功接入，执行：

openclaw models status

文章配图

目录

  1. 一、前置准备
  2. 二、核心配置流程（全程实操，复制即用）
  3. 第一步：准确定位 OpenClaw 配置文件
  4. 第二步：添加自定义 Provider（关键步骤，核心配置）
  5. 第三步：设置默认调用模型（让 OpenClaw 优先使用其他 API）
  6. 第四步：保存配置文件
  7. 三、配置生效与验证（关键步骤，确认接入成功）
  8. 1. 重启 OpenClaw 网关（确保配置加载）
  9. 2. 验证模型挂载状态

更多推荐文章

查看全部
  • ComfyUI 按需部署方案：低成本玩转 AI 绘画
  • 无人机操控模式详解：美日中三手型差异与选择
  • C++11 右值引用与移动语义详解：从性能瓶颈到零拷贝优化
  • 大模型面经：LoRA 原理与微调实战总结
  • OpenClaw + 本地 Ollama：个人 AI 助手实战指南
  • ChatGPT 降低 AIGC 率的指令策略与最佳实践
  • 基于 Docker 部署 Moltbot 私人 AI 助手指南
  • Git 2.50.1 Windows 64 位安装与配置指南
  • C++ 面向对象编程核心：继承机制深度解析
  • 大模型基础教程：核心概念与学习路径详解
  • MySQL 中 COUNT(*) 与 COUNT(1) 的区别及性能对比
  • Trae AI 编程工具实战：功能、对比与趋势
  • 用 C 语言从零实现 Linux Shell：原理与实践
  • OpenAI Whisper 语音转文本实战指南
  • MaxKB v1.4.0 发布：支持 OpenAI、Ollama 和本地向量模型
  • 用 Nginx 部署 Vue 项目全过程
  • 机器人 DH 参数模型与正运动学
  • Java JDK 安装与环境配置教程
  • 中国信通院 2024 大模型典型示范应用案例集与学习指南
  • P2P 网络（Peer-to-Peer Network）基础架构与区块链应用

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online