Utiliser OpenClaw avec CometAPI

Utilisez CometAPI comme fournisseur de modèles pour OpenClaw — plus de 500 modèles dans une seule API.

Prérequis

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

Installation

Obtenez votre clé API CometAPI

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

Tableau de bord CometAPI affichant le bouton Add API Key

Détails de la clé API CometAPI avec l’URL de base

Installer ou mettre à jour OpenClaw

Recommandé — utilisez l’installateur officiel :

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

Ou installez via npm :

npm install -g openclaw@latest

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

openclaw onboard --install-daemon

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

openclaw gateway status
openclaw dashboard

Configuration

Stockez 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' "$COMETAPI_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.

Configurer les fournisseurs CometAPI

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

Provider	API Format	Endpoint called	Base URL
`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 ne conserver que les fournisseurs dont vous avez besoin, ou garder les quatre pour router entre les formats en utilisant des références provider/model.Remplacez chaque placeholder your-...-model-id par un model ID actuel depuis la page des modèles CometAPI correspondant au bloc de fournisseur.

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 le endpoint aval appelé par OpenClaw.

Le fichier auth-profiles.json n’est pas requis pour cette configuration. Les clés de fournisseur 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.

Vérification

Redémarrer et vérifier

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

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 fournisseurs 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 fournisseurs CometAPI

Statut des modèles OpenClaw montrant les fournisseurs CometAPI authentifiés

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

Dépannage

Réinstallation propre (optionnel)

Si vous corrigez une ancienne installation défectueuse, arrêtez la gateway, 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 à nouveau les étapes 3 à 5.

Vue d'ensemble

Agents de codage IA

Agents IA

Clients de chat IA

Traduction et langue

Plateformes d’automatisation

Observabilité et évaluation

Frameworks IA

Prérequis

Installation

Configuration

Vérification

Changer de modèle

Dépannage

​Prérequis

​Installation

​Configuration

​Vérification

​Changer de modèle

​Dépannage

Prérequis

Installation

Configuration

Vérification

Changer de modèle

Dépannage