|

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

ByAPIYI - Stable and affordable AI API

著者注：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つの接続方式 主要比較

比較項目 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）
追加ヘッダーが必要か 不要 anthropic-version が必要
Prompt Caching ✗ 未対応 ✓ 対応
Extended Thinking ✗ 未対応 ✓ 対応（thinking モデル）
URL パスの違い 末尾に /v1 を含む 末尾に /v1 を含まない

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配列にさらにモデルを追加できます：

{
  "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キーとbaseUrlを共有します。これがOpenAI互換モードの利便性です——1つの設定ですべての汎用モデルに接続できます。

OpenAI互換モード設定の要点

設定項目 値 説明
baseUrl https://api.apiyi.com/v1 /v1を必ず含める
api openai-completions OpenAI互換プロトコルを使用することを指定
apiKey sk-あなたのキー APIYI apiyi.comで取得
models[].id モデルID APIがサポートするモデル名と一致させる必要あり

🎯 設定リマインダー: 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
          }
        ]
      }
    }
  }
}

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 最大出力トークン数

🎯 重要な違い: Claudeネイティブ形式のbaseUrlは**/v1を含めません**。これは初心者が最も犯しやすいミスです——Claudeの接続でエラーが発生した場合は、まずURLの末尾に誤って/v1が追加されていないか確認してください。

OpenClaw での2種類のフォーマットの同時使用設定

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

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

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タイプの不一致です。以下はよくあるエラーとその解決方法です：

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

エラータイプ 誤った設定 正しい設定 エラー現象
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%を回避できます。他の問題に遭遇した場合は、APIYI apiyi.comのドキュメントセンターで完全な接続ガイドを参照してください。

よくある質問

Q1: ClaudeをOpenAI互換モードで接続できないのはなぜですか？

技術的には可能です（ClaudeにもOpenAI互換エンドポイントがあります）。しかし、その場合、プロンプトキャッシング（入力コストを90%削減）、拡張思考（深い推論出力）、PDF処理、引用文献表示などの重要な機能が失われます。日常的なチャットには影響ありませんが、本番環境や長い対話シーンではコスト差が顕著になります。OpenClawでは anthropic-messages ネイティブフォーマットを使用することがより良い選択です。

Q2: 2つのプロバイダーで同じAPIキーを使えますか？

はい、使えます。APIYI apiyi.com の同じAPIキーは、OpenAI互換フォーマットとClaudeネイティブフォーマットの両方を同時にサポートしています。設定では、apiyi と apiyi-claude の2つのプロバイダーに同じ apiKey の値を入力するだけです。別々のキーを申請する必要はありません。

Q3: OpenClawで異なるモデルを切り替えるにはどうすればいいですか？

2つのプロバイダーを設定した後、OpenClawの対話インターフェースで、モデル選択のドロップダウンから設定済みのすべてのモデルを直接確認できます。汎用モデルは apiyi/gpt-5.4 などと表示され、Claudeモデルは apiyi-claude/claude-sonnet-4-6 などと表示されます。クリックするだけで切り替えられ、設定ファイルを変更する必要はありません。

まとめ

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 ドキュメントセンターをご覧ください

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

類似投稿