我们一般搜的是 OpenClaw Claude API、Claude API 接入教程，或者 OpenClaw 教程，多半不是为了看一堆概念，而是想把一个实际问题解决掉：到底怎么让 OpenClaw 正常调用 Claude？我应该用 Anthropic 官方 API Key，还是用 Claude 订阅 / Claude CLI？如果换成 ClaudeAPI 这类第三方兼容平台，又该怎么配？

这篇文章只聊 OpenClaw 接入 Claude 这一件事，不展开飞书机器人、MCP Bridge，也不顺带讲其他大模型平台。下面会把几种常见接入方式怎么选、配置怎么写、怎么验证是否成功、遇到报错怎么排查，以及使用第三方兼容服务时需要注意的地方都整理出来。

一、先想清楚：API Key、Claude 订阅、ClaudeAPI 到底选哪个？

开始改配置之前，最好先判断自己适合哪种接入方式。很多教程一上来就让你改 openclaw.json，但实际最容易卡住的地方往往是：我到底该用哪条路？

你的情况更推荐的方式简单说明已经有 Claude Pro / Max 订阅，只是在自己电脑上用Claude CLI / 订阅方式一般不需要单独申请 Anthropic API Key，不过会受订阅计划和登录状态影响要做服务端调用、自动化任务，或者团队部署Anthropic 官方 API Key这是更标准的 API 接入方式，适合生产环境，也方便控制计费和权限直连官方 API 不稳定，或者需要中文支持、企业充值、开票等ClaudeAPI 等第三方兼容平台配置更灵活，但要额外关注稳定性、安全性和协议兼容问题只是想先体验一下 OpenClaw先选低成本、低风险方案先把流程跑通，再考虑高级参数和正式部署

这里有个点很容易被误解：Claude 订阅不等于 Anthropic API 额度。也就是说，你买了 Claude Pro / Max，并不代表 Anthropic Console 里自动就有 API Key 可以用。Claude 订阅、官方 API 调用额度、第三方兼容服务，实际上是三套不同的体系。

二、接入前先检查这些东西

不管你最后选择哪种方式，建议先把下面几项确认好，免得后面排错时绕远路。

首先，OpenClaw 应该已经安装好，并且终端里能正常执行：

openclaw --version

另外，也要确认 OpenClaw 的基础命令可以正常运行。如果你准备走官方 API，就需要提前准备好 ANTHROPIC_API_KEY。如果你打算用 Claude CLI，那就先安装并登录 Claude CLI / Claude Code。

如果使用 ClaudeAPI 这类第三方兼容平台，则要提前看清楚平台文档，至少确认这些信息：

Base URL；

API Key；

协议类型，是 Anthropic Messages 兼容，还是 OpenAI Chat Completions 兼容；

模型 ID；

是否支持流式输出；

是否支持 thinking、cache、长上下文等 Claude 相关特性。

还有一个小建议：改配置之前，先备份当前的 openclaw.json。这个动作很简单，但真的能省掉不少麻烦。

三、方式一：用 Anthropic 官方 API Key 接入 Claude

这是最标准的一条 Claude API 接入教程 路线，更适合团队、服务端应用和自动化任务。

3.1 获取 Anthropic API Key

大致流程其实不复杂：

第一，登录 Anthropic Console；第二，创建一个 API Key；然后复制 Key，在本地或服务器上设置环境变量；接下来在 OpenClaw 里选择 Anthropic Provider；最后启动 OpenClaw，验证它是不是真的调用到了 Claude。

这里要特别注意，不要把 API Key 放进公开截图、GitHub 仓库、共享文档，或者任何别人能随便看到的地方。

3.2 设置环境变量

macOS / Linux 可以这样设置：

export ANTHROPIC_API_KEY="sk-ant-..."

Windows PowerShell 如果只是临时使用，可以这样写：

$env:ANTHROPIC_API_KEY="sk-ant-..."

如果希望持久保存，用：

setx ANTHROPIC_API_KEY "sk-ant-..."

不过 setx 有个细节要记住：设置完之后，当前终端一般不会立刻生效，需要重新打开 PowerShell 或 CMD。

3.3 用 openclaw onboard 绑定 API Key

第一次配置的话，最省心的方式是走交互式初始化：

openclaw onboard

然后根据提示选择 Anthropic / Claude 相关配置即可。

如果你已经提前设置好了环境变量，也可以直接用命令行参数：

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

简单来说，交互式方式更适合新手第一次配置；命令行方式更适合脚本化部署，或者在服务器上做初始化。

3.4 配置默认 Claude 模型

