Meilleure API pour OpenClaw : choisir un fournisseur et un modèle selon la tâche

Pour choisir la meilleure API pour OpenClaw, commencez par un fournisseur de modèles documenté. Choisissez OpenRouter pour la variété des modèles, Anthropic directement pour une configuration Claude ciblée, et comparez Kunavo lorsque le tarif du modèle est votre principal critère d’achat. Pour une configuration durable au moindre coût, séparez les vérifications courantes des tâches difficiles au lieu d’envoyer chaque tâche à un modèle coûteux unique.

Ce guide compare l’API LLM qui produit les réponses et les appels d’outils de l’assistant. Les services de recherche, de navigation et d’image sont des achats distincts. Pour l’hébergement et la facture d’exploitation complète, consultez la tarification d’OpenClaw.

Choisissez le fournisseur selon ce que vous achetez

OpenClaw publie un répertoire des fournisseurs, un guide de configuration OpenRouter et une référence distincte des fournisseurs personnalisés. Une passerelle figurant dans un tableau de prix n’est pas automatiquement une intégration OpenClaw native.

Utilisez des modèles différents pour des tâches différentes

Pour les résumés courts, la classification et les vérifications de pulsation délimitées, commencez par Claude Haiku 4.5. Pour le codage courant et le travail avec outils, présélectionnez Claude Sonnet 5. Pour les modifications complexes de dépôts et le raisonnement prolongé, présélectionnez Claude Opus 5. Ces points de départ suivent les recommandations de sélection de modèles d’Anthropic ; il ne s’agit pas de résultats de benchmark OpenClaw.

Rendez la règle d’escalade explicite. Une vérification courante peut signaler un état connu ou transmettre une situation inhabituelle au modèle plus puissant. Elle ne doit pas devenir silencieusement une vaste tâche de débogage. Si la vérification compare seulement une valeur à un seuil, effectuez directement cette comparaison et réservez le modèle à l’interprétation des exceptions.

Le niveau de capacité et le prix du fournisseur sont deux décisions distinctes. Comparez la ligne correspondant réellement au modèle souhaité ; les tarifs d’une passerelle ne suivent pas nécessairement le même ordre que les prix catalogue du fournisseur.

Une comparaison concrète des prix

Comparez le même modèle entre fournisseurs. Le tableau indique les USD par million de jetons standard d’entrée et de sortie non mis en cache : les prix de l’API directe d’Anthropic vérifiés le 17 septembre 2026, à côté des tarifs actuels du catalogue Kunavo. Les frais de cache, les outils payants et les taxes sont distincts.

Supposons que votre mois comporte 10 millions de jetons d’entrée non mis en cache et 1 million de jetons de sortie. Les placer tous sur Claude Opus 5 coûte $52.50 à ces tarifs. Affecter 9 millions de jetons d’entrée et 900 000 jetons de sortie à Claude Haiku 4.5, le reste étant placé sur Claude Opus 5, coûte $14.70.

Il s’agit d’un calcul arithmétique pour une répartition de charge de travail supposée, et non d’une économie garantie. Les frais de cache, les outils externes et l’infrastructure sont exclus, et l’hypothèse est que le modèle plus petit peut terminer le travail qui lui est attribué sans tentatives supplémentaires. Cette dernière condition détermine si le tarif inférieur produit une facture inférieure.

Prévoyez le premier paiement et le contexte récurrent

Kunavo commence par un rechargement prépayé de $10, sans abonnement obligatoire et avec un solde qui n’expire pas. Une petite tâche consomme une partie de ce solde ; son coût en jetons ne correspond pas à la somme nécessaire pour ouvrir un compte approvisionné. Le guide de facturation explique également pourquoi une estimation du catalogue ne constitue pas un plafond tarifaire : le montant final facturé peut être plus élevé lorsque la facturation fondée sur les coûts du fournisseur en amont dépasse cette estimation.

Les conditions de crédit d’OpenRouter fixent l’achat minimal à 5 $. Ses frais standard de carte en paiement à l’usage sont de 5,5 %, avec un minimum de 0,80 $ par rechargement. Ainsi, 5 $ de crédits coûtent 5,80 $ avant taxes, et 100 $ coûtent 105,50 $. Les frais sont payés lors de l’approvisionnement du compte, et ne sont pas ajoutés une nouvelle fois à chaque appel API. Comparez les crédits approvisionnés que vous consommerez réellement.

Pour un assistant qui envoie régulièrement les mêmes instructions, comparez les succès de cache signalés avant de choisir selon le prix des nouvelles entrées. Sonnet 5 direct coûte 0,20 $ par million de jetons lus depuis le cache, 2,50 $ pour les écritures de cinq minutes et 4 $ pour les écritures d’une heure ; le tarif de lecture du cache du catalogue de Kunavo pour le même modèle est $0.14. Ses écritures du cache Claude sont facturées à 1,25 fois le tarif d’entrée. Ces tarifs de facturation n’établissent pas que chaque route OpenClaw utilise la mise en cache : vérifiez l’utilisation renvoyée avant de budgétiser les vérifications courantes comme des succès de cache.

