Passer au contenu principal
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

1

Obtenir votre clé API CometAPI

Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé sk-xxxxx.
Tableau de bord CometAPI affichant le bouton Add API Key
Détails de la clé API CometAPI avec l’URL de base
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 :
ProviderFormat d’APIEndpoint appeléURL de base
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /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
État des modèles OpenClaw montrant les providers CometAPI authentifiés
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
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.