Utiliser OpenClaw avec CometAPI

Utilisez ce guide pour connecter OpenClaw à CometAPI. Choisissez un format d’API et un ID de modèle pour la première configuration.

OpenClaw v2026.8.1 porte également la marque OpenClaw 2.0. Le package n’utilise pas de numéro de 2.x version. Consultez l’ annonce d’OpenClaw 2.0 et les notes de version v2026.8.1.

Références officielles d’OpenClaw :

Prérequis

Node.js 22.22.3+, 24.15+ ou 25.9+. Node 26 est recommandé. Node 23 n’est pas pris en charge.
Un compte CometAPI avec une clé API active depuis le tableau de bord.
Un ID de modèle depuis la page Modèles de CometAPI.

Installation et mises à niveau

Première installation
Mettre à niveau une installation

Le programme d’installation officiel peut installer la CLI sans démarrer l’intégration. Cela permet de conserver la configuration du modèle comme étape distincte.

macOS / Linux / WSL2
Windows PowerShell

La commande suivante exécute le programme d’installation officiel :

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

La commande suivante exécute le programme d’installation officiel PowerShell :

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Si vous gérez vous-même Node.js et npm, npm 11.16+ et npm 12 acceptent l’ --allow-scripts option. La commande suivante installe OpenClaw sans démarrer l’intégration :

npm install -g openclaw@latest --allow-scripts=openclaw

Avec npm 11.15 et les versions antérieures, omettez --allow-scripts=openclaw car cette version de npm ne reconnaît pas l’option.Confirmez que la CLI installée respecte la version minimale requise pour ce guide :

openclaw --version

Continuez vers Configurer CometAPI. N’exécutez pas d’abord l’ intégration simple, car le flux guidé n’expose pas tous les adaptateurs d’API personnalisés. adaptateur.

Créez et vérifiez une sauvegarde avant une mise à jour importante. L’archive peut contenir des clés API, l’état des canaux et des données d’authentification ; protégez-la comme vous protégez le répertoire d’état d’OpenClaw.Les commandes suivantes créent la sauvegarde et mettent à jour OpenClaw :

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

Après la mise à jour, réparez les migrations prises en charge et vérifiez l’état de Gateway :

openclaw doctor --fix
openclaw gateway restart
openclaw health

Une mise à jour conserve la route de modèle configurée. Ne répétez pas l’intégration sauf si vous souhaitez modifier le fournisseur du modèle ou son authentification.

Configurer CometAPI

Utiliser l’intégration classique

L’intégration classique est la méthode privilégiée lors d’une première installation pour Chat Completions, Responses et Anthropic Messages. La commande suivante ouvre l’intégration classique et installe le service d’arrière-plan :

openclaw onboard --classic --install-daemon

Dans Model/Auth, choisissez Custom Provider. Saisissez ensuite les valeurs de l’une de ces options de compatibilité :

Format d’API	ID du fournisseur	Option de compatibilité	URL de base
Chat Completions	`cometapi-openai`	Compatible avec OpenAI	`https://api.cometapi.com/v1`
Responses	`cometapi-openai-responses`	Compatible avec OpenAI Responses	`https://api.cometapi.com/v1`
Anthropic Messages	`cometapi-claude`	Compatible avec Anthropic	`https://api.cometapi.com`

Saisissez l’ID de fournisseur correspondant, your-model-id, ainsi que votre clé d’API CometAPI lorsque vous y êtes invité. L’assistant du terminal masque la saisie de la clé d’API. Le menu Custom Provider de l’intégration classique n’inclut pas l’adaptateur Google Generative AI . Pour utiliser cet adaptateur, suivez les étapes de Configurer un fournisseur avec des commandes de configuration, , définissez le modèle principal, puis exécutez l’intégration classique. Choisissez Conserver la configuration existante du modèle lorsque l’assistant propose cette option.

Configurer un fournisseur avec des commandes de configuration

Utilisez cette méthode pour l’adaptateur Google ou pour des modifications de configuration contrôlées. OpenClaw prend en charge JSON5 ; ne parsez et ne réécrivez donc pas openclaw.json à l’aide d’un outil JSON strict.

L’outil d’écriture de configuration natif d’OpenClaw valide JSON5, mais normalise le fichier au format JSON lors de l’écriture. Les commentaires existants, les virgules finales et la mise en forme peuvent être supprimés. Créez une sauvegarde vérifiée avant d’appliquer un correctif si ces éléments sont importants pour vous.

Commencez par afficher le chemin de configuration actif et valider son contenu :

openclaw config file
openclaw config validate

OpenClaw lit les clés d’API des fournisseurs depuis l’environnement de processus ou depuis le fichier d’état global .env. Il ne fait pas confiance à un fichier .env d’espace de travail pour les clés d’API des fournisseurs . Le fichier global est ~/.openclaw/.env, ou $OPENCLAW_STATE_DIR/.env lorsque OPENCLAW_STATE_DIR est défini. Si l’intégration classique a enregistré la clé d’API, ignorez l’étape suivante. Sinon, utilisez l’onglet correspondant à votre système d’exploitation pour enregistrer la clé d’API sans l’afficher .

