|

OpenClaw 接入 Claude 的 2 种配置方式：OpenAI 兼容模式 vs Claude 原生格式完整教程

作者APIYI - Stable and affordable AI API

作者注：手把手教你在 OpenClaw 中配置 OpenAI 兼容模式和 Claude 原生格式两种接入方式，包含完整 JSON 配置代码、适用模型列表和关键差异对比

在 OpenClaw（Open WebUI）中接入大模型有两种方式：OpenAI 兼容模式（openai-completions）和 Claude 原生格式（anthropic-messages）。很多用户不清楚两者的区别，导致要么用错了格式接 Claude 模型，要么错过了原生格式带来的 Prompt Caching 等高级功能。

核心价值: 读完本文，你将掌握 OpenClaw 中两种接入方式的完整配置方法，明确每种模型该用哪种格式，并能直接复制配置代码使用。

openclaw-openai-compatible-vs-claude-native-config-guide 图示

OpenClaw 两种接入方式 核心对比

对比维度 OpenAI 兼容模式 Claude 原生格式
api 类型 openai-completions anthropic-messages
baseUrl https://api.apiyi.com/v1 https://api.apiyi.com
适用模型 GPT、Gemini、Grok、GLM、Kimi、DeepSeek、Minimax 等 Claude 系列（sonnet、opus、haiku）
是否需要额外 headers 不需要 需要 anthropic-version
Prompt Caching ✗ 不支持 ✓ 支持
Extended Thinking ✗ 不支持 ✓ 支持（thinking 模型）
URL 路径差异 末尾带 /v1 末尾不带 /v1

OpenClaw 两种接入方式的一句话总结

记住一个简单规则：Claude 系列模型用 anthropic-messages，其他所有模型用 openai-completions。两者最直观的区别是 baseUrl——OpenAI 兼容模式末尾带 /v1，Claude 原生格式不带。

OpenClaw OpenAI 兼容模式配置教程

OpenAI 兼容模式适用场景

OpenAI 兼容模式（openai-completions）是 OpenClaw 中最通用的接入方式，适用于所有非 Claude 的大模型。大多数 API 中转服务都使用这种标准化的 OpenAI 格式。

OpenAI 兼容模式完整配置代码

以下是通过 API易 接入 GPT-5.4 的完整配置：

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

查看多模型扩展配置

如果需要同时接入多个通用模型，可以在 models 数组中添加更多模型：

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

所有这些模型共用同一个 API Key 和 baseUrl，这就是 OpenAI 兼容模式的便利之处——一个配置接入所有通用模型。

OpenAI 兼容模式配置要点

配置项 值 说明
baseUrl https://api.apiyi.com/v1 必须带 /v1
api openai-completions 指定使用 OpenAI 兼容协议
apiKey sk-你的密钥 在 API易 apiyi.com 获取
models[].id 模型 ID 必须与 API 支持的模型名一致

🎯 配置提醒: baseUrl 末尾的 /v1 不能省略，这是 OpenAI 兼容协议的标准路径。访问 API易 apiyi.com 注册即可获取 API Key 和免费额度。

OpenClaw Claude 原生格式配置教程

Claude 原生格式适用场景

Claude 原生格式（anthropic-messages）是 Claude 系列模型的专属接入方式。使用原生格式可以获得 Prompt Caching、Extended Thinking、PDF 处理等 Claude 独有的高级功能。

Claude 原生格式完整配置代码

以下是通过 API易 接入 Claude 模型的完整配置：

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

