ai2saveai2save

OpenClaw Guide de configuration

OpenClaw ajoute des fournisseurs de modèles personnalisés via models.providers. ai2save utilise l'interface OpenAI Compatible, Base URL doit être rempli avec https://ai2save.com/v1.

1. Préparer OpenClaw et API Key

Si OpenClaw est déjà installé, vous pouvez passer l'installation :

npm install -g openclaw@latest
openclaw --version
  1. Ouvrez https://ai2save.com/keys.
  2. Créez un API Key appartenant au groupe de modèles OpenAI / GPT.
  3. Copiez la clé complète sk-....

2. Modifier le fichier de configuration OpenClaw

Le fichier de configuration par défaut de OpenClaw est :

~/.openclaw/openclaw.json

Windows prend généralement en charge %USERPROFILE%\.openclaw\openclaw.json. Les fichiers prennent en charge JSON5 et peuvent être fusionnés dans la configuration existante selon la structure ci-dessous :

{
  env: {
    vars: {
      AI2SAVE_API_KEY: "sk-votre-clé-api",
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "ai2save/gpt-5.5",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ai2save: {
        baseUrl: "https://ai2save.com/v1",
        apiKey: "${AI2SAVE_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "gpt-5.5",
            name: "GPT 5.5",
            reasoning: true,
            input: ["text"],
            contextWindow: 200000,
          },
        ],
      },
    },
  },
}

Explication des champs clés :

  • models.providers.ai2save.baseUrl : doit contenir /v1.
  • api: "openai-completions" : type d'interface utilisée par OpenClaw pour agir au nom de OpenAI Compatible.
  • models[].id : doit correspondre exactement à l'ID du modèle ouvert dans la console ai2save.
  • agents.defaults.model.primary : le format est id-fournisseur/id-modèle.
  • apiKey peut être écrit directement comme "sk-..." ; lorsqu'il est référencé par ${AI2SAVE_API_KEY}, il doit être défini dans env.vars.

Si vous souhaitez ajouter plusieurs modèles, continuez à les ajouter dans le tableau models, et changez primary en ai2save/model-id que vous souhaitez utiliser par défaut.

3. Appliquer et vérifier la configuration

OpenClaw Gateway écoutera les changements du fichier de configuration et s'appliquera automatiquement. Si la configuration ne prend pas effet immédiatement, exécutez :

openclaw gateway restart

Puis vérifiez si le modèle est déjà apparu dans OpenClaw :

openclaw models list --provider ai2save

Changer le modèle par défaut en ai2save :

openclaw models set ai2save/gpt-5.5

Si le modèle n'apparaît pas, exécutez le diagnostic et vérifiez les erreurs de configuration :

openclaw doctor

4. Vérification de la demande

  1. Ouvrez l'interface de chat ou WebChat de OpenClaw.
  2. Créez une nouvelle session et envoyez « Bonjour, veuillez rapporter le nom du modèle actuel ».
  3. Vérifiez que le routage du modèle indique ai2save/gpt-5.5.
  4. Pour la première fois, vérifiez uniquement avec les tâches textuelles ; une fois réussi, activez les outils complexes tels que fichiers, navigateur et contexte long.

OpenClaw effectue automatiquement des ajustements de compatibilité pour les agents OpenAI non officiels, il n’est pas nécessaire d’activer manuellement developer role. Si vous rencontrez des anomalies lors de l’appel des outils, assurez-vous d’abord que l’ID du modèle prend en charge l’utilisation des outils, puis augmentez le temps de dépassement si nécessaire.

5. Erreurs courantes

  • 401 / invalid_api_key : AI2SAVE_API_KEY n’est pas défini, la clé n’est pas entièrement copiée ou le groupe de clés ne correspond pas.
  • 404 / model not found : models[].id, primary ou le nom du modèle demandé ne correspond pas réellement.
  • Échec de connexion / réponse vide : Vérifiez que baseUrl est https://ai2save.com/v1 et n’écrivez pas l’adresse racine.
  • Liste des modèles vide : Confirmez models.mode: "merge" et assurez-vous que models.providers.ai2save.models[] contient au moins un modèle.
  • Configuration non appliquée après enregistrement : Réexécutez openclaw doctor et, si nécessaire, redémarrez OpenClaw Gateway.