OpenClawでClaudeに接続する2つの設定方法：OpenAI互換モード vs Claudeネイティブ形式完全チュートリアル

著者注：OpenClawでOpenAI互換モードとClaudeネイティブフォーマットの2種類の接続方法を、完全なJSON設定コード、対応モデルリスト、主要な違いの比較を含めて詳しく解説します。

OpenClaw（Open WebUI）で大規模言語モデルに接続する方法には、OpenAI互換モード（openai-completions）とClaudeネイティブフォーマット（anthropic-messages）の2種類があります。多くのユーザーはこの2つの違いを理解しておらず、Claudeモデルに間違ったフォーマットで接続したり、ネイティブフォーマットが提供するPrompt Cachingなどの高度な機能を見逃したりしています。

本記事の価値: この記事を読み終えると、OpenClawにおける2つの接続方法の完全な設定方法を習得し、どのモデルにどのフォーマットを使用すべきかを明確に理解し、設定コードを直接コピーして使用できるようになります。

OpenClaw モデル接続方式 OpenAI互換モード vs Claudeネイティブフォーマット

OpenClaw WebUI ゲートウェイ

OpenAI 互換モード

openai-completions

APIタイプ

対応モデル GPT Gemini Grok GLM

Kimi DeepSeek Minimax

末尾に /v1 を含むベースURL

Claudeモデルには非互換

Claude ネイティブフォーマット

anthropic-messages

APIタイプ

対応モデル Claude Sonnet Claude Opus

Claude Haiku

末尾に /v1 を含まないベースURL

GPT/Gemini には非互換

APIYI (apiyi.com) で利用可能

OpenClaw 2つの接続方式 主要比較

OpenClaw 2つの接続方式の一言まとめ

簡単なルールを覚えましょう：Claude シリーズモデルには anthropic-messages を、それ以外のすべてのモデルには openai-completions を使用します。両者の最も直感的な違いは baseUrl です。OpenAI互換モードは末尾に /v1 が付き、Claudeネイティブフォーマットには付きません。

OpenClaw OpenAI互換モード設定チュートリアル

OpenAI互換モードの適用シナリオ

OpenAI互換モード（openai-completions）は、OpenClawで最も汎用的な接続方式であり、Claude以外のすべての大規模言語モデルに適用できます。ほとんどのAPI中継サービスは、この標準化されたOpenAI形式を使用しています。

OpenAI互換モードの完全な設定コード

以下は、APIYIを通じて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互換プロトコルの標準パスです。APIYI apiyi.comにアクセスして登録すると、APIキーと無料枠を取得できます。

OpenClaw Claudeネイティブ形式設定チュートリアル

Claudeネイティブ形式の適用シナリオ

Claudeネイティブ形式（anthropic-messages）は、Claudeシリーズモデルの専用接続方式です。ネイティブ形式を使用することで、Prompt Caching、Extended Thinking、PDF処理など、Claude独自の高度な機能を利用できます。

Claudeネイティブ形式の完全な設定コード

以下は、APIYIを通じて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 での2種類のフォーマットの同時使用設定

実際の使用では、汎用モデルとClaudeモデルを同時に使用する必要がある場合がほとんどです。この場合、OpenClawで2つのプロバイダーを設定する必要があります：

2つのプロバイダーの統合設定コード

2種類のフォーマットのプロバイダーを同じ設定ファイルに記述することで、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
          }
        ]
      }
    }
  }
}

🎯 重要事項: 2つのプロバイダーは同じAPIキーを使用できます。APIYI apiyi.comの同じキーはOpenAI互換フォーマットとClaudeネイティブフォーマットの両方をサポートしており、複数のキーを申請する必要はありません。

OpenClaw 2種類のフォーマットのよくあるエラーとトラブルシューティング

設定中に最も間違いやすいのは baseUrlとapiタイプの不一致です。以下はよくあるエラーとその解決方法です：

🎯 クイックトラブルシューティングの口訣: OpenAIフォーマットは/v1付き、Claudeフォーマットは/v1なし。この点を覚えておけば、設定エラーの80%を回避できます。他の問題に遭遇した場合は、APIYI apiyi.comのドキュメントセンターで完全な接続ガイドを参照してください。

よくある質問

まとめ

OpenClawの2つの接続方法の核心ポイント：

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 ヘッダーが必要です。
3. 2つのプロバイダーを併存させるのがベストプラクティス: 同じAPIキーで2つのプロバイダーを設定し、OpenClaw内ですべてのモデルを自由に切り替えます。

APIYI apiyi.com を通じてAPIキーを取得することをお勧めします。1つのキーでGPT、Claude、Gemini、DeepSeekなどの主要なモデルすべてに接続でき、OpenAI互換とClaudeネイティブの2つのフォーマットをサポートします。

📚 参考資料

1. APIYIヘルプセンター: 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 マルチプロバイダー設定ガイド

   • リンク: docs.openwebui.com
   • 説明: プロバイダー設定、モデル管理、エージェント設定

著者: APIYI 技術チーム
技術交流: コメント欄での議論を歓迎します。詳細な資料は APIYI docs.apiyi.com ドキュメントセンターをご覧ください