Tutoriel de cinq minutes pour configurer OpenClaw avec CometAPI

CometAPI
AnnaFeb 24, 2026
Tutoriel de cinq minutes pour configurer OpenClaw avec CometAPI

Début 2026, OpenClaw — la plateforme open source d’exécution d’agents et d’assistants IA — continue d’être largement adoptée par les développeurs, les équipes de recherche et les entreprises qui veulent une orchestration multi‑modèles sur des canaux comme Slack, Telegram, WhatsApp, ainsi que l’exécution locale en ligne de commande. Parallèlement, CometAPI s’est imposée comme une puissante passerelle LLM compatible OpenAI, agrégeant des centaines de modèles (p. ex., Kimi‑K2.5, variantes GPT, Claude) derrière un point de terminaison API unique.

Cet article est un guide pratique, étape par étape pour configurer OpenClaw afin qu’il utilise CometAPI comme fournisseur de modèles. Vous apprendrez à installer, configurer les fournisseurs, définir des profils d’authentification, vérifier le fonctionnement et basculer entre les modèles — le tout avec des exemples de configuration réels et des conseils fondés sur la documentation la plus récente et les retours de la communauté.

Qu’est-ce qu’OpenClaw et pourquoi l’intégrer à CometAPI ?

OpenClaw est une plateforme d’agents orientée appareil et open source qui connecte l’IA conversationnelle aux applications de chat et aux appareils que les utilisateurs utilisent déjà — WhatsApp, Telegram, Slack, Discord et plus — tout en vous permettant d’exécuter les modèles où vous le souhaitez et de garder vos clés et vos données sous votre contrôle. Le projet et ses dépôts contiennent des exemples montrant comment OpenClaw sélectionne les fournisseurs LLM via une configuration de type passerelle.

CometAPI est une plateforme d’agrégation d’API qui expose de nombreux fournisseurs de modèles via une interface REST et des SDK au style OpenAI. Cela la rend pratique en tant que point d’intégration unique si vous souhaitez changer de modèles, tester des tarifs ou centraliser l’observabilité sans modifier le code cœur d’OpenClaw.

Pourquoi associer OpenClaw à CometAPI ?

OpenClaw est indépendant des modèles ; il exécute des agents et des workflows mais s’appuie sur des fournisseurs LLM externes. CometAPI agit comme une passerelle compatible OpenAI, vous permettant d’acheminer des appels vers :

  • La famille de modèles GPT
  • La famille de modèles Claude
  • Kimi‑K2.5 et d’autres modèles tiers agrégés par CometAPI

Cela vous apporte choix, flexibilité, maîtrise des coûts et redondance.

Comment configurer OpenClaw pour utiliser CometAPI comme fournisseur de modèles ?

Réponse : Ajoutez une entrée de fournisseur dans votre configuration OpenClaw qui pointe vers le point de terminaison REST de CometAPI et mappez les modèles à la structure models.providers d’OpenClaw. Le projet OpenClaw prend en charge l’ajout de fournisseurs personnalisés via models.providers (le même schéma utilisé pour d’autres passerelles) et attend une saveur api telle que "openai-completions" ou "anthropic-messages" selon la sémantique du fournisseur.

CometAPI prend en charge trois formats d’API. Ajoutez-en un ou plusieurs à ~/.openclaw/openclaw.json :

FournisseurFormat d’APIURL de base
cometapi-openaiopenai-completionshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aihttps://api.cometapi.com/v1beta

Quelles sont les conditions préalables pour configurer OpenClaw avec CometAPI ?

Avant l’intégration, assurez-vous de disposer du bon environnement, des bons outils et des bons comptes.

Exigences d’environnement

Vous aurez besoin de :

  • Un environnement de type Unix : Linux, macOS ou Windows Subsystem for Linux (WSL2)
  • Node.js et npm installés (OpenClaw utilise Node sous le capot)
  • Un accès au terminal avec bash/zsh ou PowerShell

La documentation officielle mentionne également qu’OpenClaw peut s’exécuter via Docker, ce qui est idéal pour les configurations isolées et de production.

Comptes et clés API

Il vous faut :

  1. Un compte CometAPI
  2. Une clé LLM CometAPI valide (stockée dans une variable d’environnement sécurisée)
  3. Facultatif : des comptes pour des fournisseurs OpenClaw supplémentaires (OpenAI, Anthropic, modèles locaux via Ollama)

💡 Astuce : utilisez un gestionnaire de secrets sécurisé ou le trousseau du système d’exploitation plutôt que de stocker des clés en clair. Cela est recommandé par la documentation d’OpenClaw pour la sécurité en production.

Comment configurer OpenClaw pour appeler CometAPI ? (étape par étape)

Ci-dessous se trouve une configuration concise et pratique en cinq minutes. Les noms de fichiers ou les clés exacts dépendent de votre version et de votre déploiement OpenClaw, mais les concepts se traduisent directement depuis le dépôt et la documentation officiels d’OpenClaw.

