Installer OpenClaw sur Ubuntu : guide complet

Introduction

Ubuntu est l'une des distributions Linux les plus utilisées par les développeurs, et c'est une base solide pour déployer OpenClaw. Ses dépôts apt bien maintenus, sa gestion native de Python 3 et son écosystème systemd en font un environnement prévisible pour faire tourner des agents IA en local ou sur un serveur dédié. Ce guide cible spécifiquement Ubuntu 22.04 LTS et Ubuntu 24.04 LTS, avec les commandes apt exactes, les pièges courants liés à la gestion multi-version de Python et les ajustements firewall. Si vous suivez un guide d'installation générique d'OpenClaw, ce tutoriel va plus loin sur les spécificités Ubuntu.

Résumé rapide

1. Mettre à jour le système : sudo apt update && sudo apt upgrade -y
2. Installer Python 3.10+, pip, git, virtualenv via apt
3. Créer un virtualenv dédié et l'activer
4. Installer OpenClaw : pip install openclaw
5. Vérifier l'installation : openclaw --version
6. Ouvrir les ports nécessaires si besoin avec ufw

Ubuntu comme environnement idéal pour OpenClaw

Ubuntu offre plusieurs avantages concrets pour faire tourner OpenClaw, que vous soyez sur une machine locale ou un serveur.

Versions Python pré-packagées. Ubuntu 22.04 LTS livre Python 3.10 par défaut, et Ubuntu 24.04 LTS livre Python 3.12. OpenClaw supporte Python 3.10 et supérieur — les deux versions LTS sont donc compatibles sans compilation depuis les sources.

Gestion des dépendances apt. Les paquets système comme build-essential, libssl-dev ou python3-dev, parfois requis pour compiler des dépendances Python, sont disponibles directement via apt. Pas besoin de passer par des gestionnaires tiers.

Systemd natif. Si vous voulez lancer OpenClaw comme service en arrière-plan (par exemple sur un serveur Ubuntu), systemd est intégré nativement et bien documenté. La configuration d'un service est directe.

Ubuntu 22.04 vs 24.04. Les deux versions LTS sont supportées. La différence principale concerne la version de Python par défaut : 3.10 sur 22.04, 3.12 sur 24.04. Les commandes apt restent identiques dans les deux cas. Si vous êtes sur 22.04, pip s'appelle pip3 par défaut dans les scripts système — notez-le pour vos alias.

Desktop vs Server. Sur Ubuntu Desktop, vous avez accès à un navigateur pour l'interface web d'OpenClaw si elle est activée. Sur Ubuntu Server, vous devrez passer par un accès SSH avec port forwarding ou configurer un reverse proxy (nginx, caddy) pour accéder à l'interface. Cette différence est abordée dans la section dédiée ci-dessous.

Pour les environnements cloud, consultez aussi le guide OpenClaw sur VPS qui couvre la configuration spécifique aux machines distantes.

Installer OpenClaw pas à pas sur Ubuntu

Prérequis système

Avant de commencer, vérifiez que votre environnement remplit ces conditions :

• Ubuntu 22.04 LTS ou Ubuntu 24.04 LTS (desktop ou server)
• Minimum 2 Go de RAM (4 Go recommandés si vous faites tourner un LLM local)
• Accès terminal avec droits sudo
• Connexion internet active

Étape 1 — Mettre à jour le système

Commencez toujours par une mise à jour complète du système. Cela évite les conflits de dépendances lors des installations suivantes.

sudo apt update && sudo apt upgrade -y

Attendez la fin de l'opération. Si une mise à jour du noyau est proposée, un redémarrage peut être nécessaire.

Étape 2 — Installer Python, pip, git et virtualenv

Ubuntu 22.04 et 24.04 incluent Python 3 par défaut, mais pip et venv ne sont pas toujours présents. Installez l'ensemble des dépendances en une commande :

sudo apt install -y python3 python3-pip python3-venv git build-essential

Vérifiez les versions installées :

python3 --version
# Python 3.10.x (sur Ubuntu 22.04) ou Python 3.12.x (sur Ubuntu 24.04)

pip3 --version
# pip 22.x ou supérieur

Si la commande pip3 n'est pas reconnue après installation, relancez le terminal ou exécutez hash -r pour rafraîchir le cache de commandes.

Étape 3 — Créer un environnement virtuel dédié

Travailler dans un virtualenv isole OpenClaw du reste du système et évite les conflits de paquets. C'est particulièrement important sur Ubuntu, où modifier les paquets Python système peut casser des outils système.

# Créer le virtualenv dans votre répertoire home
python3 -m venv ~/openclaw-env

# Activer l'environnement virtuel
source ~/openclaw-env/bin/activate

