canonical_url: https://yycode.net/docs/fr/openclaw-quickstart
lang: fr
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/fr/openclaw-quickstart

# Guide de démarrage rapide yycode × OpenClaw

## Cas d'utilisation

Ce document ne résout qu'une seule chose : connecter le service de modèles d'OpenClaw à yycode et effectuer une vérification d'utilisabilité.

Si Node.js n'est pas encore installé, consultez d'abord le [Guide d'installation de l'environnement Node.js](nodejs-setup).

---

## 1. Préparation

Avant de commencer, confirmez les points suivants :

- Vous avez déjà créé une API Key dans la [console yycode](https://yycode.net/console/token)
- Vous connaissez le nom réel du modèle à appeler, par exemple `gpt-5.4` (liste complète dans [Modèles pris en charge](#modèles-pris-en-charge))
- Votre environnement d'exécution répond aux exigences officielles d'OpenClaw : `Node 24` recommandé, compatible avec `Node 22.16+`
- Les utilisateurs Windows sont invités à privilégier `WSL2 + Ubuntu` pour installer et exécuter OpenClaw

---

## Modèles pris en charge

### Modèles compatibles OpenAI

| Nom du modèle |
|---|
| `gpt-5.4` |
| `gpt-5.2` |
| `gpt-5.3-codex` |
| `gpt-5.2-codex` |
| `gpt-5.1-codex-max` |
| `gpt-5.1-codex-mini` |

### Modèles compatibles Anthropic

| Nom du modèle |
|---|
| `claude-opus-4-6` |
| `claude-sonnet-4-6` |
| `claude-haiku-4-5-20251001` |

---

## 2. Chemin recommandé : intégration via l'assistant OpenClaw

Si vous voulez simplement faire fonctionner OpenClaw avec yycode, la méthode la plus simple consiste à lancer d'abord l'assistant intégré d'OpenClaw. Une fois que la console navigateur répond normalement, vous pourrez configurer les canaux ou le service résident.

### Étape 1 : installer OpenClaw

Sous macOS / Linux / WSL2, vous pouvez exécuter directement le script d'installation officiel :

```bash
# Installer l'outil en ligne de commande openclaw ; --no-onboard signifie ne pas lancer automatiquement l'assistant après installation
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

Après l'installation, vérifiez d'abord que la commande est disponible :

```bash
openclaw --help
```

### Étape 2 : lancer l'assistant d'intégration

```bash
openclaw onboard
```

### Étape 3 : choisir un fournisseur personnalisé dans l'assistant

Lorsque l'assistant arrive aux étapes de modèle et d'authentification, choisissez `Custom provider`, puis renseignez les valeurs suivantes :

| Champ | Valeur |
|---|---|
| Type compatible | `Anthropic-compatible` ou `OpenAI-compatible` |
| Adresse de base | Voir l'explication ci-dessous |
| Nom du modèle | `claude-sonnet-4-6` ou `gpt-5.4` (liste complète dans [Modèles pris en charge](#modèles-pris-en-charge))|
| Provider ID | `yycode` |
| API Key | L'API Key yycode que vous avez créée |

> **Explication de l'adresse de base :**
> - Si vous choisissez `Anthropic-compatible`, renseignez : `https://yycode.net`
> - Si vous choisissez `OpenAI-compatible`, ajoutez `/v1` à la fin : `https://yycode.net/v1`

### Étape 4 : terminer l'assistant et vérifier

Pour une première intégration, le port de passerelle, le mode de liaison et le service en arrière-plan peuvent rester aux valeurs par défaut. Après l'assistant, exécutez successivement :

```bash
# Vérifier que le format de configuration est correct
openclaw doctor

# Voir l'état courant et les modèles chargés
openclaw status

# Ouvrir la console locale et envoyer un message pour vérifier la réponse
openclaw dashboard
```

Si la console reçoit une réponse du modèle après l'envoi d'un message, l'intégration est réussie.

---

## 3. Intégration scriptée

Si vous voulez intégrer l'initialisation d'OpenClaw dans un script, un déploiement serveur ou une image d'entreprise, utilisez le mode non interactif.

### Étape 1 : exporter l'API Key

```bash
# Écrire d'abord l'API Key yycode dans une variable d'environnement
export CUSTOM_API_KEY="YOUR_yycode_API_KEY"
```

### Étape 2 : exécuter la commande d'intégration non interactive

```bash
# Intégration non interactive : configurer yycode comme fournisseur personnalisé
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://yycode.net" \
  --custom-model-id "gpt-5.4" \
  --custom-provider-id "yycode" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback
```

### Étape 3 : confirmer le nom de la variable d'environnement

Si vous avez utilisé `--secret-input-mode ref`, la version actuelle d'OpenClaw enregistre généralement l'API Key sous forme de référence à une variable d'environnement. Il est recommandé d'utiliser directement `CUSTOM_API_KEY` ci-dessus afin de rester cohérent avec la documentation officielle d'automatisation.

Si une configuration a déjà été générée, vous pouvez aussi ouvrir `~/.openclaw/openclaw.json` pour vérifier le nom de variable réellement référencé. Si votre version écrit un autre nom, ajoutez simplement la variable correspondante dans le shell courant, par exemple :

```bash
export OPENAI_API_KEY="YOUR_yycode_API_KEY"
```

---

## 4. Vérifier ou écrire manuellement la configuration

Si vous ne voulez pas lancer l'assistant, vous pouvez vérifier ou modifier directement `~/.openclaw/openclaw.json`.

Voici un exemple de configuration directement réutilisable. Remplacez le nom du modèle et la variable d'API Key par vos valeurs réelles :

```json5
{
  agents: {
    defaults: {
      // Le modèle par défaut doit être au format « ID fournisseur/nom du modèle », et non seulement le nom du modèle
      model: { primary: "yycode/gpt-5.4" },
    },
  },
  models: {
    providers: {
      dragoncode: {
        baseUrl: "https://yycode.net",
        // Référence à une variable d'environnement recommandée, pour éviter d'écrire la clé en clair dans le fichier de configuration
        apiKey: "${CUSTOM_API_KEY}",
        api: "openai-completions",
        models: [
          {
            // Remplacez ici par le nom de modèle réellement disponible dans la console yycode
            id: "gpt-5.4",
            name: "gpt-5.4",
          },
        ],
      },
    },
  },
}
```

> **Erreur la plus fréquente** : le modèle par défaut doit être écrit sous la forme `yycode/nom-du-modèle`, par exemple `yycode/gpt-5.4`, et non seulement `gpt-5.4`.

---

## 5. Critères de réussite

Les points suivants indiquent que l'intégration est globalement opérationnelle :

- L'adresse de base est `https://yycode.net`
- L'API Key est toujours valide, non expirée, non désactivée et avec un quota disponible
- Le modèle par défaut est écrit sous la forme `yycode/votre-nom-de-modèle`
- `openclaw doctor` et `openclaw status` ne signalent pas d'erreur de configuration
- La console navigateur peut envoyer un message et recevoir une réponse

---

## 6. Questions fréquentes

### J'ai bien renseigné l'adresse, mais la connexion échoue

Vérifiez d'abord que l'adresse de base est bien `https://yycode.net`. N'ajoutez pas de /

### OpenClaw démarre, mais indique que le modèle n'existe pas lors de l'envoi d'un message

Vérifiez généralement ces deux points :

- Le nom de modèle renseigné correspond-il exactement au nom d'appel actuellement ouvert par yycode ?
- Le modèle par défaut est-il écrit sous la forme `yycode/nom-du-modèle`, et non seulement le nom du modèle ?

### La commande scriptée indique que l'API Key est manquante

C'est généralement parce que la variable d'environnement n'a pas été réellement exportée, ou que son nom ne correspond pas à celui référencé dans la configuration OpenClaw.

Ouvrez directement `~/.openclaw/openclaw.json` pour confirmer quelle variable est référencée dans le champ `apiKey`, puis ajoutez la variable correspondante dans le shell courant. Avec le chemin recommandé ici, vérifiez d'abord `CUSTOM_API_KEY`.

### J'ai configuré OpenClaw, pourquoi ne puis-je pas encore l'utiliser dans WhatsApp ou Telegram ?

Ce n'est généralement pas un problème d'intégration du modèle, mais un canal qui n'est pas encore configuré. Cette page ne fait que relier OpenClaw et Dragon Code pour les appels de modèle ; pour la configuration des canaux, consultez la [documentation officielle OpenClaw Channels](https://docs.openclaw.ai/channels).

---

## 7. Étapes suivantes

- Si vous n'avez pas encore créé de Key : retournez dans la [console yycode](https://yycode.net/console/token) pour créer une API Key
- Pour configurer d'autres outils de développement : continuez avec le [Guide de démarrage rapide Claude Code](claude-code-quickstart) et le [Guide de démarrage rapide Codex](codex-quickstart)
- Si l'environnement d'exécution doit être installé : consultez le [Guide d'installation de l'environnement Node.js](nodejs-setup)
- Pour les problèmes d'intégration fréquents : consultez les [Questions fréquentes](faq)