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

作者注：手把手教你在 OpenClaw 中配置 OpenAI 兼容模式和 Claude 原生格式兩種接入方式，包含完整 JSON 配置代碼、適用模型列表和關鍵差異對比

在 OpenClaw（Open WebUI）中接入大模型有兩種方式：OpenAI 兼容模式（openai-completions）和 Claude 原生格式（anthropic-messages）。很多用戶不清楚兩者的區別，導致要麼用錯了格式接 Claude 模型，要麼錯過了原生格式帶來的 Prompt Caching 等高級功能。

核心價值: 讀完本文，你將掌握 OpenClaw 中兩種接入方式的完整配置方法，明確每種模型該用哪種格式，並能直接複製配置代碼使用。

OpenClaw 兩種接入方式 核心對比

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

OpenAI 兼容模式配置要點

🎯 配置提醒: 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
          }
        ]
      }
    }
  }
}

{
  "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 原生格式配置要點

🎯 關鍵區別: Claude 原生格式的 baseUrl 不帶 /v1。這是新手最容易犯的錯誤——如果 Claude 接入報錯，先檢查 URL 末尾是否誤加了 /v1。

OpenClaw 兩種格式同時使用配置

在實際使用中，你很可能需要同時使用通用模型和 Claude 模型。這時需要在 OpenClaw 中配置兩個 provider：

雙 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 類型不匹配。以下是常見錯誤及解決方案：

🎯 快速排錯口訣: OpenAI 格式帶 /v1，Claude 格式不帶 /v1。記住這一點就能避免 80% 的配置錯誤。如果遇到其他問題，可以訪問 API易 apiyi.com 的文檔中心查看完整的接入指南。

常見問題

總結

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 文檔中心