跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI

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

如何在 OpenClaw 平台中通过修改配置文件接入第三方 API 以使用 Claude 系列模型。主要步骤包括定位 openclaw.json 文件、添加自定义 Provider 配置、设置默认调用模型以及重启网关验证。配置过程中需注意 contextWindow 参数调整及 api 协议凭证的正确填写，同时确保 API Key 安全。

安卓系统发布于 2026/4/6更新于 2026/5/2226 浏览
OpenClaw 配置第三方 API 接入 Claude 模型指南

前置准备

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

配置文件定位

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

操作系统配置文件默认路径快速打开方式
WindowsC:\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）：

文章配图

{
  "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
}
]
}
}
}
}

注意：需修改 contextWindow 参数为 200000，否则可能报错。api: "anthropic-messages" 是识别第三方中转接口的协议凭证，填写错误会导致路由失败。

文章配图

设置默认调用模型

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

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

文章配图

保存并验证

完成以上修改后，保存文件。OpenClaw 支持热重载，但部分配置修改后建议重启网关才能生效。

  1. 重启 OpenClaw 网关： 
    openclaw gateway stop
openclaw gateway --port 18789
  2. 验证模型挂载状态： 
    openclaw models status

文章配图

目录

  1. 前置准备
  2. 配置文件定位
  3. 添加自定义 Provider
  4. 设置默认调用模型
  5. 保存并验证
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Flutter 三方库 bavard 鸿蒙化适配：聊天协议与机器人逻辑
  • 解决 Spring Boot 项目中 JUnit NoSuchMethodError 报错
  • Spring AI 框架核心使用指南
  • AI 应用架构师优化模型训练效率的 10 个实战技巧
  • Flutter 应用架构演进：从 v1.0 基础骨架到 v2.0 Riverpod 实战
  • Python 入门基础与职业发展指南
  • 基于 Spring Boot 的智能客服机器人系统设计与实现
  • 使用 Google Colab 部署 LLaMA-13B 及 LangChain 实战
  • 深度学习八大经典神经网络架构详解与实战指南
  • Java 数据类型、运算符和方法重点总结
  • 大模型实践技术总结：集群、训练、微调与推理
  • GitHub Copilot 接入第三方 OpenAI 兼容模型方案
  • 从零搭建 AI 系统权限控制系统
  • 自动驾驶指令理解模型：Llama-Factory垂直领域适配
  • 主流 AI IDE 与编程工具对比及选型建议
  • 医疗连续体机器人模块化控制界面设计与 Python 库应用（下）
  • Ubuntu 24.04 向日葵连接失败解决方法
  • 安卓案例：利用定时器实现逐帧动画
  • 渐进式 AIGC 系统：多模态大模型与 Agent 智能体私有化部署方案
  • Qoder AI 编码工具功能详解

相关免费在线工具

  • 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