macOS / Linux / WSL2
Windows PowerShell

Les commandes suivantes mettent à jour COMETAPI_KEY de manière atomique et rejettent une valeur vide :

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

Les commandes suivantes mettent à jour COMETAPI_KEY sans l’afficher :

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

Avant d’ajouter un fournisseur, examinez son chemin cible. Remplacez l’ID de fournisseur dans la commande suivante par l’ID de l’onglet sélectionné :

openclaw config get models.providers.cometapi-openai --json

Si la commande renvoie un fournisseur configuré, arrêtez-vous avant d’appliquer l’exemple. config patch fusionne les objets, mais remplace les tableaux. Fusionnez le nouveau modèle dans le tableau de modèles du fournisseur avant d’écrire ce tableau. Cela préserve les métadonnées du modèle, les en-têtes personnalisés et les autres paramètres du fournisseur. Choisissez un format d’API. Chaque correctif utilise un SecretRef basé sur l’environnement, modifie uniquement les chemins de configuration cibles et conserve les autres sections de configuration intactes.

Un ID de modèle n’est pas automatiquement compatible avec chaque adaptateur d’API. Sélectionnez un adaptateur pris en charge par le modèle CometAPI et la route exacts, puis vérifiez cette combinaison fournisseur/modèle/adaptateur au moyen d’une requête en direct. La your-model-id valeur ci-dessous est un espace réservé de configuration, et non une affirmation universelle de compatibilité.

Chat Completions
Responses
Anthropic Messages
Google Generative AI

ID du fournisseur : cometapi-openai
Adaptateur OpenClaw : openai-completions
URL de base : https://api.cometapi.com/v1
Référence du modèle principal : cometapi-openai/your-model-id

Créez cometapi.patch.json5 avec ce correctif de fournisseur :

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Validez le correctif avant qu’OpenClaw n’écrive la configuration :

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validation réussit, appliquez le même correctif :

openclaw config patch --file ./cometapi.patch.json5

Si aucun modèle principal n’est configuré, définissez ce modèle comme modèle par défaut :

openclaw models set cometapi-openai/your-model-id

Vérifiez la configuration du fournisseur et envoyez une requête minimale au modèle :

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

Pour changer la session de chat OpenClaw active, exécutez cette commande de chat :

/model cometapi-openai/your-model-id

ID du fournisseur : cometapi-openai-responses
Adaptateur OpenClaw : openai-responses
URL de base : https://api.cometapi.com/v1
Référence du modèle principal : cometapi-openai-responses/your-model-id

Créez cometapi.patch.json5 avec ce correctif de fournisseur :

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Validez le correctif avant qu’OpenClaw n’écrive la configuration :

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validation réussit, appliquez le même correctif :

openclaw config patch --file ./cometapi.patch.json5

Si aucun modèle principal n’est configuré, définissez ce modèle comme modèle par défaut :

openclaw models set cometapi-openai-responses/your-model-id

Vérifiez la configuration du fournisseur et envoyez une requête minimale au modèle :

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

Pour changer la session de chat OpenClaw active, exécutez cette commande de chat :

/model cometapi-openai-responses/your-model-id

ID du fournisseur : cometapi-claude
Adaptateur OpenClaw : anthropic-messages
URL de base : https://api.cometapi.com
Référence du modèle principal : cometapi-claude/your-model-id

Créez cometapi.patch.json5 avec ce correctif de fournisseur :

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Validez le correctif avant qu’OpenClaw n’écrive la configuration :

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validation réussit, appliquez le même correctif :

openclaw config patch --file ./cometapi.patch.json5

Si aucun modèle principal n’est configuré, définissez ce modèle comme modèle par défaut :

openclaw models set cometapi-claude/your-model-id

Vérifiez la configuration du fournisseur et envoyez une requête minimale au modèle :

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

Pour changer la session de chat OpenClaw active, exécutez cette commande de chat :

/model cometapi-claude/your-model-id

ID du fournisseur : cometapi-google
Adaptateur OpenClaw : google-generative-ai
URL de base : https://api.cometapi.com/v1beta
Référence du modèle principal : cometapi-google/your-model-id

Créez cometapi.patch.json5 avec ce correctif de fournisseur :

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Validez le correctif avant qu’OpenClaw n’écrive la configuration :

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validation réussit, appliquez le même correctif :

openclaw config patch --file ./cometapi.patch.json5

Si aucun modèle principal n’est configuré, définissez ce modèle comme modèle par défaut :

openclaw models set cometapi-google/your-model-id

Vérifiez la configuration du fournisseur et envoyez une requête minimale au modèle :

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

Pour changer la session de chat OpenClaw active, exécutez cette commande de chat :

