OpenClaw

Connectez OpenClaw à CometAPI : installez via curl ou npm, stockez votre clé dans ~/.openclaw/.env, configurez les fournisseurs OpenAI/Anthropic/Google, et exécutez plus de 500 modèles.

Utilisez CometAPI comme fournisseur de modèles pour OpenClaw — plus de 500 modèles dans une seule API. Ce guide couvre le flux d’intégration actuel (2026.3.8+).

​

Prérequis

• Node.js ≥ 22 — recommandé via nvm
• Un compte CometAPI avec une clé API active — obtenez la vôtre ici

1. Obtenir votre clé API CometAPI

   Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé sk-xxxxx.

   

   
2. Installer ou mettre à jour OpenClaw

   Recommandé — utilisez l’installateur officiel :

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Ou installez-le via npm :

   npm install -g openclaw@latest
   

   Exécutez ensuite l’assistant de configuration une fois :

   openclaw onboard --install-daemon
   

   Pendant l’onboarding, choisissez Skip à l’étape Model/Auth si vous souhaitez configurer CometAPI manuellement. Après l’onboarding, confirmez que la passerelle est en cours d’exécution :

   openclaw gateway status
   openclaw dashboard
   
3. Stocker votre clé CometAPI

   Écrivez votre clé dans ~/.openclaw/.env afin qu’elle soit accessible au daemon sans être codée en dur dans les fichiers de configuration :

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   Si vous injectez déjà COMETAPI_KEY via votre shell, votre gestionnaire de services ou un workflow de secrets, ignorez cette étape — la configuration ci-dessous utilise $\{COMETAPI_KEY\} quelle que soit la manière dont la variable est définie.

4. Configurer les providers CometAPI

   CometAPI prend en charge quatre formats d’API. Ajoutez un ou plusieurs blocs provider à ~/.openclaw/openclaw.json :

   Provider	Format d’API	Endpoint appelé	URL de base
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /v1beta/...	https://api.cometapi.com/v1beta

   {
     "agents": {
       "defaults": {
         "model": {
           "primary": "cometapi-claude/your-claude-model-id"
         }
       }
     },
     "models": {
       "mode": "merge",
       "providers": {
         "cometapi-openai": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-completions",
           "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
         },
         "cometapi-openai-responses": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-responses",
           "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
         },
         "cometapi-claude": {
           "baseUrl": "https://api.cometapi.com",
           "apiKey": "${COMETAPI_KEY}",
           "api": "anthropic-messages",
           "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
         },
         "cometapi-google": {
           "baseUrl": "https://api.cometapi.com/v1beta",
           "apiKey": "${COMETAPI_KEY}",
           "api": "google-generative-ai",
           "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
         }
       }
     }
   }
   

   Vous pouvez conserver uniquement les providers dont vous avez besoin, ou garder les quatre pour router entre les formats à l’aide de références provider/model.

   Remplacez chaque placeholder your-...-model-id par un ID de modèle actuel depuis la page des modèles CometAPI correspondant au bloc provider.

   Utilisez cometapi-openai-responses (api: "openai-responses") pour les modèles qui nécessitent l’API OpenAI Responses. Utilisez cometapi-openai (api: "openai-completions") pour les modèles sur le chemin classique Chat Completions. Les deux partagent le même baseUrl (https://api.cometapi.com/v1) ; la seule différence est l’endpoint en aval qu’OpenClaw appelle.

   Le fichier auth-profiles.json n’est pas requis pour cette configuration. Les clés provider sont résolues depuis models.providers.*.apiKey via la variable d’environnement $\{COMETAPI_KEY\}. auth-profiles.json n’est nécessaire que si vous souhaitez une rotation des identifiants par profil sur plusieurs clés.

5. Redémarrer et vérifier

   Redémarrez la passerelle après avoir ajouté .env ou modifié la configuration du provider :

   openclaw gateway restart
   

   Exécutez ensuite les diagnostics :

   openclaw models status
   openclaw models list --provider cometapi-claude
   openclaw doctor
   

   Une configuration réussie ressemble à ceci :

   • openclaw models status résout le modèle principal vers cometapi-claude/your-claude-model-id sans avertissements d’authentification manquante pour les providers CometAPI
   • openclaw models list --provider cometapi-claude liste vos modèles configurés
   • openclaw doctor ne signale aucune erreur de configuration ou d’authentification pour les providers CometAPI

   
6. Changer de modèle

   # Set the default model in config
   openclaw models set cometapi-claude/your-claude-model-id
   
   # Switch for the current chat session
   /model cometapi-openai/your-chat-model-id
   /model cometapi-openai-responses/your-responses-model-id
   /model cometapi-claude/your-claude-model-id
   /model cometapi-google/your-gemini-model-id
   

Réinstallation propre (facultatif)

Si vous corrigez une ancienne configuration défaillante, arrêtez la passerelle, supprimez ~/.openclaw, puis relancez l’onboarding avant d’appliquer la configuration CometAPI :

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

Cela supprime toute la configuration locale, les sessions, les logs, l’état d’authentification et les espaces de travail. Suivez ensuite de nouveau les étapes 3 à 5.