Étape 0 — Définir les variables d’environnement (voie rapide sécurisée)

Exemple Shell (Linux/macOS) :

# do NOT commit this to gitexport COMETAPI_KEY="sk-YourCometApiKeyHere"export OPENCLAW_ENV="production"   # or development

Utilisez le mécanisme de secrets de votre plateforme en production (p. ex., secrets Docker, systemd, secrets Kubernetes).

Étape 1 — Installer OpenClaw

Option A : one-liner via script d’installation

C’est la méthode la plus rapide :

curl -fsSL https://openclaw.ai/install.sh | bash# Verify installationopenclaw --version

Ce script détecte votre système d’exploitation et installe OpenClaw avec ses dépendances.

Option B : installation globale via npm

Si vous gérez déjà des paquets Node :

npm install -g openclaw@latestopenclaw --version

Cela installe l’interface CLI d’OpenClaw globalement.

Optionnel : installation Docker

Si vous déployez en production ou souhaitez une isolation :

docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw

Les déploiements en conteneur facilitent la gestion des dépendances et des charges de travail.nClaw version ; les exemples d’OpenClaw suivent ce modèle.)

Étape 2 — Configurer les fournisseurs

La configuration des fournisseurs indique à OpenClaw où trouver votre backend LLM.

Modifier le fichier de configuration d’OpenClaw

OpenClaw stocke sa configuration dans un fichier JSON à :

~/.openclaw/openclaw.json

Vous allez définir un fournisseur personnalisé pour CometAPI.

Voici une configuration de fournisseur minimale :

  • base_url indique à OpenClaw d’envoyer les requêtes LLM vers le point de terminaison compatible OpenAI de CometAPI.
  • auth_env pointe vers la variable d’environnement contenant votre clé API.
  • Le drapeau type spécifie le type de protocole API (style OpenAI).
{
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.2", "name": "GPT-5.2" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "cometapi-claude/claude-opus-4-6" }
    }
  },
  "auth": {
    "profiles": {
      "cometapi-openai:default": { "provider": "cometapi-openai", "mode": "api_key" },
      "cometapi-claude:default": { "provider": "cometapi-claude", "mode": "api_key" },
      "cometapi-google:default": { "provider": "cometapi-google", "mode": "api_key" }
    }
  }
}

Remplacez <YOUR_COMETAPI_KEY> par votre clé API. Les trois fournisseurs utilisent la même clé.

Vous pouvez ajouter n’importe quel modèle depuis la CometAPI Models Page au fournisseur correspondant.

Étape 3 — Configurer les profils d’authentification

⚠️ Obligatoire ! OpenClaw lit les clés API depuis ce fichier, pas depuis openclaw.json. Si vous sautez cette étape, vous obtiendrez des erreurs HTTP 401.

Créez ~/.openclaw/agents/main/agent/auth-profiles.json :

{
  "version": 1,
  "profiles": {
    "cometapi-openai:default": {
      "type": "api_key",
      "provider": "cometapi-openai",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-claude:default": {
      "type": "api_key",
      "provider": "cometapi-claude",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-google:default": {
      "type": "api_key",
      "provider": "cometapi-google",
      "key": "<YOUR_COMETAPI_KEY>"
    }
  },
  "lastGood": {
    "cometapi-openai": "cometapi-openai:default",
    "cometapi-claude": "cometapi-claude:default",
    "cometapi-google": "cometapi-google:default"
  }
}

Redémarrez la passerelle :

openclaw gateway restart

Vérifiez les statuts avec :

openclaw auth status

Et pour lister tous les modèles configurés :

openclaw models list

Ces commandes confirment si vos fournisseurs et profils d’authentification sont correctement configurés. Tous les modèles doivent afficher Auth = yes :

Model                                        Auth
cometapi-openai/gpt-5.2                      yes
cometapi-claude/claude-opus-4-6              yes
cometapi-google/gemini-3-pro-preview         yes

Tutoriel de cinq minutes pour configurer OpenClaw avec CometAPI

Étape 4 — Exécuter OpenClaw et observer les logs

Démarrez/redémarrez OpenClaw et suivez les logs. Recherchez spécifiquement :

  • Des logs de requêtes sortantes affichant base_url ou le nom du fournisseur.
  • 401/403 → problème de clé ou de périmètre.
  • 429 → limite de débit (envisagez des changements de modèle/performance).
  • Latence anormalement élevée → réseau ou bridage du modèle.

Une commande de diagnostic rapide (exemple) :

# If OpenClaw runs as a system service:journalctl -u openclaw -f# If running in Docker:docker logs -f openclaw

Changer de modèle

# Set default model
openclaw models set cometapi-claude/claude-opus-4-6

# Or switch in TUI
/model cometapi-openai/gpt-5.2

Comment utiliser OpenClaw avec CometAPI dans des workflows réels ?

Après l’intégration, vous pouvez créer des workflows incluant génération de code, tâches multimodales, automatisation d’agents et publication sur des canaux.

Exemple de workflow : interprétation de capture d’écran

