Android에서 proot Ubuntu를 통해 OpenClaw 실행 수정: uv_interface_addresses 오류 13 해결을 위한 networkInterfaces() 가로채기

proot Ubuntu를 사용해 Android에서 OpenClaw 실행하기

한 개발자가 Termux와 proot Ubuntu 환경을 사용해 Android 기기에서 OpenClaw를 실행하기 위한 수정 방법을 문서화했습니다. 구체적인 설정은 Snapdragon 8 Gen 3 프로세서와 Android 16을 실행하는 Xiaomi 휴대폰을 포함했습니다.

문제: Bionic libc가 시스템 호출을 차단함

OpenClaw 버전 2026.3.13을 실행하려고 할 때, 애플리케이션이 uv_interface_addresses returned Unknown system error 13 오류와 함께 즉시 충돌합니다. 근본 원인은 Android의 Bionic libc(C 라이브러리)가 proot 환경 내부의 기본 시스템 호출을 차단하기 때문입니다. 이로 인해 Node.js의 os.networkInterfaces() 함수가 실패하여 OpenClaw가 초기화되지 못합니다.

해결책: 하이재킹 스크립트

해결책은 OpenClaw가 로드되기 전에 networkInterfaces() 함수를 재정의하는 간단한 JavaScript 파일을 만드는 것입니다. 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

이 수정 사항을 영구적으로 만들고 OpenClaw를 시작할 때 적용하려면 셸 구성에 다음을 추가하세요:

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

전체 설정 단계

원본은 전체 설정 과정을 설명합니다:

• F-Droid에서 Termux를 설치하세요.
• proot-distro install ubuntu를 실행하세요.
• NodeSource를 통해 Node.js 22를 설치하세요.
• OpenClaw를 전역적으로 설치하세요: npm install -g openclaw.

온보딩 과정 중에 게이트웨이 바인드 주소로 Loopback 127.0.0.1을 선택하세요. 수정 사항이 적용되면 게이트웨이가 http://127.0.0.1:18789에서 안정적으로 실행됩니다.

더 넓은 적용 범위

개발자는 이 동일한 수정 사항이 Android 12 이상에서 proot 환경 내부에서 실행될 때 uv_interface_addresses 오류를 만나는 모든 Node.js 애플리케이션에 작동할 것이라고 언급했습니다.