Deux voies pour déployer OpenClaw en cloud en 2026 : image one-click vs build source
Le déploiement d’OpenClaw sur un serveur cloud se fait principalement de deux façons : soit utiliser l’image d’application OpenClaw/Claw fournie par le cloud en un clic, adaptée à une validation rapide et à ceux qui ne veulent pas gérer les dépendances ; soit installer Node 22 à la main, installer openclaw globalement via npm ou pnpm et configurer soi-même, adapté aux équipes qui ont besoin de personnalisation ou d’un flux d’exploitation fixe. L’image one-click permet d’accéder à la console en 3 à 5 minutes, mais l’OS et la version sont dictés par l’image ; le build source prend 20 à 30 minutes et permet de contrôler précisément les versions Node et openclaw. En 2026 nous recommandons aux débutants de faire tourner d’abord avec l’image one-click, puis de migrer vers une installation maison ou un Mac distant selon les besoins.
Exigences et incontournables : Node 22, ouvrir le port 18789, pare-feu et groupe de sécurité
Quelle que soit la voie, les trois points suivants sont obligatoires, sinon la console est inaccessible et le service n’est pas exposé correctement.
| Élément | Exigence | Remarque |
|---|---|---|
| Node.js | ≥ 22.0.0 | En dessous de 22 des erreurs d’installation ou d’exécution peuvent apparaître ; gérer avec nvm : nvm install 22 && nvm use 22 |
| Port | TCP 18789 | Port par défaut de la console et de la passerelle OpenClaw ; doit être autorisé en entrée dans le groupe de sécurité/pare-feu de l’instance |
| OS et ressources | Linux Ubuntu 20.04+ / macOS / Windows WSL2 ; minimum 2 cœurs, 2 Go RAM, 20 Go disque | Les images cloud couvrent en général ; à vérifier en build maison |
Sur un serveur cloud (Tencent Cloud, Alibaba Cloud, etc.), ouvrir dans la console « Groupe de sécurité » ou « Pare-feu » et ajouter une règle entrante : protocole TCP, port 18789, source 0.0.0.0/0 (ou restreindre les IP si besoin). Sinon l’accès à http://IP-du-serveur:18789 dans le navigateur restera en timeout.
Problèmes courants à l’installation : version Node, blocage/timeout npm, miroir et pnpm
Les trois problèmes d’installation les plus fréquents en 2026 et comment les résoudre.
# 1. Vérifier et changer la version Node (≥ 22)
node -v
nvm install 22
nvm use 22
# 2. Configurer un miroir npm (blocage/timeout)
npm config set registry https://registry.npmmirror.com
# 3. Utiliser pnpm à la place de npm (optionnel, souvent plus rapide)
npm install -g pnpm
pnpm add -g openclaw@latest
# 4. Script d’installation one-click (officiel, toutes plateformes)
curl -fsSL https://openclaw.ai/install.sh | bash
Node trop ancien : En cas d’erreur à l’installation ou au démarrage, exécuter d’abord node -v ; si < 22, installer Node 22 via nvm ou le paquet officiel et le définir par défaut.
npm install bloque ou timeout : Configurer d’abord un miroir ; si toujours instable, installer avec pnpm.
Le conteneur Docker ne démarre pas : Vérifier si 18789 est déjà utilisé (netstat -an | grep 18789) et si le téléchargement de l’image est complet (accélération miroir possible).
Console inaccessible, Telegram/Feishu ne répond pas – étapes de vérification
La console ne s’ouvre pas (http://IP:18789 timeout ou refusé) : Dans la grande majorité des cas le port 18789 n’est pas ouvert dans le pare-feu. Dans la console cloud, vérifier le « Groupe de sécurité » de l’instance → règles entrantes et ajouter TCP 18789 ; en local ou Linux sur site, vérifier firewalld, ufw ou iptables pour autoriser 18789. Après ouverture, redémarrer OpenClaw et réessayer.
Le bot Telegram / Feishu ne répond pas : Vérifier d’abord qu’OpenClaw tourne (openclaw status ou processus) ; puis que le Token du canal est correct et que les capacités nécessaires sont activées dans les réglages du bot ; les logs openclaw logs --tail 50 montrent les erreurs de connexion ou d’auth. Plusieurs canaux peuvent être configurés en parallèle, l’historique est séparé par canal.
Multi-plateforme et exécution hors ligne (Ollama) – résumé
OpenClaw permet de configurer plusieurs canaux (Telegram, Discord, Feishu, etc.) sur la même instance ; tous partagent les mêmes capacités IA, l’historique des conversations est indépendant par canal. Les compétences et une partie des intégrations canal nécessitent le réseau ; avec Ollama ou d’autres modèles locaux, le dialogue principal peut tourner hors ligne. Choix de modèle : conversation courante Kimi, MiniMax ; tâches de code Claude Sonnet, GPT-4 ; coût maîtrisé DeepSeek, Qwen ; confidentialité prioritaire Ollama en local.
FAQ et checklist : image cloud vs Mac distant en continu
- Uniquement valider rapidement ou tester à court terme : Utiliser l’image OpenClaw du cloud, ouvrir le port 18789 comme ci-dessus et configurer la clé API.
- Besoin de stabilité 7×24 sans gérer l’hébergeur et les groupes de sécurité : Envisager de déployer OpenClaw sur un Mac distant hébergé (ex. SFTPMAC) : le fournisseur assure la disponibilité du nœud, des répertoires et droits clairs, adapté à l’automatisation longue durée et à la multiplateforme.
- Déjà dans l’écosystème Apple ou workflow Mac : Un Mac distant reste plus cohérent en compatibilité et collaboration bureau/fichiers, mises à jour et stratégie de backup plus faciles à unifier.
L’image cloud convient pour démarrer et valider vite ; quand la charge passe de « lancer de temps en temps » à « tourner en continu, multiplateforme, répertoires et droits clairs », l’hébergement Mac distant réduit la charge d’exploitation et améliore la stabilité.
La console OpenClaw est inaccessible, que faire ?
Dans la plupart des cas le port 18789 n'est pas ouvert dans le pare-feu ou le groupe de sécurité. Vérifier dans la console cloud le groupe de sécurité de l'instance et les règles entrantes, autoriser TCP 18789 ; en local ou Linux sur site, vérifier firewalld/ufw ou iptables pour 18789.
npm install bloque ou timeout, solution ?
Configurer un miroir : npm config set registry https://registry.npmmirror.com. Ou utiliser pnpm à la place de npm pour accélérer l'installation. Vérifier que Node >= 22.0.0, en dessous des problèmes de compatibilité peuvent bloquer.
Quand image cloud, quand Mac distant pour faire tourner OpenClaw en continu ?
L'image cloud convient pour une validation rapide, un essai court ou des ressources cloud existantes. Pour une stabilité 7×24, compatibilité écosystème Apple, répertoires et droits clairs, ou alignement avec le workflow Mac, nous recommandons un hébergement Mac distant (ex. SFTPMAC) pour un run continu.
Déployer OpenClaw soi-même sur un serveur cloud permet de démarrer vite, mais un run continu implique groupes de sécurité, mises à jour OS, sauvegardes et cohérence multi-environnements. Si vous préférez vous concentrer sur l’automatisation IA et déléguer l’exploitation, vous pouvez déployer OpenClaw sur les nœuds Mac distants fournis par SFTPMAC : nous assurons l’accessibilité du port 18789, des répertoires et droits clairs, ainsi que la multiplateforme et un fonctionnement 7×24 – vous n’avez qu’à configurer modèles et canaux.