/model cometapi-google/your-model-id

Si une configuration utilise déjà l’ID de fournisseur cometapi-gemini, conservez cet ID et utilisez-le dans les références de modèles et les commandes. Ne le renommez pas et ne créez pas de fournisseur en double uniquement pour correspondre à ce guide.

Liste de modèles OpenClaw 2026.8.1 avec quatre formats de fournisseur CometAPI

Pour un nouveau fournisseur, openclaw config set fournit le même schéma et les mêmes vérifications SecretRef. Utilisez --strict-json, --merge et --dry-run avant l’écriture. L’alternative suivante prévisualise le fournisseur Chat Completions : L’alternative suivante prévisualise le fournisseur Chat Completions :

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

Si l’exécution à blanc réussit, répétez la commande sans --dry-run pour l’enregistrer. N’ appliquez pas cet exemple à un fournisseur configuré. Le tableau models doit inclure la liste complète et fusionnée des modèles du fournisseur avant toute écriture.

Comprendre les métadonnées de modèle

Les correctifs minimaux déclarent un modèle texte uniquement. Ajoutez des métadonnées facultatives seulement lorsque vous avez vérifié les spécifications du modèle :

Champ	Effet
`input`	Déclare les modalités d’entrée acceptées. Utilisez `["text", "image"]` uniquement lorsque le modèle accepte des entrées d’image natives.
`contextWindow`	Enregistre la capacité native de la fenêtre de contexte du modèle.
`contextTokens`	Limite le budget d’entrée actif sans modifier `contextWindow`.
`maxTokens`	Limite les Tokens de sortie qu’OpenClaw demande au modèle.

Des valeurs incorrectes peuvent masquer les entrées prises en charge, surestimer le contexte utilisable ou demander une taille de sortie non prise en charge. Conservez your-model-id dans les exemples réutilisables, et utilisez la page Modèles de CometAPI pour sélectionner un ID de modèle.

Vérifier la configuration complète

Après avoir modifié le fichier de configuration ou le fichier global .env, redémarrez la Gateway :

openclaw gateway restart

Validez ensuite la configuration et l’état de la Gateway :

openclaw config validate
openclaw doctor
openclaw health

Exécutez les commandes spécifiques au fournisseur depuis l’onglet de format d’API sélectionné. Une liste de modèles ou une vérification d’état confirme uniquement la configuration. La commande openclaw agent exec envoie une requête réelle au modèle. Vérifiez qu’elle renvoie OPENCLAW_OK sans erreur non résolue d’authentification, d’adaptateur ou de modèle. Si OpenClaw réessaie une requête, enregistrez et examinez chaque tentative au lieu de considérer le marqueur final comme un succès en une seule tentative.

Résolution des problèmes

La clé API est absente

Vérifiez que COMETAPI_KEY est présent dans l’environnement du processus ou dans le fichier d’état global .env. N’imprimez pas la valeur dans la sortie du terminal.Après avoir corrigé la source de clé approuvée, redémarrez et vérifiez la Gateway :

openclaw gateway restart
openclaw health

Un ID de fournisseur possède des paramètres différents

Ne remplacez pas un fournisseur présentant un baseUrl différent, un api différent, des en-têtes personnalisés ou des métadonnées de modèle différentes. Inspectez d’abord le fournisseur cible :

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

Utilisez un ID de fournisseur différent lorsque les deux configurations sont intentionnelles. Si la différence est accidentelle, créez une sauvegarde vérifiée avant de modifier le fournisseur cible.

Une mise à jour ne s’est pas terminée

Inspectez l’état de la mise à jour avant de réparer l’installation :

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

Ces commandes préservent le répertoire d’état.

Un retour à une version antérieure du code est nécessaire

Réinstallez une version connue du package tout en conservant le répertoire d’état. Commencez par prévisualiser l’opération :

openclaw update --tag 2026.8.1 --dry-run

Si l’aperçu est correct, exécutez la même opération sans --dry-run :

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

Restaurez une sauvegarde de l’état uniquement lorsque le code installé ne peut pas lire l’état. La restauration d’un état peut supprimer des sessions et des modifications de configuration qui ont été créées après la sauvegarde.

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 et mises à niveau

Configurer CometAPI

Utiliser l’intégration classique

Configurer un fournisseur avec des commandes de configuration

Comprendre les métadonnées de modèle

Vérifier la configuration complète

Résolution des problèmes

​Prérequis

​Installation et mises à niveau

​Configurer CometAPI

​Utiliser l’intégration classique

​Configurer un fournisseur avec des commandes de configuration

​Comprendre les métadonnées de modèle

​Vérifier la configuration complète

​Résolution des problèmes

Prérequis

Installation et mises à niveau

Configurer CometAPI

Utiliser l’intégration classique

Configurer un fournisseur avec des commandes de configuration

Comprendre les métadonnées de modèle

Vérifier la configuration complète

Résolution des problèmes