OpenClaw sur Android : guide Termux

Déployer OpenClaw Gateway sur Android via Termux et proot

Les développeurs peuvent recycler un smartphone Android inutilisé en passerelle pour OpenClaw, un assistant IA open source. Ce guide a été testé sur un Xiaomi 11T avec un processeur Dimensity 1200, 8 Go de RAM et HyperOS 1.0.14.0. L'approche utilise Termux avec un environnement proot-Ubuntu pour exécuter Node.js 22 LTS et OpenClaw, contournant les limitations d'Android pour héberger une passerelle.

Prérequis : Android 10+, 4+ Go de RAM, Wi-Fi stable, une clé API d'OpenRouter ou Gemini. Stockage : ~4 Go.

Préparation de l'environnement

Installez F-Droid, puis installez Termux et Termux:API depuis celui-ci.

Dans Termux, exécutez :

pkg update && pkg upgrade -y
pkg install proot-distro -y
proot-distro install ubuntu
proot-distro login ubuntu

Dans Ubuntu :

apt update && apt upgrade -y
apt install -y curl git build-essential
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
node -v  # v22.16+

Installez OpenClaw :

npm install -g openclaw@latest
openclaw --version

Contourner les erreurs Bionic

Si la passerelle plante avec des erreurs os.networkInterfaces() ou EACCES, appliquez ce correctif :

Créez /root/bionic-bypass.js :

const os = require('os');
const _originalNetworkInterfaces = os.networkInterfaces;

os.networkInterfaces = function() {
  try {
    return _originalNetworkInterfaces.call(os);
  } catch (e) {
    return {
      lo: [{
        address: '127.0.0.1',
        netmask: '255.0.0.0',
        family: 'IPv4',
        mac: '00:00:00:00:00:00',
        internal: true,
        cidr: '127.0.0.1/8'
      }]
    };
  }
};

Commande pour le créer :

cat <<'EOF' > /root/bionic-bypass.js
const os = require('os');
const _originalNetworkInterfaces = os.networkInterfaces;

os.networkInterfaces = function() {
  try {
    return _originalNetworkInterfaces.call(os);
  } catch (e) {
    return {
      lo: [{
        address: '127.0.0.1',
        netmask: '255.0.0.0',
        family: 'IPv4',
        mac: '00:00:00:00:00:00',
        internal: true,
        cidr: '127.0.0.1/8'
      }]
    };
  }
};
EOF
echo 'export NODE_OPTIONS="-r /root/bionic-bypass.js"' >> ~/.bashrc
source ~/.bashrc

Pour annuler : sed -i '/bionic-bypass/d' ~/.bashrc && rm -f /root/bionic-bypass.js && source ~/.bashrc.

Configuration et lancement de la passerelle

Lancez l'assistant de configuration :

openclaw onboard

Sélectionnez :

• Liaison de la passerelle : loopback (la seule option sûre sans root).
• Fournisseur : OpenRouter (modèles gratuits), Gemini, OpenAI.
• Entrez votre clé API.

Lancez dans tmux (installez avec apt install tmux) :

tmux new -s oc
openclaw gateway --verbose

Détachez : Ctrl+B, D. Rattachez : tmux attach -t oc.

Panneau web : http://127.0.0.1:18789. Jeton : openclaw config get gateway.auth.token.

Empêcher Android de tuer le processus

• Exécutez termux-wake-lock dans Termux.
• Paramètres → Batterie → Termux → Aucune restriction.
• Pour Xiaomi/HyperOS :

- Batterie → Activité en arrière-plan → Termux → Aucune restriction.

- Applications → Termux → Démarrage automatique : activer.

Liste de vérification :

| Commande/Action | Résultat attendu |

|------------------|---------------------|

| openclaw --version | Version affichée sans erreurs |

| openclaw gateway --verbose | Fonctionne pendant 30+ secondes |

| http://127.0.0.1:18789 | Interface de contrôle se charge |

| Jeton dans l'interface | Connexion réussie |

| Message de test | Réponse IA reçue |

Intégration de messagerie

Plateformes prises en charge : Telegram (grammY), WhatsApp (Baileys), Discord, Slack, Signal, et autres. Configurez via l'assistant ou l'interface. Délai de réponse sur les modèles gratuits : 5–10 secondes.

Points clés

• Utilisez la liaison loopback pour minimiser les risques de sécurité.
• Stockez les clés API dans une configuration sécurisée.
• Mettez à jour Node.js et OpenClaw via docs.openclaw.ai.
• tmux est essentiel pour la persistance des sessions.
• Désactivez complètement l'optimisation de la batterie.

— Editorial Team