Configurer
OpenClaw
via CometAPI
Utilisez CometAPI comme fournisseur de modèles personnalisé pour OpenClaw : une API, 500+ modèles, jusqu'à 20% de réduction. Ce guide est aligné sur le flux d'intégration OpenClaw actuel (2026.3.8+) et couvre l'installation, la configuration des fournisseurs, la vérification et le changement de modèle.
# Exemple uniquement—à vérifier avec votre version OpenClaw avant la production
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}Périmètre du guide
et prérequis
Configurer OpenClaw avec CometAPI
Utilisez CometAPI comme fournisseur de modèles personnalisé pour OpenClaw afin d'accéder à 500+ modèles via une seule API, avec jusqu'à 20% de réduction sur les routes supportées. Cette page suit le flux d'intégration OpenClaw actuel (2026.3.8+).
Prérequis
Node.js >= 22 et une clé API CometAPI sont requis. Pour les installations daemon, stockez COMETAPI_KEY dans ~/.openclaw/.env afin qu'openclaw.json puisse y faire référence via ${COMETAPI_KEY} sans coder en dur les secrets.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COMETAPI_KEY=%s\n' 'your_cometapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Après avoir ajouté ~/.openclaw/.env ou modifié la configuration du fournisseur, redémarrez une fois avec openclaw gateway restart, puis lancez les diagnostics. Utiliser des références complètes provider/model dans toutes les commandes et sessions. En cas de dérive de version, re-vérifier la Référence de configuration.
Pourquoi trois fournisseurs
pour une clé CometAPI
Installer, intégrer, configurer,
vérifier, changer
OpenClaw utilise ~/.openclaw/openclaw.json comme configuration source que vous modifiez. Les fournisseurs personnalisés sont matérialisés dans des fichiers models.json par agent sous ~/.openclaw/agents/<agentId>/. Re-vérifier les clés et comportements après les mises à niveau en utilisant les guides Référence de configuration et Variables d'environnement . Traiter les URL de base CometAPI uniquement telles que définies dans la documentation en direct.
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}La configuration de base ne nécessite pas de créer manuellement auth-profiles.json. Utiliser ${COMETAPI_KEY} dans les fournisseurs et injecter la variable via ~/.openclaw/.env, le shell ou le gestionnaire de services.
Les tarifs en direct
sur le site CometAPI
Le tableau ci-dessous utilise des tarifs illustratifs par million de tokens. Le catalogue de modèles, les réductions et les SLA correspondent à ce que Documentation et console CometAPI affiche actuellement.
| Modèle (exemple) | Entrée / 1M tokens | Sortie / 1M tokens | Remarque |
|---|---|---|---|
| Claude Opus 4.6 | $4.00 | $20.00 | Issu des données de référence |
| MiniMax-M2.7 | $0.24 | $0.96 | Issu des données de référence |
| GLM 5 Turbo | $0.96 | $3.26 | Issu des données de référence |
| GPT-5.4 pro | $24.00 | $144 | Issu des données de référence |
| Gemini 3.1 Pro | $1.60 | $9.60 | Issu des données de référence |
| qwen3.5-plus | $0.32 | $1.92 | Issu des données de référence |
Vérifier ceci
avant d'intégrer
Ai-je besoin d'auth-profiles.json pour cette configuration ?
Non pour la configuration de base. OpenClaw peut résoudre le apiKey du fournisseur depuis models.providers.*.apiKey via ${COMETAPI_KEY}. Utiliser auth-profiles.json uniquement pour les secrets stockés par profil ou la rotation.
Pourquoi y a-t-il 3 entrées de fournisseur pour un seul fournisseur ?
OpenClaw route par compatibilité de format API. Conserver des entrées séparées pour openai-completions, anthropic-messages et google-generative-ai si les trois familles d'API sont nécessaires.
Où la configuration est-elle réellement modifiée et matérialisée ?
Modifier ~/.openclaw/openclaw.json. Les fournisseurs personnalisés sont matérialisés dans models.json par agent sous ~/.openclaw/agents/<agentId>/ après synchronisation/chargement.
Quels identifiants de modèle sont utilisés dans ce guide ?
gpt-5.4, claude-sonnet-4-6 et gemini-3.1-pro-preview. N'importe quel modèle de la page des modèles CometAPI peut être ajouté au bloc de fournisseur correspondant.