Si votre agent prend en charge les pièces jointes :

User: Analyze this screenshot and generate a minimal React component.

OpenClaw envoie l’invite (plus les données d’image) via le modèle de CometAPI (comme Kimi K‑2.5), qui renvoie une sortie de code — idéal pour prototyper des workflows d’interface.

Intégration Slack / Discord

Une fois CometAPI utilisé en backend, vous pouvez acheminer les réponses de l’agent vers n’importe quelle plateforme configurée :

  • Canaux Slack
  • Groupes WhatsApp
  • Bots Telegram

OpenClaw gère l’acheminement et l’analyse des requêtes ; CometAPI fournit les réponses du modèle.

Quels mécanismes de supervision et de contrôle des coûts ajouter ?

Lorsque vous centralisez vers un agrégateur, vous gagnez en contrôle — mais vous devez le configurer :

Instrumentation

  • Journalisez le nom du modèle, l’usage de tokens, la latence et les codes d’erreur pour chaque requête.
  • Étiquetez les requêtes avec l’agent et le canal (p. ex., agent=personal_assistant, channel=telegram) afin d’attribuer les coûts.

Leviers de contrôle des coûts

  • Définissez max_tokens et timeout_seconds dans votre configuration de fournisseur.
  • Utilisez des modèles moins coûteux pour les tâches courantes et réservez les grands modèles pour les flux à forte valeur.
  • Configurez des limites de débit par agent et des quotas par utilisateur (OpenClaw peut souvent être étendu pour les appliquer).

CometAPI met en avant des outils pour optimiser performance et coûts ; utilisez la télémétrie des deux côtés (logs OpenClaw + métriques d’usage CometAPI) pour créer des garde‑fous.

Comment dépanner les erreurs courantes de l’intégration ?

Réponse : Voici les modes de panne courants et comment les résoudre rapidement :

Correctif : le panneau de contrôle d’OpenClaw affichera un jeton à usage unique ; collez‑le dans les paramètres de l’interface de contrôle conformément à la documentation. Les notes de la communauté mentionnent fréquemment cette étape.

401 Unauthorized

Cause : COMETAPI_KEY manquante, erronée ou non injectée dans le processus OpenClaw.

Correctif : exportez la clé dans le shell qui lance OpenClaw ou écrivez‑la dans votre .env OpenClaw et redémarrez la passerelle. Confirmez avec un test curl.

Fournisseur revenant silencieusement en arrière / bascule par défaut

Cause : JSON models.providers mal formé ou saveur api manquante, entraînant l’ignorance du fournisseur par OpenClaw.

Correctif : validez openclaw.json (lint JSON) et assurez‑vous que api correspond aux saveurs prises en charge. Les fils de discussion de la communauté montrent que cette mauvaise configuration est courante.

Timeouts ou latence élevée

Cause : route réseau ou lenteur du modèle distant.

Correctif : choisissez un modèle Comet à plus faible latence ou hébergez OpenClaw dans la même région cloud ; envisagez d’exécuter un modèle local pour les tâches sensibles à la latence. La documentation et les blogs discutent du compromis entre modèles locaux et API (latence vs coût).

Utilisation excessive / 429s

Cause : dépassement du quota CometAPI ou des limites du plan.

Correctif : vérifiez le tableau de bord Comet pour le quota ; ajoutez une logique de retry/backoff dans les actions de l’agent OpenClaw ou réduisez le débit au niveau de la passerelle. Comet et la documentation des partenaires mettent en avant les quotas des plans et les schémas de backoff recommandés.

Jeton de passerelle manquant / déconnexions websocket

Cause : jetons de contrôle OpenClaw manquants dans la configuration du tableau de bord lors de l’exécution de la passerelle.

Note de clôture

Connecter OpenClaw à CometAPI est rapide et déverrouille un backend multi‑modèles puissant pour votre assistant personnel. Mais la vitesse n’est pas une excuse pour ignorer la sécurité : liez la passerelle à localhost pendant les tests, utilisez des listes d’autorisation, journalisez tout et exigez des confirmations pour les actions destructrices. Avec ces contrôles en place, vous pouvez passer de zéro à un agent OpenClaw → CometAPI fonctionnel en environ cinq minutes — tout en protégeant vos données et systèmes pendant vos expérimentations.

Les développeurs peuvent accéder à kimi k-2.5 via CometAPI dès maintenant. Pour commencer, explorez les capacités du modèle dans le Playground et consultez le guide API pour des instructions détaillées. Avant l’accès, assurez‑vous de vous être connecté à CometAPI et d’avoir obtenu la clé API. CometAPI propose un prix bien inférieur au prix officiel pour faciliter votre intégration.

Prêt à démarrer ? → Inscrivez-vous à OpenClaw dès aujourd’hui !

Si vous souhaitez davantage de conseils, de guides et d’actualités sur l’IA, suivez‑nous sur VK, X et Discord !

En savoir plus

500+ Modèles en Une API

Jusqu'à 20% de réduction