Une fois activé, votre prompt affiche (openclaw-env) en préfixe. Toutes les installations pip suivantes seront isolées dans cet environnement.

Étape 4 — Installer OpenClaw

Avec le virtualenv activé, installez OpenClaw via pip :

pip install openclaw

Output attendu :

Collecting openclaw
  Downloading openclaw-x.x.x-py3-none-any.whl (...)
Installing collected packages: openclaw
Successfully installed openclaw-x.x.x

Si vous avez besoin d'une version spécifique :

pip install openclaw==1.2.3

Étape 5 — Vérifier l'installation

openclaw --version

Output attendu :

OpenClaw version x.x.x

Si la commande n'est pas trouvée, vérifiez que le virtualenv est bien activé (source ~/openclaw-env/bin/activate).

Étape 6 — Ubuntu Desktop vs Ubuntu Server

Sur Ubuntu Desktop, OpenClaw est accessible directement via le navigateur si une interface web est activée. Lancez OpenClaw et ouvrez http://localhost:3000 (ou le port configuré) dans Firefox ou Chromium.

Sur Ubuntu Server, vous avez deux options :

Option A — Port forwarding SSH depuis votre machine locale :

ssh -L 3000:localhost:3000 user@votre-serveur

Puis accédez à http://localhost:3000 sur votre machine locale.

Option B — Configurer nginx comme reverse proxy pour exposer OpenClaw en HTTPS. Cette approche est recommandée pour les déploiements permanents.

Étape 7 — Configurer ufw si nécessaire

Ubuntu inclut ufw (Uncomplicated Firewall) activé par défaut sur les installations server. Si OpenClaw doit être accessible depuis l'extérieur :

# Autoriser le port d'OpenClaw (adaptez le numéro de port)
sudo ufw allow 3000/tcp

# Vérifier les règles actives
sudo ufw status

Sur Ubuntu Desktop, ufw est généralement désactivé par défaut — aucune action requise pour un usage local.

Dépannage courant Ubuntu

Erreur : pip non disponible ou commande introuvable

Sur certaines installations minimales Ubuntu, pip n'est pas installé. Solution :

sudo apt install python3-pip

Si vous êtes dans un virtualenv et que pip est absent, réinitialisez le virtualenv avec python3 -m venv --upgrade ~/openclaw-env.

Erreur : conflit Python 2 / Python 3

Ubuntu 22.04 peut avoir des traces de Python 2 dans certaines configurations legacy. Si python (sans le 3) pointe vers Python 2 :

python --version
# Python 2.7.x → problème

# Vérifier la version correcte
python3 --version

Utilisez systématiquement python3 et pip3 en dehors des virtualenvs, ou créez un alias dans votre ~/.bashrc :

alias python=python3
alias pip=pip3

Erreur : externally-managed-environment sur Ubuntu 24.04

Ubuntu 24.04 protège l'environnement Python système. Si vous tentez pip install sans virtualenv :

error: externally-managed-environment

Solution : utilisez toujours un virtualenv (étape 3) ou ajoutez le flag --break-system-packages uniquement si vous savez ce que vous faites.

Erreur : permissions refusées sur les fichiers de log ou de config

OpenClaw crée des fichiers dans ~/.openclaw/ par défaut. Si vous lancez OpenClaw avec sudo, les fichiers seront créés avec les droits root et inaccessibles à votre utilisateur normal. Ne lancez pas OpenClaw avec sudo. Si les fichiers existent déjà avec des droits root :

sudo chown -R $USER:$USER ~/.openclaw

Checklist de validation

• python3 --version retourne 3.10 ou supérieur
• pip3 --version retourne pip 22+
• Le virtualenv est activé ((openclaw-env) visible dans le prompt)
• openclaw --version retourne la version installée
• Le port 3000 d'OpenClaw est accessible (localhost ou firewall configuré)

Exemple concret : lancer un premier agent OpenClaw sur Ubuntu

Voici comment créer et lancer un premier agent OpenClaw depuis Ubuntu, en supposant que l'installation est terminée et le virtualenv activé.

Créez un fichier de configuration minimal pour un agent de veille :

mkdir ~/mon-agent && cd ~/mon-agent

Créez le fichier agent.py :

from openclaw import Agent, Task

# Définir un agent simple de résumé de texte
agent = Agent(
    name="veille-agent",
    description="Résume les actualités IA francophones",
    model="gpt-4o-mini",  # ou le LLM configuré dans openclaw config
)

# Définir une tâche
task = Task(
    description="Résume ce texte en 3 points clés : OpenClaw est un framework Python pour orchestrer des agents IA. Il supporte plusieurs LLMs et s'installe via pip.",
    agent=agent,
)

# Lancer l'agent
result = task.run()
print(result)

