.env, openclaw.json) et intégration directe dans les pipelines (GitHub Actions, scripts). Cet article décrit les étapes de déploiement — des prérequis Mac (mémoire, disque) au clone et docker-setup, à la configuration passerelle et modèles, au démarrage et à la vérification, puis à l’intégration CI. Un tableau récapitulatif et une section dépannage complètent le tutoriel. CTA : accueil, tarifs, achat ou blog.
Prérequis et environnement
Sur le Mac distant, assurez-vous que l’environnement est prêt pour Docker et OpenClaw. macOS (version récente recommandée) avec Docker Desktop ou le moteur Docker en ligne de commande doit être installé. Vérifiez la mémoire RAM : au moins 8 Go pour un usage léger, 16 Go ou plus pour des modèles plus lourds et des jobs CI parallèles. L’espace disque doit permettre le stockage des images Docker, du cache OpenClaw et des artefacts : prévoir au minimum 20 à 30 Go libres. Enfin, les ports utilisés par OpenClaw (selon votre openclaw.json) doivent être disponibles et, si vous êtes derrière un pare-feu, ouverts pour la CI (par exemple SSH ou l’API OpenClaw).
| Élément | Recommandation |
|---|---|
| macOS | Version récente (Ventura / Sonoma ou supérieur) |
| Docker | Docker Desktop ou Docker Engine installé et démarré |
| RAM | 8 Go min., 16 Go+ pour modèles lourds et CI |
| Disque | 20–30 Go libres (images + cache + artefacts) |
| Réseau | Ports OpenClaw accessibles ; SSH ou API pour la CI |
Étapes de déploiement Docker
Une fois les prérequis validés, le déploiement se fait en quelques commandes reproductibles.
Cloner le dépôt OpenClaw. Sur le Mac distant : git clone <url-du-repo-openclaw> puis cd dans le répertoire du projet.
Lancer le script docker-setup. Exécuter le script fourni par le projet (souvent ./docker-setup ou bash docker-setup.sh) pour construire les images et préparer les volumes. Vérifier les messages de sortie pour d’éventuelles erreurs.
Configurer .env. Copier le fichier d’exemple (ex. .env.example) vers .env, puis renseigner les variables nécessaires (clés API, URLs de passerelle, chemins). Ne pas commiter .env.
Démarrer les conteneurs. Lancer docker compose up -d (ou docker-compose up -d selon la version). Vérifier que les services sont « up » avec docker compose ps.
Vérifier le fonctionnement. Appeler l’API ou l’outil en ligne de commande OpenClaw (ex. openclaw status ou une requête HTTP de test) pour confirmer que le service répond correctement.
Passerelle et configuration des modèles
Le fichier openclaw.json pilote la passerelle (Kilo Gateway ou équivalent) et le choix des modèles. Adaptez les entrées suivantes selon votre environnement : gateway (URL ou type), models (liste des modèles utilisés), et éventuellement les timeouts et clés. Les variables sensibles (clés API) doivent rester dans .env et être lues par l’application au démarrage. Une fois openclaw.json et .env correctement renseignés, redémarrez les conteneurs avec docker compose down puis docker compose up -d pour appliquer les changements.
Appeler OpenClaw depuis la CI
Pour intégrer OpenClaw dans votre pipeline CI sur le même Mac distant, deux approches courantes : GitHub Actions (runner auto-hébergé sur le Mac) ou des scripts exécutés par votre orchestrateur (cron, Jenkins, GitLab CI, etc.). Dans GitHub Actions, configurez un job qui se connecte au Mac via SSH et exécute les commandes nécessaires (par exemple openclaw pull ou un curl vers l’API OpenClaw). Stockez les secrets (URL du Mac, clés SSH, token API) dans les secrets du dépôt. Pour les scripts, un wrapper bash ou Python peut appeler l’API OpenClaw (HTTP) ou la CLI ; assurez-vous que le réseau et les certificats sont corrects depuis le contexte d’exécution. En résumé : le Mac distant héberge Docker et OpenClaw ; la CI se connecte au Mac (SSH ou API) et déclenche les opérations.
Erreurs courantes et dépannage
Quelques pannes fréquentes et pistes de résolution.
- Port déjà utilisé : vérifier qu’aucun autre service n’écoute sur le port configuré dans
openclaw.jsonou dans Docker ; changer de port ou arrêter le service concurrent. - Mémoire insuffisante : le conteneur ou le Mac manque de RAM ; augmenter la mémoire allouée à Docker ou au Mac, ou réduire la charge (moins de workers, modèles plus légers).
- Échec de connexion à la passerelle : contrôler
.envetopenclaw.json(URL, clés) ; tester aveccurlou l’outil de diagnostic du projet. - Certificats ou SSL : en environnement CI, si les appels échouent pour des raisons de certificat, vérifier
SSL_CERT_FILEou les options de vérification désactivée (uniquement en dev/test).
En résumé
Le déploiement d’OpenClaw en Docker sur un Mac distant en 2026 repose sur des prérequis clairs (environnement Mac, mémoire, disque), un clone du dépôt et l’exécution de docker-setup, la configuration de .env et openclaw.json (passerelle et modèles), le démarrage et la vérification des conteneurs, puis l’intégration CI via GitHub Actions ou des scripts. La section dépannage permet de résoudre les erreurs les plus courantes (port, mémoire, passerelle, certificats). Pour faire tourner OpenClaw de façon stable et prévisible, un Mac distant dédié (par exemple Mac Mini M4) est idéal : consultez l’accueil, les tarifs, la page achat ou le blog MacPull pour louer un nœud et sécuriser vos pipelines.
Mac distant pour OpenClaw et CI
Environnement stable pour Docker et pipelines. Consultez l'accueil, les tarifs ou réservez un Mac sans connexion préalable.