查看包含 Opus 和 Haiku 的完整配置 
{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Claude 原生格式配置要点

配置项 值 说明
baseUrl https://api.apiyi.com 不带 /v1，这是关键差异
api anthropic-messages 指定使用 Claude 原生协议
headers.anthropic-version 2023-06-01 Anthropic API 版本号，必填
headers.anthropic-beta "" 留空即可，用于启用 Beta 功能
contextWindow 200000 Claude 系列支持 200K 上下文
maxTokens 16384 最大输出 Token 数

🎯 关键区别: Claude 原生格式的 baseUrl 不带 /v1。这是新手最容易犯的错误——如果 Claude 接入报错，先检查 URL 末尾是否误加了 /v1。

OpenClaw 两种格式同时使用配置

在实际使用中，你很可能需要同时使用通用模型和 Claude 模型。这时需要在 OpenClaw 中配置两个 provider：

OpenClaw 双 Provider 配置架构 同一个 API Key，两种格式并行使用

API易 apiyi.com 同一个 API Key

Provider: "apiyi"

api: “openai-completions”

baseUrl: api.apiyi.com/v1

可用模型:

gpt-5.4

deepseek-v3.2

gemini-3-flash

glm-5

kimi-k2.5

grok-4

✓ 通用模型全部用这个 Provider

Provider: "apiyi-claude"

api: “anthropic-messages”

baseUrl: api.apiyi.com （不带 /v1）

可用模型:

claude-sonnet-4-6

claude-opus-4-6

claude-sonnet-4-6-thinking

claude-haiku-4-5-20251001

✓ Claude 系列专用，完整高级功能

推荐 API易：稳定可靠的 AI大模型API中转站，价格便宜、免费试用

双 Provider 合并配置代码

将两种格式的 provider 写在同一个配置文件中，在 OpenClaw 中即可自由切换模型：

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 重要说明: 两个 provider 可以使用同一个 API Key。API易 apiyi.com 的同一个密钥同时支持 OpenAI 兼容格式和 Claude 原生格式，无需申请多个 Key。

OpenClaw 两种格式常见错误排查

配置过程中最容易出错的地方是 baseUrl 和 api 类型不匹配。以下是常见错误及解决方案：

openclaw-openai-compatible-vs-claude-native-config-guide 图示

错误类型 错误配置 正确配置 错误现象
Claude 用错格式 api: openai-completions api: anthropic-messages 能对话但丢高级功能
baseUrl 多了 /v1 api.apiyi.com/v1 + anthropic api.apiyi.com + anthropic 404 或连接错误
缺少 headers 无 anthropic-version "2023-06-01" 400 Bad Request
通用模型少了 /v1 api.apiyi.com + openai api.apiyi.com/v1 + openai 路径错误
模型名写错 claude-4-sonnet claude-sonnet-4-6 模型不存在

🎯 快速排错口诀: OpenAI 格式带 /v1，Claude 格式不带 /v1。记住这一点就能避免 80% 的配置错误。如果遇到其他问题，可以访问 API易 apiyi.com 的文档中心查看完整的接入指南。

常见问题

Q1: 为什么不能用 OpenAI 兼容模式接 Claude？

技术上可以（Claude 也有 OpenAI 兼容端点），但会损失 Prompt Caching（节省 90% 输入成本）、Extended Thinking（深度推理输出）、PDF 处理、Citations 引用等重要功能。对于日常聊天没有影响，但生产环境和长对话场景下成本差距显著。在 OpenClaw 中使用 anthropic-messages 原生格式是更优选择。

Q2: 两个 Provider 可以用同一个 API Key 吗？

可以。API易 apiyi.com 的同一个 API Key 同时支持 OpenAI 兼容格式和 Claude 原生格式。在配置中，apiyi 和 apiyi-claude 两个 provider 填写相同的 apiKey 值即可。不需要申请两个不同的密钥。

Q3: OpenClaw 中如何切换不同的模型？

配置好双 Provider 后，在 OpenClaw 的对话界面中可以直接在模型选择下拉框中看到所有已配置的模型。通用模型会显示为 apiyi/gpt-5.4 等，Claude 模型会显示为 apiyi-claude/claude-sonnet-4-6 等。点击即可切换，无需修改配置文件。

总结

OpenClaw 两种接入方式的核心要点：

  1. 通用模型用 openai-completions: GPT、Gemini、DeepSeek、GLM、Kimi、Grok、Minimax 等所有非 Claude 模型，baseUrl 带 /v1
  2. Claude 系列用 anthropic-messages: claude-sonnet-4-6、claude-opus-4-6、claude-haiku 等，baseUrl 不带 /v1，需要 anthropic-version header
  3. 两个 Provider 并存是最佳实践: 同一个 API Key 配置两个 provider，在 OpenClaw 中自由切换所有模型

推荐通过 API易 apiyi.com 获取 API Key，一个密钥即可接入 GPT、Claude、Gemini、DeepSeek 等全部主流模型，支持 OpenAI 兼容和 Claude 原生两种格式。

📚 参考资料

  1. API易帮助中心: OpenClaw 接入配置完整教程

    • 链接: help.apiyi.com
    • 说明: 包含各站点的详细接入文档和最新模型列表

  2. Anthropic API 文档: Claude 原生 API 格式规范

    • 链接: platform.claude.com/docs/en/api/messages
    • 说明: Messages API 的完整参数和响应格式

  3. OpenAI SDK 兼容性文档: 哪些参数在 Claude 上被忽略

    • 链接: platform.claude.com/docs/en/api/openai-sdk
    • 说明: 支持和不支持的参数完整列表

  4. Open WebUI 文档: OpenClaw 多 Provider 配置指南

    • 链接: docs.openwebui.com
    • 说明: Provider 配置、模型管理和 Agent 设置

作者: APIYI 技术团队
技术交流: 欢迎在评论区讨论，更多资料可访问 API易 docs.apiyi.com 文档中心

Try AI Large Model https://api.apiyi.com for free
Stable and reliable AI LM API aggregation service, Get 300 Millions Tokens for Free~

类似文章