OpenClaw 一般可以在 openclaw.json 里设置默认模型，比如：

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet"      }    }  }}

有些配置里也会直接写环境变量或 Key，形式可能类似这样：

{  "env": {    "ANTHROPIC_API_KEY": "sk-ant-..."  },  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet"      }    }  }}

不过更推荐把 Key 放在本机或服务器的环境变量里，而不是明文写进 JSON 文件。至于具体模型 ID，最好以 OpenClaw 官方文档和 Anthropic 当前可用模型列表为准，因为模型名称和版本会变化。

四、方式二：通过 Claude CLI / Claude 订阅接入 OpenClaw

如果你已经有 Claude 订阅，而且只是自己在本地用 OpenClaw，那可以考虑 Claude CLI / 订阅方式。它的好处是不用额外管理 Anthropic API Key，对个人工作流来说比较方便。

但它也不是万能方案。尤其是团队生产服务，不建议直接把个人 Claude 订阅当作统一后端来用。

通常可以按这个思路配置：

先安装 Claude CLI / Claude Code，并完成本地登录；然后在 OpenClaw 里把 Claude 模型的 runtime 指向 claude-cli；最后启动 OpenClaw，确认调用路径没有问题。

示例配置如下：

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet"      },      "models": {        "anthropic/claude-sonnet": {          "agentRuntime": {            "id": "claude-cli"          }        }      }    }  }}

这种方式更适合个人使用，比如本地代码辅助、文档分析，或者一些轻量自动化任务。需要记住的是，它通常会受到 Claude 订阅计划、本地登录状态等因素影响，并不等同于官方 API Key 调用。

五、方式三：使用 ClaudeAPI 等第三方兼容平台接入

如果你的网络环境、支付方式，或者企业采购流程不太适合直接使用 Anthropic 官方 API，那么 ClaudeAPI 这类第三方 Claude API 兼容平台也可以作为一个备选方案。

但边界要说清楚：ClaudeAPI 不是 Anthropic 官方服务。这类平台通常会提供兼容接口、多线路、中文支持、企业充值、开票，以及一些基础技术协助。不过它到底支持哪些模型、价格和额度如何、稳定性怎么样、协议是否完全兼容，都要以平台最新文档为准。

5.1 先确认它到底是哪种协议

第三方平台常见有两类：

类型特点配置时重点看什么Anthropic Messages 兼容更接近 Claude 官方 API 格式要使用 Anthropic 协议，对应 Base URL 和模型 IDOpenAI-compatible用 OpenAI Chat Completions 的风格调用 Claude模型 ID、字段名、流式输出方式可能都不一样

不要只看到平台写了“支持 Claude”，就直接照搬官方 Anthropic 的配置。你需要看清楚服务商文档里到底要求写 base_url、baseUrl，还是在 Provider 层配置；另外也要确认模型 ID 是否需要加平台前缀。

5.2 第三方兼容配置示例

下面只是一个示意模板，具体字段名还是要以 OpenClaw 当前版本和平台文档为准。

如果平台提供的是 Anthropic Messages 兼容接口，可能类似这样：

{  "providers": {    "claudeapi": {      "type": "anthropic-messages",      "baseUrl": "https://claudeapi.com",      "apiKey": "your-api-key"    }  },  "agents": {    "defaults": {      "model": {        "primary": "claudeapi/claude-sonnet"      }    }  }}

如果平台提供的是 OpenAI-compatible 接口，配置可能会变成这样：

{  "providers": {    "claudeapi-openai": {      "type": "openai-chat-completions",      "baseUrl": "https://claudeapi.com/v1",      "apiKey": "your-api-key"    }  },  "agents": {    "defaults": {      "model": {        "primary": "claudeapi-openai/claude-sonnet"      }    }  }}

这两个模板不要混着用。协议一旦不匹配，就很容易出现 400、403、404、模型不存在，或者流式输出异常这类问题。

六、Claude 模型 ID 怎么选？

在 OpenClaw 里，通常会通过 agents.defaults.model.primary 来指定默认模型。模型 ID 的格式一般像这样：

anthropic/模型名

如果使用第三方平台，也可能是：

provider/模型名

怎么选模型，可以简单参考下面的思路：

使用场景选择建议代码生成、复杂推理选能力更强的 Claude Opus / Sonnet 类模型日常问答、轻量任务选速度和成本更均衡的 Sonnet / Haiku 类模型长文档分析选支持长上下文的 Claude 模型成本比较敏感优先考虑低价模型、订阅方式，或者谨慎评估第三方平台成本

不太建议在配置里长期写死所谓“最新最强模型”。Claude 的模型版本更新比较快，稳妥做法是定期查看 Anthropic、OpenClaw 或第三方平台的最新模型列表。

七、一些高级参数：thinking、cacheRetention、长上下文

部分 OpenClaw 版本或者 Claude Provider 会支持一些 Claude 相关高级参数，比如：

thinking：更适合复杂推理任务，不过可能会增加消耗；

cacheRetention：适合重复上下文比较多的场景，可以帮助复用缓存；

长上下文参数：适合大文档、大代码库分析，但要确认模型和账号确实支持。

这些参数不用一开始就全部打开。对新手来说，比较稳的做法是先把基础 Claude API 接入跑通，再根据任务类型一点点调整。这样出了问题也更容易定位。

八、怎么确认 OpenClaw 已经成功调用 Claude？

配置完成后，不要只看“没报错”就觉得一定成功了。更靠谱的验证方式是按下面几步检查。

先启动 OpenClaw，然后看看当前默认模型是不是 anthropic/...，或者你自己配置的第三方 Provider。接着发起一次简单测试请求，再去日志里确认是否出现了对应的模型 ID。

如果你用的是 Claude CLI，要确认 runtime 是 claude-cli。如果你使用 ClaudeAPI 这类第三方平台，就要看请求是不是打到了自定义 Base URL。走官方 API 的话，也可以到 Anthropic Console 里查看调用记录或消耗情况。

如果你改完配置后发现没有任何变化，优先检查两个地方：一是 OpenClaw 读取的到底是不是你修改的那个 openclaw.json；二是 OpenClaw 是否需要重启。

九、常见错误和排查方法错误现象可能原因解决方法401 UnauthorizedAPI Key 写错、过期，或者没有生效重新生成 Key，并检查环境变量是否正确403 Forbidden权限不足、模型不可用，或者 Provider 前缀写错检查账号权限、模型 ID 和配置路径404 model not found模型 ID 写错，或者平台不支持该模型对照官方或服务商模型列表修改429 rate limitRPM / TPM 或并发超限降低并发，调整任务频率，或者升级额度连接超时网络、代理、DNS 或 Base URL 有问题检查网络环境、代理设置和服务商地址JSON parse erroropenclaw.json 格式不合法用 JSON 校验工具检查逗号、引号和括号Windows 环境变量不生效用 setx 后没有重启终端重新打开 PowerShell 或 CMD配置修改无效读取了其他配置文件，或者 OpenClaw 没重启确认配置文件路径，并重启 OpenClawClaude CLI 不生效CLI 未登录，或 runtime 配置错误重新登录 Claude CLI，检查 agentRuntime第三方中转报错协议、模型 ID、Base URL 不匹配对照平台文档确认是 Anthropic-compatible 还是 OpenAI-compatible十、安全和最佳实践

不管你用的是 Anthropic 官方 API Key、Claude CLI，还是 ClaudeAPI 这类第三方兼容平台，安全问题都不能忽视。

首先，不要把 sk-ant-... 或任何 API Key 提交到 GitHub。截图、录屏、日志分享时，也要记得打码。像 .env、openclaw.json 这类可能包含密钥的文件，建议加入 .gitignore。

生产环境里，最好使用环境变量、Secret Manager、Vault 这类密钥管理方式，而不是把 Key 明文写进配置文件。团队部署时，也不要共用某个成员的个人 Claude 订阅。

如果使用第三方中转平台，更要谨慎处理数据边界。不建议把敏感代码、客户数据、密钥，或者没有脱敏的业务内容直接发过去。另外，Key 最好定期轮换，不同环境使用不同密钥；日志系统里也尽量避免记录完整请求内容和密钥信息。

十一、总结：不同用户怎么选更合适？

如果你是个人用户，而且已经有 Claude 订阅，可以先尝试 Claude CLI / 订阅方式。它配置简单，比较适合本地使用。

如果你打算把 OpenClaw 用在服务端、团队自动化，或者生产环境里，优先考虑 Anthropic 官方 API Key。这是最标准、边界也最清楚的 Claude API 接入方式。

如果你需要中文支持、企业充值、开票、多线路选择，或者网络环境无法稳定访问官方 API，那么可以评估 ClaudeAPI 等第三方 Claude API 兼容平台。不过一定要确认协议类型、模型 ID、Base URL，以及相关安全风险。

对新手来说，最稳妥的路线其实很简单：先选一种方式把 Claude 调用跑通，再配置默认模型。等基础流程稳定后，再根据具体任务慢慢调整 thinking、cacheRetention、长上下文这些高级参数。