OpenClaw on Android – 빠른 개요

이것이 무엇인가 – 전체 Linux 배포판 없이 Android 휴대폰에서 OpenClaw AI 에이전트 플랫폼을 실행할 수 있는 얇은 설치 프로그램입니다. glibc 동적 링커, glibc로 빌드된 Node.js 바이너리, 표준 Linux 경로를 Termux 파일 시스템으로 변환하는 스크립트 세트를 제공하므로 일반 OpenClaw 바이너리가 네이티브로 작동합니다.

---

중요한 이유

기존 방식 (proot-distro)	이 프로젝트
전체 Debian/Ubuntu rootfs 설치 (약 1-2GB)	ld.so만 설치 (약 200MB)
20-30분 설정, 추가 proot 레이어 → 느림	3-10분 원커맨드 설치, 네이티브 속도
Termux 내에서 Linux 환경 관리 필요	Termux에서 직접 작동 (또는 선택적 Claw 앱 사용)

결과는 훨씬 작은 설치 공간, 더 빠른 실행, 그리고 휴대폰에서 OpenClaw 에이전트를 실행하려는 모든 사람에게 더 간단한 사용자 경험을 제공합니다.

---

주요 구성 요소

구성 요소	기능
glibc ld.so	GNU C 라이브러리 로더를 제공하여 표준 Linux 바이너리가 Android의 Bionic/Termux 환경에서 실행되도록 합니다.
Node.js (arm64, glibc)	OpenClaw JavaScript 런타임을 실행합니다. 작은 로더 스크립트로 래핑되어 patchelf가 필요 없습니다.
oa CLI	설치, 업데이트, 백업, 복원, 도구 관리를 위한 헬퍼 명령 (oa --install, oa --update, oa --backup 등).
Claw Android 앱 (선택)	터미널 에뮬레이터와 WebView UI를 번들로 제공합니다. 원탭 부트스트랩, 대시보드, 도구 설치 프로그램 – Termux와 완전히 독립적으로 작동합니다.
추가 도구	tmux, ttyd, dufs, Android 특정 유틸리티, Playwright, Claude-Code, Gemini-CLI, Codex-CLI (oa --install로 설치).

---

설치 단계 (Termux)

1. F-Droid에서 Termux 설치 (Play Store 버전은 죽었습니다).
2. 업그레이드 및 curl 설치:

   pkg upgrade -y && pkg install -y curl
   

3. 원라이너 설치 프로그램 실행:

   curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc
   

   glibc 로더, Node.js, OpenClaw를 약 200MB에 설치합니다.
4. OpenClaw 온보딩 완료:

   openclaw onboard
   

5. 게이트웨이 시작 (웹 대시보드를 제공하는 장기 실행 프로세스):

   openclaw gateway
   

   별도의 Termux 탭에서 실행하세요. 중지하려면 Ctrl+C를 누르세요.

---

선택적 Claw 앱 사용

• Releases 페이지에서 APK를 다운로드하세요.
• 앱은 터미널을 부팅하고 동일한 설치 프로그램을 실행한 다음 그래픽 대시보드 (http://127.0.0.1:18789)와 내부적으로 oa --update를 호출하는 설정 → 설치 및 업데이트 화면을 제공합니다.
• 추가 도구를 설치하고, 백업을 관리하며, 기존 Termux 설치에 영향을 주지 않고 런타임 정보를 표시할 수 있습니다.

---

설치 관리 (oa 명령)

명령	목적
oa --update	고정된 OpenClaw, Node.js 및 선택적 도구를 가져옵니다. 업데이트 전 백업을 만들고 여유 공간을 검증합니다.
oa --install	선택적 추가 기능 (tmux, code-server, AI CLI 등)을 설치합니다.
oa --uninstall	장치에서 OpenClaw와 glibc 로더를 제거합니다.
oa --backup / oa --restore	안전 검사와 함께 ~/.openclaw (SQLite DB 포함)를 tar 아카이브합니다. 바이너리가 아닌 데이터만 복원합니다.
oa --status	어떤 구성 요소가 있는지, 하드 링크 패치가 활성화되어 있는지 표시합니다.

모든 명령은 다시 실행해도 안전합니다. 동시 업데이트를 방지하기 위해 잠금이 설정됩니다.

---

데이터 안전 및 백업

• 백업은 ~/.openclaw-android/backup/에 저장되며 비공개 (chmod 600)입니다. API 키와 대화 기록이 포함되어 있습니다 – 절대 공유하지 마세요.
• 버전 변경 전에 설치 프로그램은 자동으로 업데이트 전 백업을 만듭니다 (최신 3개 유지).
• 복원은 Termux 설치와 Claw 앱 간에 데이터를 이동한 후 남아 있을 수 있는 오래된 절대 경로를 다시 씁니다.

---

성능 및 제한 사항

• 명령은 휴대폰 저장소의 많은 파일을 읽기 때문에 데스크톱보다 느리게 느껴질 수 있습니다.
• 게이트웨이는 Termux에서 직접 실행해야 합니다. SSH를 통해서는 SSH 세션이 종료되면 중지됩니다.
• 일부 무거운 도구 (code-server, Chromium)는 앱에서 설치할 수 없지만 터미널을 통해 수동으로 추가할 수 있습니다.

---

누가 이것을 사용해야 하나요?

• 모바일 장치에서 OpenClaw를 실험하려는 AI 에이전트 개발자.
• 테스트나 이동 중 디버깅을 위해 휴대 가능하고 오버헤드가 낮은 OpenClaw 노드가 필요한 파워 유저.
• Android에서 원커맨드, Linux 배포판 불필요 설정을 원하는 모든 사람.

---

빠른 참조 치트 시트

# 설치 (Termux)
curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc

# 첫 온보딩
openclaw onboard

# 게이트웨이 실행 (탭에서 유지)
openclaw gateway

# 모든 것 업데이트
oa --update && source ~/.bashrc

# 추가 도구 설치 (tmux, AI CLI 등)
oa --install

# 데이터 백업
oa --backup

# 백업 복원
oa --restore

---

결론: OpenClaw on Android는 무거운 proot-distro 요구 사항을 제거하여 가벼운 (약 200MB) 네이티브 설치를 제공합니다. 이를 통해 전체 OpenClaw 에이전트 생태계가 휴대폰에서 직접 실행될 수 있으며, Claw 앱을 통해 선택적 GUI 지원도 가능합니다.