Lancez l'agent :

# Vérifier que le virtualenv est actif
source ~/openclaw-env/bin/activate

# Lancer le script
python agent.py

Output attendu :

[veille-agent] Traitement de la tâche...
1. OpenClaw est un framework Python dédié à l'orchestration d'agents IA.
2. Il supporte plusieurs modèles de langage (LLMs).
3. L'installation s'effectue via pip, sans dépendances système complexes.

Pour configurer OpenClaw avec votre clé API et connecter un LLM spécifique, consultez le guide de configuration dédié — c'est la prochaine étape logique après l'installation.

Bonnes pratiques

Ne lancez jamais OpenClaw avec sudo. Les agents IA créent des fichiers de session et de config dans le répertoire utilisateur. Utiliser sudo génère des problèmes de permissions qui cassent les runs suivants.

Nommez vos virtualenvs de manière explicite. Si vous avez plusieurs projets OpenClaw, préférez ~/envs/openclaw-prod et ~/envs/openclaw-test plutôt que des noms génériques. Cela facilite le diagnostic.

Gardez le virtualenv séparé du projet. Ne créez pas le virtualenv à l'intérieur du dossier de code. Placez-le dans ~/envs/ ou ~/.venvs/ pour éviter de le versionner accidentellement avec git.

Fixez les versions dans un requirements.txt. Une fois votre setup stable, exportez les dépendances :

pip freeze > requirements.txt

Cela permet de recréer l'environnement à l'identique sur un autre serveur Ubuntu.

Automatisez l'activation du virtualenv. Si vous utilisez OpenClaw souvent, ajoutez dans ~/.bashrc :

alias oclaw='source ~/openclaw-env/bin/activate && openclaw'

Surveiller les mises à jour Python système. Les mises à jour de sécurité Ubuntu peuvent mettre à jour Python. Vérifiez régulièrement que votre virtualenv reste compatible avec python3 --version dans et hors du virtualenv.

Questions fréquentes

OpenClaw est-il compatible avec Ubuntu 22.04 ?

Oui. Ubuntu 22.04 LTS livre Python 3.10 par défaut, qui est la version minimale requise par OpenClaw. Installez python3-pip et python3-venv via apt, créez un virtualenv, puis pip install openclaw. Toutes les fonctionnalités sont disponibles sur cette version LTS supportée jusqu'en 2027.

Comment installer openclaw ubuntu sans pip ?

Si pip n'est pas disponible sur votre système, installez-le d'abord : sudo apt install python3-pip. Alternativement, vous pouvez cloner le dépôt officiel OpenClaw depuis GitHub et lancer python3 setup.py install depuis un virtualenv activé, mais l'installation via pip reste la méthode recommandée.

Quelle est la différence entre setup openclaw linux et setup openclaw ubuntu ?

Le setup Linux générique couvre des distributions variées (Debian, Fedora, Arch) avec des gestionnaires de paquets différents. Le setup Ubuntu utilise spécifiquement apt, les noms de paquets Debian (python3-pip, python3-venv, build-essential) et gère les particularités Ubuntu comme la protection externally-managed-environment introduite dans Ubuntu 24.04.

Puis-je utiliser OpenClaw sur Ubuntu Server sans interface graphique ?

Oui. OpenClaw fonctionne en mode headless sur Ubuntu Server. Pilotez-le entièrement en ligne de commande ou via son API. Si une interface web est nécessaire, utilisez le port forwarding SSH (ssh -L 8080:localhost:8080 user@serveur) ou configurez un reverse proxy nginx.

Comment lancer OpenClaw au démarrage sur Ubuntu ?

Créez un service systemd. Exemple minimal dans /etc/systemd/system/openclaw.service :

[Unit]
Description=OpenClaw Agent Service
After=network.target

[Service]
User=votre-utilisateur
WorkingDirectory=/home/votre-utilisateur/mon-agent
ExecStart=/home/votre-utilisateur/openclaw-env/bin/openclaw start
Restart=on-failure

[Install]
WantedBy=multi-user.target

Puis : sudo systemctl enable openclaw && sudo systemctl start openclaw.

Articles liés

L'installation sur Ubuntu est la base. Une fois OpenClaw opérationnel, l'étape suivante est de le configurer pour connecter votre LLM et définir les comportements de vos agents. Pour les environnements de production ou cloud, le déploiement sur VPS offre plus de flexibilité et de puissance. Consultez les ressources ci-dessous pour progresser étape par étape.

• Guide d'installation générique d'OpenClaw
• Déployer OpenClaw sur un VPS cloud
• Configurer OpenClaw : LLM, API keys et paramètres
• Créer son premier agent avec OpenClaw
• OpenClaw vs LangGraph : lequel choisir pour vos agents ?