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
- Ouvrez https://ai2save.com/keys.
- Créez un API Key appartenant au groupe de modèles OpenAI / GPT.
- 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 estid-fournisseur/id-modèle.apiKeypeut être écrit directement comme"sk-..."; lorsqu'il est référencé par${AI2SAVE_API_KEY}, il doit être défini dansenv.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
- Ouvrez l'interface de chat ou WebChat de OpenClaw.
- Créez une nouvelle session et envoyez « Bonjour, veuillez rapporter le nom du modèle actuel ».
- Vérifiez que le routage du modèle indique
ai2save/gpt-5.5. - 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_KEYn’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,primaryou le nom du modèle demandé ne correspond pas réellement. - Échec de connexion / réponse vide : Vérifiez que
baseUrlesthttps://ai2save.com/v1et n’écrivez pas l’adresse racine. - Liste des modèles vide : Confirmez
models.mode: "merge"et assurez-vous quemodels.providers.ai2save.models[]contient au moins un modèle. - Configuration non appliquée après enregistrement : Réexécutez
openclaw doctoret, si nécessaire, redémarrez OpenClaw Gateway.