La tarification d’Anthropic inclut la fenêtre de contexte prise en charge de 1 M aux tarifs standard pour Sonnet 5 et Opus 5 ; Kunavo n’applique pas non plus de supplément de contexte long à ces modèles Claude. Un historique plus long signifie néanmoins davantage de jetons facturés. Gardez les vérifications récurrentes délimitées et incluez séparément les nouvelles entrées, les écritures du cache, les lectures du cache et les sorties dans l’estimation mensuelle.

Quand OpenRouter, le gratuit ou le local constitue le meilleur achat

Choisissez OpenRouter lorsque vous devez comparer des familles de modèles ou contrôler les préférences des fournisseurs amont. Sa documentation sur le routage prend en charge des priorités telles que le prix, la latence et le débit. Sélectionnez un modèle concret et examinez son tarif actuel au lieu de supposer qu’une route automatique choisit toujours le résultat acceptable le moins cher.

Utilisez les points de terminaison gratuits pour l’exploration initiale ou les tâches non urgentes. OpenRouter documente les limites de requêtes des modèles gratuits ; un prix nul par jeton ne garantit donc pas une capacité suffisante pour un assistant toujours actif. Évitez de faire dépendre une tâche courante urgente d’un quota que vous n’avez pas vérifié.

Choisissez l’inférence locale lorsque le matériel est déjà disponible et que son exploitation vous convient. La configuration Ollama d’OpenClaw vérifie les capacités des modèles, notamment la prise en charge des outils. Un modèle qui converse bien mais ne peut pas exécuter le flux de travail avec outils requis n’est pas une bonne affaire pour cette tâche.

Achetez une route fonctionnelle avant d’ajouter la complexité des solutions de repli

Commencez par choisir le rôle du modèle et le fournisseur. Confirmez l’identifiant du modèle, le point de terminaison, la diffusion en continu, les appels d’outils et la remontée d’utilisation avec une tâche délimitée. Ajoutez ensuite des routes de repli avec un budget connu ; sinon, une défaillance peut déplacer silencieusement le travail vers un autre niveau de prix ou de capacité.

Configurer une route Kunavo dans OpenClaw

Il s’agit d’une configuration de départ textuelle fondée sur le schéma de fournisseur personnalisé d’OpenClaw et le point de terminaison Messages de Kunavo. Elle n’a pas été validée ici avec une tâche OpenClaw payante. Conservez votre route fonctionnelle actuelle pendant l’essai.

1. Créez une clé Kunavo dans Clés API et approvisionnez le compte dans facturation lorsque vous serez prêt à envoyer des requêtes payantes.
2. Définissez KUNAVO_API_KEY dans l’environnement de la passerelle. OpenClaw lit également ~/.openclaw/.env, où vous pouvez ajouter KUNAVO_API_KEY=your-key ; une variable de processus existante est prioritaire. Consultez la référence de l’environnement. Gardez la clé réelle hors des fichiers du projet.
3. Sauvegardez votre configuration, puis fusionnez les champs ci-dessous dans ~/.openclaw/openclaw.json, en conservant vos autres fournisseurs, agents et canaux. Le guide de configuration couvre les emplacements de fichiers non par défaut.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-haiku-4-5",
            "name": "Claude Haiku 4.5",
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 1024
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/claude-haiku-4-5"
      }
    }
  }
}

L’URL de base est l’origine : cet adaptateur lui ajoute /v1/messages. Le préfixe kunavo/ identifie le fournisseur OpenClaw ; l’identifiant du modèle de la requête reste claude-haiku-4-5. Ici, 1024 est une limite de sortie volontairement réduite pour le premier essai, et non le maximum natif du modèle. L’exemple ne déclare qu’une entrée textuelle.

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo

La validation de la configuration vérifie la configuration, tandis que la liste des modèles vérifie le catalogue chargé ; aucune des deux ne prouve qu’une tâche payante fonctionne. Redémarrez avant la liste afin qu’une passerelle en cours d’exécution charge le nouveau fournisseur. Ouvrez une nouvelle session et confirmez son modèle actif : une session ou un agent existant peut conserver une surcharge du modèle par défaut.

Pour la première tâche, demandez-lui de lire un petit README temporaire et de le résumer, puis posez une question de suivi sur ce fichier. Vérifiez le résultat de l’outil, la diffusion de la réponse et le montant facturé enregistré dans Kunavo avant de déplacer les tâches planifiées. Une erreur 401 nécessite de vérifier la clé dans l’environnement de la passerelle ; une erreur de modèle introuvable nécessite de vérifier le préfixe du fournisseur et l’identifiant du modèle. L’absence de métadonnées de coût locales peut afficher une estimation nulle même si le fournisseur a facturé la requête.

Questions fréquentes

Documentation officielle vérifiée le 17 septembre 2026. Les tarifs Kunavo et les totaux illustratifs sont calculés à partir du catalogue de modèles en direct.