OpenClaw sur Linux et Ubuntu

Linux est la plateforme pour laquelle la passerelle est écrite : Node est l’environnement principal et recommandé, le service est une unité utilisateur systemd, et chaque guide serveur de la documentation finit ici. La partie plus récente est le compagnon de bureau, une application Tauri qui configure une passerelle locale ou se connecte à une passerelle distante, livrée en deb ou en AppImage, et qui vit dans la zone de notification. Voici ce que fait le compagnon au premier lancement, ce qu’exigent les paquets, les règles des connexions distantes, et les réserves sur la veille, les codecs et la voix.

La passerelle est entièrement prise en charge sous Linux.

Le compagnon au premier lancement

• Commencer, puis choisir où vit l’assistant : sur cet ordinateur, ce qui installe les prérequis manquants et démarre la passerelle en service utilisateur systemd ; ou sur un autre ordinateur, une passerelle découverte, une URL, ou un tunnel SSH, le port valant 18789 par défaut.
• Il installe la CLI et Node dans un environnement géré privé plutôt que d’exiger une installation globale, délègue installation, démarrage, arrêt et redémarrage au service géré par la CLI, découvre les passerelles proches par Bonjour et peut garder plusieurs tableaux de bord connectés à la fois.
• La configuration du modèle vérifie les identifiants, propose une connexion ou une clé, et exige une réponse de modèle réussie avant d’ouvrir l’agent ; l’assistant de démarrage peut ensuite importer des mémoires Claude Code, Codex ou Hermes dans l’espace de travail.

Installer le paquet

Les releases stables livrent un deb et une AppImage nommés d’après la version, avec un fichier de sommes de contrôle à côté. Le deb s’installe avec apt ; l’AppImage exige FUSE 2, le paquet libfuse2 ou sa variante t64 sur Ubuntu 24.04 et plus récent, ou tourne avec la variable d’extraction et d’exécution. Les AppImages publiées sont compilées sur Ubuntu 22.04 et exigent glibc 2.35 ou plus récent plus une libstdc++ qui fournit le symbole 3.4.30 : Ubuntu 22.04 et Debian 12 atteignent ce plancher, RHEL 9 et Rocky Linux 9 livrent 2.34 et ne peuvent pas l’exécuter, et extraire l’AppImage ne contourne pas l’exigence.

Connexions distantes et secrets

• Utilisez HTTPS ou des WebSockets sécurisés pour les connexions directes publiques ; HTTP ou WebSockets en clair sont réservés à la boucle locale, aux réseaux privés de confiance et aux hôtes du tailnet.
• Si la configuration enregistrée épingle une empreinte TLS, choisissez le tunnel SSH : le navigateur intégré ne peut pas appliquer l’épinglage de certificat, l’application refuse donc une connexion directe plutôt que d’exposer le tableau de bord ou ses identifiants.
• Une clé d’API de fournisseur dans l’environnement de l’application est conservée par le service de passerelle dans un fichier d’environnement réservé au propriétaire ; les clés d’administration de fournisseur, les jetons GitHub et les variables sans rapport ne sont pas copiés dans le service.

Comment installer OpenClaw liste toutes les méthodes d’installation pour le chemin CLI, et OpenClaw sur un VPS est la liste de contrôle pour un serveur Linux sans bureau.

Veille, codecs et voix

Avec systemd-logind, le compagnon prépare un bail de suspension pour sa passerelle locale avant la mise en veille de l’hôte et la reprend au réveil ; les routes distantes sont laissées tranquilles. La lecture des médias passe par GStreamer : WebM, Opus, Vorbis et WAV par les bons plugins, H.264, AAC et MP3 par libav ou les plugins bad, que le deb déclare et que l’AppImage embarque. La conversation vocale en temps réel dans la WebView intégrée n’est pas validée, parce que le shell n’accorde pas le micro à WebKitGTK, utilisez donc un navigateur ordinaire pour la voix. OpenClaw sur un Raspberry Pi est l’installation Linux sur le plus petit matériel, et La configuration requise pour OpenClaw donne le plancher général.

Sur Diali

Diali fait tourner la passerelle Linux pour vous, sur une instance isolée avec le service, les mises à jour et l’exposition pris en charge, et le compagnon de bureau n’est tout simplement pas nécessaire : le tableau de bord est l’application. OpenClaw hébergé sur Diali est l’assistant.

• Environnement Node, service utilisateur systemd, compagnon en deb ou AppImage.
• glibc 2.35 pour l’AppImage ; Ubuntu 22.04 et Debian 12 passent, RHEL 9 non.
• Les connexions distantes directes exigent TLS ; une empreinte épinglée signifie le tunnel SSH.