Intégration d'OpenClaw

Difficulté ⌨️ Avancé　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

OpenClaw (🦞) est un assistant IA personnel open source qui prend en charge les fournisseurs de modèles personnalisés. Il suffit de le pointer vers Byesu, et c'est identique sous Windows / macOS / Linux.

Avant de commencer

Rendez-vous d'abord dans Console → Jetons pour créer un jeton (voir Choisir un groupe).

Méthode 1 : l'assistant (le plus simple)

Après l'installation, lancez l'assistant intégré et choisissez le fournisseur « Personnalisé / Compatible OpenAI » en suivant les instructions :

openclaw onboard

Renseignez successivement :

• Adresse de l'interface / baseUrl : https://byesu.com/v1
• Clé API : votre sk-xxxx
• Modèle : indiquez le nom d'un modèle disponible sur Byesu (par exemple gpt-5.5, claude-opus-4-8)

Méthode 2 : modifier manuellement le fichier de configuration

Dans le fichier de configuration d'OpenClaw (~/.openclaw/openclaw.json, au format JSON5), ajoutez un fournisseur personnalisé sous models.providers :

{
  agents: {
    defaults: { model: { primary: "byesu/gpt-5.5" } },   // 默认用哪个模型
  },
  models: {
    mode: "merge",                   // 合并内置服务商，而非覆盖
    providers: {
      byesu: {
        baseUrl: "https://byesu.com/v1",
        apiKey: "${BYESU_API_KEY}",      // 建议用环境变量，避免明文
        api: "openai-completions",       // OpenAI 兼容
        models: [
          { id: "gpt-5.5", name: "Byesu GPT-5.5" },
          { id: "claude-opus-4-8", name: "Byesu Claude Opus 4.8" },
        ],
      },
    },
  },
}

Quelques points importants

• Le baseUrl se termine par /v1 (compatible OpenAI).
• Pour apiKey, il est recommandé d'utiliser la variable d'environnement ${BYESU_API_KEY} (placez la vraie clé dans une variable d'environnement) et de ne pas la valider en clair dans git : export BYESU_API_KEY="sk-xxxx".
• Si la Gateway tourne en service d'arrière-plan / démon, assurez-vous que cette variable existe aussi dans l'environnement du processus du service (un simple export dans le terminal courant ne sera pas lu et provoquera une erreur 401) ; pour un usage strictement local sans passage par git, vous pouvez aussi renseigner la clé en clair directement dans la configuration.
• L'id dans models doit correspondre exactement au nom du modèle dans la console.
• Le chemin exact du fichier de configuration est celui généré par l'assistant openclaw onboard (certaines versions l'enregistrent dans ~/.config/openclaw/).

Vérifier l'intégration

openclaw models list     # vérifiez que les modèles préfixés byesu/ apparaissent dans la liste

Vous pouvez aussi lancer openclaw dashboard pour ouvrir l'interface et envoyer une phrase de test directement.

Bloqué ?

Si une erreur reste incompréhensible, lancez d'abord openclaw gateway --port 18789 au premier plan pour observer directement les journaux et les messages d'erreur.

• 401 / jeton invalide → la clé est erronée, ou le service d'arrière-plan ne lit pas la variable d'environnement BYESU_API_KEY (voir les points importants ci-dessus) (détails)
• Aucun canal disponible → le modèle n'est pas dans le groupe de votre jeton (Choisir un groupe, détails)
• Pour les autres cas, voir Erreurs courantes et solutions