Android에서 OpenClaw: Termux 가이드

안드로이드에서 Termux와 proot로 OpenClaw 게이트웨이 배포하기

사용하지 않는 안드로이드 스마트폰을 오픈소스 AI 어시스턴트인 OpenClaw의 게이트웨이로 재활용할 수 있습니다. 이 가이드는 디멘시티 1200 프로세서, 8GB RAM, HyperOS 1.0.14.0이 탑재된 샤오미 11T에서 테스트되었습니다. 이 방법은 Termux와 proot-Ubuntu 환경을 사용하여 Node.js 22 LTS와 OpenClaw를 실행함으로써 안드로이드의 게이트웨이 호스팅 제약을 우회합니다.

필수 조건: 안드로이드 10 이상, 4GB 이상 RAM, 안정적인 Wi-Fi, OpenRouter 또는 Gemini의 API 키. 저장 공간: 약 4GB.

환경 준비

F-Droid를 설치한 후, Termux와 Termux:API를 설치합니다.

Termux에서 실행:

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

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+

OpenClaw 설치:

npm install -g openclaw@latest
openclaw --version

Bionic 오류 우회

게이트웨이가 os.networkInterfaces() 또는 EACCES 오류로 충돌하는 경우, 이 패치를 적용하세요:

/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'
      }]
    };
  }
};

생성 명령:

cat <<'EOF' > /root/bionic-bypass.js
[위 코드]
EOF
echo 'export NODE_OPTIONS="-r /root/bionic-bypass.js"' >> ~/.bashrc
source ~/.bashrc

되돌리기: sed -i '/bionic-bypass/d' ~/.bashrc && rm -f /root/bionic-bypass.js && source ~/.bashrc.

게이트웨이 구성 및 실행

설정 마법사 실행:

openclaw onboard

선택:

• Gateway Bind: loopback (루트 권한 없이 안전한 유일한 옵션).
• Provider: OpenRouter (무료 모델), Gemini, OpenAI.
• API 키 입력.

tmux로 실행 (설치: apt install tmux):

tmux new -s oc
openclaw gateway --verbose

분리: Ctrl+B, D. 재연결: tmux attach -t oc.

웹 패널: http://127.0.0.1:18789. 토큰: openclaw config get gateway.auth.token.

안드로이드에서 프로세스 종료 방지

• Termux에서 termux-wake-lock 실행.
• 설정 → 배터리 → Termux → 제한 없음.
• 샤오미/HyperOS의 경우:

- 배터리 → 백그라운드 활동 → Termux → 제한 없음.

- 앱 → Termux → 자동 시작: 활성화.

확인 체크리스트:

| 명령/동작 | 예상 결과 |

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

| openclaw --version | 오류 없이 버전 표시 |

| openclaw gateway --verbose | 30초 이상 실행 |

| http://127.0.0.1:18789 | 제어 UI 로드 |

| UI의 토큰 | 연결 성공 |

| 테스트 메시지 | AI 응답 수신 |

메신저 통합

지원 플랫폼: Telegram (grammY), WhatsApp (Baileys), Discord, Slack, Signal 등. 설정 마법사 또는 UI를 통해 구성하세요. 무료 모델의 응답 지연: 5–10초.

핵심 포인트

• 보안 위험을 최소화하려면 loopback 바인딩을 사용하세요.
• API 키는 안전한 구성에 저장하세요.
• Node.js와 OpenClaw는 docs.openclaw.ai를 통해 업데이트하세요.
• tmux는 세션 지속성에 필수적입니다.
• 배터리 최적화를 완전히 비활성화하세요.

— Editorial Team