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

# Kilo Gateway

Kilo Gateway fournit une **API unifiée** qui achemine les requêtes vers de nombreux modèles derrière un seul
endpoint et une seule clé API. Elle est compatible OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base.

| Propriété        | Valeur                             |
| ---------------- | ---------------------------------- |
| Fournisseur      | `kilocode`                         |
| Authentification | `KILOCODE_API_KEY`                 |
| API              | Compatible OpenAI                  |
| URL de base      | `https://api.kilo.ai/api/gateway/` |

## Installer le plugin

Installez le plugin officiel, puis redémarrez Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart
```

## Bien démarrer

<Steps>
  <Step title="Create an account">
    Accédez à [app.kilo.ai](https://app.kilo.ai), connectez-vous ou créez un compte, puis allez dans API Keys et générez une nouvelle clé.
  </Step>

  <Step title="Run onboarding">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice kilocode-api-key
    ```

    Ou définissez directement la variable d’environnement:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
    ```
  </Step>

  <Step title="Verify the model is available">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider kilocode
    ```
  </Step>
</Steps>

## Modèle par défaut

Le modèle par défaut est `kilocode/kilo/auto`, un modèle de routage intelligent
appartenant au fournisseur et géré par Kilo Gateway.

<Note>
  OpenClaw traite `kilocode/kilo/auto` comme la réf stable par défaut, mais ne
  publie pas de correspondance sourcée entre les tâches et les modèles upstream pour cette route. Le routage
  upstream exact derrière `kilocode/kilo/auto` appartient à Kilo Gateway, il n’est pas
  codé en dur dans OpenClaw.
</Note>

## Catalogue intégré

OpenClaw découvre dynamiquement les modèles disponibles depuis Kilo Gateway au démarrage. Utilisez
`/models kilocode` pour voir la liste complète des modèles disponibles avec votre compte.

Tout modèle disponible sur le gateway peut être utilisé avec le préfixe `kilocode/`:

| Réf de modèle                            | Notes                                        |
| ---------------------------------------- | -------------------------------------------- |
| `kilocode/kilo/auto`                     | Par défaut — routage intelligent             |
| `kilocode/anthropic/claude-sonnet-4`     | Anthropic via Kilo                           |
| `kilocode/openai/gpt-5.5`                | OpenAI via Kilo                              |
| `kilocode/google/gemini-3.1-pro-preview` | Google via Kilo                              |
| …et beaucoup d’autres                    | Utilisez `/models kilocode` pour tout lister |

<Tip>
  Au démarrage, OpenClaw interroge `GET https://api.kilo.ai/api/gateway/models` et fusionne
  les modèles découverts avant le catalogue de secours statique. Le catalogue de secours statique
  inclut toujours `kilocode/kilo/auto` (`Kilo Auto`) avec `input: ["text", "image"]`,
  `reasoning: true`, `contextWindow: 1000000` et `maxTokens: 128000`.
</Tip>

## Exemple de configuration

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo/auto" },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="Transport and compatibility">
    Kilo Gateway est documenté dans le source comme compatible OpenRouter, il reste donc sur
    le chemin proxy compatible OpenAI plutôt que sur la mise en forme native des requêtes OpenAI.

    * Les réfs Kilo basées sur Gemini restent sur le chemin proxy-Gemini, donc OpenClaw conserve
      l’assainissement des signatures de pensée Gemini à cet endroit sans activer la validation
      de relecture Gemini native ni les réécritures de bootstrap.
    * Kilo Gateway utilise en interne un jeton Bearer avec votre clé API.
  </Accordion>

  <Accordion title="Stream wrapper and reasoning">
    Le wrapper de flux partagé de Kilo ajoute l’en-tête de l’application fournisseur et normalise
    les charges utiles de reasoning proxy pour les réfs de modèles concrètes prises en charge.

    <Warning>
      `kilocode/kilo/auto` et les autres indices proxy-reasoning non pris en charge ignorent l’injection de reasoning.
      Si vous avez besoin de la prise en charge du reasoning, utilisez une réf de modèle concrète comme
      `kilocode/anthropic/claude-sonnet-4`.
    </Warning>
  </Accordion>

  <Accordion title="Troubleshooting">
    * Si la découverte des modèles échoue au démarrage, OpenClaw revient au catalogue statique contenant `kilocode/kilo/auto`.
    * Confirmez que votre clé API est valide et que les modèles souhaités sont activés sur votre compte Kilo.
    * Lorsque Gateway s’exécute comme daemon, assurez-vous que `KILOCODE_API_KEY` est disponible pour ce processus (par exemple dans `~/.openclaw/.env` ou via `env.shellEnv`).
  </Accordion>
</AccordionGroup>

## Connexe

<CardGroup cols={2}>
  <Card title="Model selection" href="/fr/concepts/model-providers" icon="layers">
    Choisir les fournisseurs, les réfs de modèles et le comportement de basculement.
  </Card>

  <Card title="Configuration reference" href="/fr/gateway/configuration-reference" icon="gear">
    Référence complète de la configuration OpenClaw.
  </Card>

  <Card title="Kilo Gateway" href="https://app.kilo.ai" icon="arrow-up-right-from-square">
    Tableau de bord Kilo Gateway, clés API et gestion du compte.
  </Card>
</CardGroup>