OpenClaw Configuration pour Claude : Mode Compatible OpenAI vs Format Natif Claude – Tutoriel Complet

Note de l'auteur : Guide pas à pas pour configurer les deux modes d'accès dans OpenClaw : le mode compatible OpenAI et le format natif Claude, incluant le code JSON de configuration complet, la liste des modèles applicables et une comparaison des différences clés.

Dans OpenClaw (Open WebUI), il existe deux façons de connecter un grand modèle de langage : le mode compatible OpenAI (openai-completions) et le format natif Claude (anthropic-messages). De nombreux utilisateurs ne comprennent pas la différence, ce qui les amène soit à utiliser le mauvais format pour les modèles Claude, soit à passer à côté de fonctionnalités avancées comme la mise en cache des invites (Prompt Caching) offertes par le format natif.

Valeur clé : Après avoir lu cet article, vous maîtriserez la configuration complète des deux modes d'accès dans OpenClaw, vous saurez clairement quel format utiliser pour chaque modèle, et vous pourrez copier-coller directement le code de configuration pour l'utiliser.

Comparaison clé des deux modes d'accès OpenClaw

Résumé en une phrase des deux modes d'accès OpenClaw

Retenez une règle simple : utilisez anthropic-messages pour les modèles de la série Claude, et openai-completions pour tous les autres modèles. La différence la plus visible est le baseUrl — le mode compatible OpenAI se termine par /v1, le format natif Claude non.

Tutoriel de configuration du mode compatible OpenAI pour OpenClaw

Scénarios d'utilisation du mode compatible OpenAI

Le mode compatible OpenAI (openai-completions) est la méthode d'intégration la plus universelle dans OpenClaw, adaptée à tous les grands modèles de langage non-Claude. La plupart des services proxy API utilisent ce format standardisé OpenAI.

Code de configuration complet pour le mode compatible OpenAI

Voici la configuration complète pour accéder à GPT-5.4 via APIYI :

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

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-votre-clé-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" }
        ]
      }
    }
  }
}

Points clés de configuration du mode compatible OpenAI

🎯 Rappel de configuration : Le /v1 à la fin du baseUrl ne doit pas être omis, c'est le chemin standard du protocole compatible OpenAI. Inscrivez-vous sur APIYI apiyi.com pour obtenir votre clé API et votre crédit gratuit.

Tutoriel de configuration du format natif Claude pour OpenClaw

Scénarios d'utilisation du format natif Claude

Le format natif Claude (anthropic-messages) est la méthode d'intégration exclusive pour les modèles de la série Claude. Utiliser le format natif vous donne accès aux fonctionnalités avancées uniques à Claude, comme le Prompt Caching, l'Extended Thinking et le traitement PDF.

Code de configuration complet pour le format natif Claude

Voici la configuration complète pour accéder aux modèles Claude via APIYI :

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-votre-clé-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-votre-clé-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
          }
        ]
      }
    }
  }
}

Points clés de configuration du format natif Claude

🎯 Différence clé : Le baseUrl du format natif Claude est sans /v1. C'est l'erreur la plus courante pour les débutants – si l'intégration de Claude génère une erreur, vérifiez d'abord si /v1 n'a pas été ajouté par erreur à la fin de l'URL.

Configuration pour utiliser simultanément les deux formats OpenClaw

Dans un usage pratique, il est fort probable que vous ayez besoin d'utiliser à la fois les modèles génériques et les modèles Claude. Dans ce cas, vous devez configurer deux providers dans OpenClaw :

Code de configuration fusionnée pour deux providers

Écrivez les deux formats de provider dans le même fichier de configuration, et vous pourrez ainsi basculer librement entre les modèles dans OpenClaw :

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-votre_clé_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-votre_clé_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
          }
        ]
      }
    }
  }
}

🎯 Point important : Les deux providers peuvent utiliser la même clé API. La même clé APIYI (apiyi.com) prend en charge à la fois le format compatible OpenAI et le format natif Claude, sans avoir besoin de demander plusieurs clés.

Dépannage des erreurs courantes avec les deux formats OpenClaw

L'erreur la plus fréquente lors de la configuration est l'incompatibilité entre le baseUrl et le type d'API. Voici les erreurs courantes et leurs solutions :

🎯 Mémo de dépannage rapide : Le format OpenAI utilise /v1, le format Claude ne l'utilise pas. Retenez ce point pour éviter 80% des erreurs de configuration. Si vous rencontrez d'autres problèmes, consultez le centre de documentation d'APIYI sur apiyi.com pour le guide d'intégration complet.

Questions fréquentes

Résumé

Points essentiels des deux méthodes de connexion à OpenClaw :

1. Utiliser openai-completions pour les modèles génériques : Tous les modèles non-Claude comme GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax, etc. Le baseUrl contient /v1.
2. Utiliser anthropic-messages pour la série Claude : claude-sonnet-4-6, claude-opus-4-6, claude-haiku, etc. Le baseUrl ne contient PAS /v1 et nécessite l'en-tête anthropic-version.
3. La coexistence des deux fournisseurs est la meilleure pratique : Configurer deux providers avec la même clé API, permettant de basculer librement entre tous les modèles dans OpenClaw.

Il est recommandé d'obtenir une clé API via APIYI apiyi.com. Une seule clé permet d'accéder à tous les principaux modèles (GPT, Claude, Gemini, DeepSeek, etc.), avec support des formats compatibles OpenAI et natif Claude.

📚 Références

1. Centre d'aide APIYI : Tutoriel complet de configuration OpenClaw

   • Lien : help.apiyi.com
   • Description : Contient la documentation détaillée de connexion pour chaque site et la liste des modèles les plus récents.

2. Documentation de l'API Anthropic : Spécifications du format natif de l'API Claude

   • Lien : platform.claude.com/docs/en/api/messages
   • Description : Paramètres complets et format de réponse de l'API Messages.

3. Documentation de compatibilité du SDK OpenAI : Quels paramètres sont ignorés sur Claude

   • Lien : platform.claude.com/docs/en/api/openai-sdk
   • Description : Liste complète des paramètres pris en charge et non pris en charge.

4. Documentation Open WebUI : Guide de configuration multi-fournisseur pour OpenClaw

   • Lien : docs.openwebui.com
   • Description : Configuration des fournisseurs, gestion des modèles et paramètres des agents.

Auteur : Équipe technique APIYI
Échanges techniques : Bienvenue dans les commentaires pour discuter. Plus de ressources sont disponibles dans le centre de documentation APIYI docs.apiyi.com.