> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser OpenClaw avec CometAPI

> Utilisez ce guide pour configurer OpenClaw avec CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.

Utilisez [CometAPI](https://www.cometapi.com) comme fournisseur de modèles pour [OpenClaw](https://openclaw.ai) — plus de 500 modèles dans une seule API.

## Prérequis

* Node.js ≥ 22 — recommandé via [nvm](https://github.com/nvm-sh/nvm)
* Un compte CometAPI avec une clé API active — [obtenez la vôtre ici](https://www.cometapi.com/console/token)

## Installation

<Steps>
  <Step title="Obtenez votre clé API CometAPI">
    Connectez-vous à la [console CometAPI](https://www.cometapi.com/console/token). Cliquez sur **Add API Key** et copiez votre clé API CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Tableau de bord CometAPI affichant le bouton Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Détails de la clé API CometAPI avec l’URL de base" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installer ou mettre à jour OpenClaw">
    **Recommandé** — utilisez l’installateur officiel :

    ```bash theme={null}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

    Ou installez via npm :

    ```bash theme={null}
    npm install -g openclaw@latest
    ```

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

    ```bash theme={null}
    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 :

    ```bash theme={null}
    openclaw gateway status
    openclaw dashboard
    ```
  </Step>
</Steps>

## Configuration

<Steps>
  <Step title="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 :

    ```bash theme={null}
    printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
    chmod 600 ~/.openclaw/.env
    ```

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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` |

    ```json theme={null}
    {
      "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](https://www.cometapi.com/models/) correspondant au bloc de fournisseur.

    <Note>
      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.
    </Note>

    <Note>
      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.
    </Note>
  </Step>
</Steps>

## Vérification

<Steps>
  <Step title="Redémarrer et vérifier">
    Redémarrez la passerelle après avoir ajouté `.env` ou modifié la configuration du fournisseur :

    ```bash theme={null}
    openclaw gateway restart
    ```

    Exécutez ensuite les diagnostics :

    ```bash theme={null}
    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

    <Frame>
      <img src="https://mintcdn.com/cometapi/3HbSFe0pH45ETcjq/images/integrations/810968_371721.png?fit=max&auto=format&n=3HbSFe0pH45ETcjq&q=85&s=928b6faed91c5c2cb2eceea6bfac630d" alt="Statut des modèles OpenClaw montrant les fournisseurs CometAPI authentifiés" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

## Changer de modèle

<Steps>
  <Step title="Changer de modèle">
    ```bash theme={null}
    # 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
    ```
  </Step>
</Steps>

## Dépannage

<AccordionGroup>
  <Accordion title="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 :

    ```bash theme={null}
    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.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "Utiliser OpenClaw avec CometAPI",
        "description": "Utilisez ce guide pour configurer OpenClaw avec CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "Obtenir votre clé API CometAPI",
            "text": "Créez ou ouvrez votre compte CometAPI, puis copiez une clé API active depuis le tableau de bord."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "Installer ou mettre à jour OpenClaw",
            "text": "Effectuez l’étape Installer ou mettre à jour OpenClaw dans le guide Utiliser OpenClaw avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "Stocker votre clé CometAPI",
            "text": "Effectuez l’étape Stocker votre clé CometAPI dans le guide Utiliser OpenClaw avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "Configurer les fournisseurs CometAPI",
            "text": "Effectuez l’étape Configurer les fournisseurs CometAPI dans le guide Utiliser OpenClaw avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "Redémarrer et vérifier",
            "text": "Effectuez l’étape Redémarrer et vérifier dans le guide Utiliser OpenClaw avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "Changer de modèles",
            "text": "Effectuez l’étape Changer de modèles dans le guide Utiliser OpenClaw avec CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Utiliser OpenClaw avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>