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.

1. Préparation

Avant de commencer, confirmez les points suivants :

• Vous avez déjà créé une API Key dans la console yycode
• Vous connaissez le nom réel du modèle à appeler, par exemple gpt-5.4 (liste complète dans 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

Modèles compatibles Anthropic

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 :

# 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 :

openclaw --help

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

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 :

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 :

# 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

# É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

# 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 :

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 :

{
  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.

7. Étapes suivantes

• Si vous n'avez pas encore créé de Key : retournez dans la console yycode pour créer une API Key
• Pour configurer d'autres outils de développement : continuez avec le Guide de démarrage rapide Claude Code et le Guide de démarrage rapide Codex
• Si l'environnement d'exécution doit être installé : consultez le Guide d'installation de l'environnement Node.js
• Pour les problèmes d'intégration fréquents : consultez les Questions fréquentes