Clé API OpenClaw et modèle
Tutoriel complet d'installation 2026
Une fois OpenClaw installé, sans modèle connecté ce n'est qu'une coquille vide. Une clé API incorrecte, un service d'inférence local arrêté ou un modèle par défaut inadapté peuvent faire croire que OpenClaw est en panne. Ce guide reste un tutoriel complet d'installation 2026, avec un focus sur la chaîne modèle, clés et première validation : cloud ou local, stockage sécurisé des secrets, et preuve via le Dashboard que le modèle est bien appelé.
Clé → provider → modèle → réseau → logs
Dashboard et sonde
Cloud / local / hybride
1Installation terminée ≠ modèle utilisable
OpenClaw est réellement opérationnel surtout si la chaîne modèle est connectée, les clés sont stockées en sécurité et le modèle par défaut correspond à la tâche — pas seulement si npm install -g openclaw a réussi. Une passerelle active et le port 18789 OK signifient que la coquille tourne ; le travail exige une référence provider/model valide et une authentification. Les sections suivantes détaillent cette chaîne dans le flux d'installation complet.
openclaw models status ou un appel Agent minimal et vérifiez dans les logs les requêtes HTTP sortantes et la consommation de tokens.
2Avant l'installation : préparer modèles et clés
Avant de commencer : ① la liste des providers supportés par votre version (docs officielles) ; ② une clé API cloud et le nom de variable d'environnement ; ③ pour l'inférence locale, un point de terminaison HTTP compatible déjà à l'écoute et assez de RAM ; ④ un réseau joignant l'API du provider ou le port local. En hybride, précisez quelle machine héberge la passerelle et laquelle fait tourner l'inférence.
3Installation officielle et initialisation
Installez Node 24 et le CLI, puis openclaw onboard (éventuellement --install-daemon) pour le modèle par défaut et la passerelle. Vérifiez node -v et que launchd hérite des variables d'environnement — sinon les clés disparaissent au redémarrage. Pour Node 24 et le port 18789, voir le
guide de démarrage à froid.
4Modèles cloud et clé API
Les providers intégrés demandent surtout une authentification : openclaw onboard --auth-choice openai-api-key (les options exactes suivent l'assistant), ou export OPENAI_API_KEY="sk-your-placeholder" puis openclaw models set provider/model. Pour un proxy personnalisé, définissez models.providers et référencez les clés via ${ENV} — jamais en dur. Validez avec openclaw models status.
5Brancher un modèle local
L'inférence locale convient à la confidentialité et au contrôle des coûts ; les performances dépendent du matériel. Dans models.providers, renseignez un baseUrl local (ex. http://127.0.0.1:PORT/v1) et l'id du modèle. Testez d'abord avec curl, puis démarrez OpenClaw.
6Valider cloud, local et hybride
| Point de contrôle | Modèle cloud | Modèle local | Hybride |
|---|---|---|---|
| Authentification | models status indique le provider authentifié |
Endpoint local sans clé ou token interne uniquement | Les deux configurations visibles dans status |
| Connectivité | Accès sortant vers l'API du provider | curl sur le baseUrl local |
Sonder chaque chemin séparément — ne mélangez pas les étapes |
| Dashboard | 18789 OK + requêtes amont dans la session | Logs avec appels HTTP locaux | Modèle principal cloud, étapes sensibles en localcourant |
| Coût / confidentialité | Facturation à l'usage ; données sortantes | Électricité et matériel ; données sur la machine | Définir quelles tâches passent par quel chemin |
Le Dashboard est par défaut sur 127.0.0.1:18789 (état passerelle et logs). Si la page s'affiche sans réponse, parcourez le tableau ligne par ligne.
7Premier test de validation
openclaw agent --local --session-id smoke-test --message "Réponds uniquement : modèle OK" --timeout 90 — si le JSON affiche le bon provider/model et que les logs montrent des requêtes sortantes, la chaîne modèle est validée.
8Erreurs modèle vs erreurs d'installation
openclaw models list et orthographe provider/model ; pour un provider custom, vérifiez models.providers.*.models[].id.lsof -iTCP:18789, puis launchd — ce n'est pas un problème d'API modèle ; ne changez pas la clé en premier.9Maintenance continue
Faites tourner les clés régulièrement, suivez le catalogue avec models list et surveillez la facturation. Après un nouveau provider, openclaw models set pour changer le modèle principal par défaut.
- 1Préparer clés, réseau et (optionnel) endpoint local avant l'install
- 2Valider en quatre temps :
onboard→models status→ Dashboard → Agent minimal - 3Ordre de dépannage : clé → provider → modèle → réseau/service local → logs
- 4Ne jamais versionner les secrets ; séparer problèmes modèle et port/permissions
Sur Mac mini, la chaîne modèle est plus fluide
Passerelle et inférence locale sur macOS partagent le même chemin : Node 24, launchd et héritage des variables d'environnement. La mémoire unifiée du Mac mini M4 convient aux essais de modèles locaux de taille moyenne ; environ 4 W en veille pour une passerelle 24 h/24 ; Gatekeeper / FileVault réduisent l'exposition des clés. Pour stabiliser onboard et la validation Dashboard, le Mac mini M4 est un excellent socle — c'est le bon moment pour vous en équiper.