openclaw.json, pré-tirage et vérification des dépendances CI, dépannage des erreurs courantes. Public visé : équipes CI et devs sur Mac distant. Article structuré en étapes (HowTo) et liste de vérification.
OpenClaw sur Mac distant : comparaison des modes d’installation (script, Docker, npm) et recommandation
Sur un Mac distant, trois options d’installation sont courantes. Script officiel : exécution du script d’installation (curl ou wget) ; rapide, contrôle direct de l’environnement, idéal pour une machine dédiée ou un premier déploiement. Docker : image conteneurisée ; isolation et reproductibilité maximales, utile en CI partagée ou lorsque plusieurs versions doivent coexister ; nécessite Docker sur le Mac. npm : installation via npm install -g openclaw (ou équivalent) ; pratique si l’écosystème Node est déjà en place, mise à jour simple. Recommandation : pour un nœud CI dédié sur Mac distant, privilégier le script ou Docker selon que vous visez la simplicité ou l’isolation ; npm convient aux postes de dev ou aux pipelines déjà basés sur Node.
| Mode | Avantages | Inconvénients |
|---|---|---|
| Script | Rapide, contrôle total | Gestion manuelle des mises à jour |
| Docker | Isolation, reproductibilité CI | Prérequis Docker sur le Mac |
| npm | Intégration Node, mises à jour faciles | Dépend à l’environnement Node |
Installation des compétences ClawHub et points clés de la configuration openclaw.json
Les compétences étendent OpenClaw (pré-tirage, vérification, build). Depuis ClawHub, installez les compétences nécessaires via la CLI ou la configuration : par exemple openclaw skill add <skill-id> ou déclaration dans openclaw.json. Fichier openclaw.json : définir le gateway (Kilo ou autre), les modèles utilisés, et la liste des skills avec leurs paramètres (chemins, registries, timeouts). Points clés : (1) chemin du projet et répertoire de travail pour la CI ; (2) variables d’environnement (Node, npm registry) si les compétences en dépendent ; (3) stratégie de retry (attempts, minDelay, maxDelay) pour les pulls réseau. Une configuration minimale reproductible inclut skills, gateway et env (si besoin).
- Déclarer les compétences ClawHub utilisées (IDs et options).
- Configurer gateway et modèles si vous utilisez des agents IA.
- Définir retry (attempts, délais) pour les opérations réseau.
Pré-tirage et vérification des dépendances CI : choix et configuration des compétences
Pour intégrer le pré-tirage des dépendances à la CI, choisissez des compétences qui exécutent npm install / pod install / brew bundle (ou équivalents) en amont du build, et éventuellement une compétence de vérification (versions, checksums). En CI : (1) étape de pré-tirage déclenchée avant le build (cron, webhook ou script de pipeline) ; (2) utilisation du même openclaw.json que localement pour garantir la reproductibilité ; (3) cache des artefacts (node_modules, Pods) si la plateforme CI le permet, pour accélérer les runs suivants. Compétences typiques : « dependency-pull », « version-check » ; configurez les timeouts et retries selon la latence de votre Mac distant. Sur un nœud Mac distant dédié, cette étape réduit fortement les échecs aléatoires en début de build. Voir aussi l’article « OpenClaw auto-récupération : retry et pull » pour la stratégie de retry.
Erreurs courantes et dépannage (version Node, permissions, réseau)
Version Node : OpenClaw ou certaines compétences exigent une version minimale de Node (ex. 18+). Sur Mac distant, vérifiez node -v et utilisez nvm ou fnm si plusieurs versions coexistent. Erreur typique : « Engine not supported » ou « Expected Node >= 18 » — mettre à jour Node ou ajuster engines dans le projet. Permissions : échecs d’écriture dans node_modules ou répertoire de cache ; exécuter avec l’utilisateur approprié ou corriger les droits (chown / chmod). Réseau : timeouts, proxy ou firewall ; configurer les variables d’environnement (HTTP_PROXY, HTTPS_PROXY si besoin), augmenter les timeouts dans openclaw.json et activer les retries. Une vérification rapide est possible avec openclaw status ou openclaw doctor selon la version installée.
- 1
Node :
node -vpuis nvm/fnm si version incorrecte. - 2
Permissions : vérifier propriétaire et droits du répertoire de travail et du cache.
- 3
Réseau : proxy, timeout et retry dans openclaw.json ; tester avec
openclaw doctor.
Synthèse et recommandations
Sur un Mac distant, privilégiez l’installation OpenClaw par script ou Docker selon votre besoin d’isolation ; configurez ClawHub et openclaw.json (compétences, gateway, retry). Intégrez le pré-tirage des dépendances CI via des compétences dédiées et une étape dédiée dans le pipeline ; en cas d’erreur, vérifiez la version Node, les permissions et la configuration réseau (proxy, timeouts, retries). Un nœud Mac distant dédié (Mac Mini M4) avec OpenClaw correctement configuré réduit les échecs aléatoires et accélère les builds. Ce guide est conçu pour être reproductible étape par étape sur votre propre environnement. Consultez l’accueil, les tarifs, la page achat ou le blog MacPull pour louer ou acheter votre Mac distant.
Mac distant pour OpenClaw et pré-tirage CI
Nœud Mac dédié pour pré-tirage et build reproductibles. Consultez les tarifs ou réservez sans connexion préalable.