Configuration d'OpenClaw
OpenClaw est un outil en ligne de commande et Web UI conçu pour les scénarios de programmation. Il prend en charge plusieurs protocoles de modèles ; l'essentiel de la configuration ne consiste donc pas seulement à renseigner une adresse, mais à faire correspondre le baseUrl et l'api par paires.
Présentation de l'outil et cas d'usage
Vérifier d'abord le choix du protocole
| Scénarios | Comment renseigner la Base URL | Comment choisir le champ API |
|---|---|---|
| OpenAI natif | Utiliser l'adresse d'API OpenAI / compatible OpenAI fournie par le provider, l'inclusion de /v1 dépend du backend | openai-responses |
| Claude natif | Utiliser l'adresse d'interface Anthropic / Claude fournie par le provider | anthropic-messages |
| Gemini natif | Utiliser l'adresse d'interface Google / Gemini fournie par le provider | google-generative-ai |
| Mode de compatibilité | L'adresse d'interface compatible OpenAI fournie par le provider | openai-completions |
Si la page du provider sépare les interfaces OpenAI, Claude et Gemini, ne copiez pas uniquement le nom de domaine ; copiez également l'adresse complète correspondant au protocole choisi.
Exemple d'extrait de configuration
Les fichiers de configuration se trouvent généralement dans ~/. openclaw/openclaw.json Si l'assistant d'initialisation ne parvient pas à renseigner correctement l'adresse du provider, vous pouvez d'abord ignorer la sélection du modèle puis modifier manuellement le fichier de configuration.
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }Vérification après l'enregistrement
- Commencez par configurer un seul provider, sans ajouter trop de modèles à la fois.
- Ouvrez le projet de test et sélectionnez le modèle nouvellement ajouté.
- Envoyez une question très courte, telle que « Répondez uniquement par : configuration réussie ».
- Si une erreur de protocole est signalée, vérifiez d'abord si le champ api et la Base URL proviennent du même type d'interface.
Questions fréquentes pour les débutants
| Problème rencontré | Vérification prioritaire | Action à effectuer |
|---|---|---|
| Erreur liée au protocole | api : vérifiez si le champ correspond à la Base URL | Ne mélangez pas OpenAI, Claude et Gemini ; renseignez selon le protocole correspondant du provider |
| La liste des modèles est vide | Le provider prend-il en charge la récupération de la liste des modèles ? | Saisissez manuellement l'identifiant / le nom du modèle fourni par le backend si la récupération échoue |
| Le fichier de configuration a été modifié mais ne prend pas effet | Vérifiez si le fichier de configuration effectivement lu par OpenClaw a bien été modifié | Redémarrez OpenClaw et réessayez ; évitez de modifier plusieurs paramètres de configuration en même temps |
| La clé est correcte mais la requête échoue | Les champs auth et apiKey du provider actuel | Vérifiez que la clé appartient bien au protocole et au provider actuels |