Correctif pour exécuter OpenClaw sur Android via proot Ubuntu : Détourner networkInterfaces() pour résoudre l'erreur uv_interface_addresses 13

Exécuter OpenClaw sur Android avec proot Ubuntu

Un développeur a documenté une solution pour exécuter OpenClaw sur un appareil Android en utilisant Termux et un environnement proot Ubuntu. La configuration spécifique impliquait un téléphone Xiaomi avec un processeur Snapdragon 8 Gen 3 exécutant Android 16.

Le Problème : Bionic libc Bloque l'Appel Système

Lors de la tentative d'exécution d'OpenClaw version 2026.3.13, l'application plante immédiatement avec l'erreur : uv_interface_addresses a retourné une erreur système inconnue 13. La cause racine est que la libc Bionic d'Android (bibliothèque C) bloque l'appel système sous-jacent à l'intérieur de l'environnement proot. Cela fait échouer la fonction os.networkInterfaces() de Node.js, empêchant l'initialisation d'OpenClaw.

La Solution : Un Script de Détournement

La solution consiste à créer un simple fichier JavaScript qui remplace la fonction networkInterfaces() avant le chargement d'OpenClaw. Créez le script suivant à l'intérieur de l'environnement proot Ubuntu :

cat << 'EOF' > /root/hijack.js
const os = require('os');
os.networkInterfaces = () => ({
  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

Pour rendre cette solution permanente et l'appliquer au démarrage d'OpenClaw, ajoutez ce qui suit à votre configuration shell :

echo 'export NODE_OPTIONS=--require=/root/hijack.js' >> ~/.bashrc
source ~/.bashrc
openclaw gateway

Étapes Complètes de Configuration

La source décrit le processus de configuration complet :

• Installez Termux depuis F-Droid.
• Exécutez proot-distro install ubuntu.
• Installez Node.js 22 via NodeSource.
• Installez OpenClaw globalement : npm install -g openclaw.

Pendant le processus d'intégration, sélectionnez Boucle locale 127.0.0.1 comme adresse de liaison de la passerelle. Avec la solution appliquée, la passerelle fonctionne de manière stable à http://127.0.0.1:18789.

Application Plus Large

Le développeur note que cette même solution devrait fonctionner pour toute application Node.js rencontrant l'erreur uv_interface_addresses lors de son exécution dans un environnement proot sur Android 12 ou ultérieur.