Repolode
제출하기
aidanpark

aidanpark/openclaw-android

전체 proot Linux 배포판 없이 glibc 동적 링커만 사용해 Termux에서 Android용 OpenClaw AI 에이전트 플랫폼을 설치하고 실행합니다.

GitHub에서 보기
스타
1,784
포크
227
열린 이슈
14
마지막 커밋
6일 전

어떤 프로젝트인가요?

Android용 OpenClaw는 Termux 안에서 Android 휴대폰으로 OpenClaw AI 에이전트 플랫폼을 실행하는 설치 프로그램입니다. 일반적인 방식은 proot-distro를 통해 Debian 또는 Ubuntu 환경 전체를 설치하는 것으로, 이 경우 추가로 1GB가 훨씬 넘는 저장 공간이 필요합니다. 이 프로젝트는 대신 pacman의 glibc-runner를 통해 glibc 동적 링커만 설치하고, 로더 스크립트로 감싼 linux-arm64 Node.js 빌드를 사용합니다. 따라서 저장 공간을 약 200MB만 사용하면서 OpenClaw를 네이티브 속도로 실행할 수 있습니다.

설치 프로그램은 /tmp, /bin/sh, /usr/bin/env의 경로 변환, 임시 폴더 설정, systemd 우회 등 Termux와 일반 Linux의 차이를 자동으로 처리합니다. 별도의 Claw Android 앱은 Termux 없이 터미널과 WebView 대시보드를 하나의 APK에 담아 제공합니다. 또한 설치 업데이트, 백업, 복원, 상태 확인을 위한 `oa` CLI도 제공합니다.

이 프로젝트는 검증을 마친 버전으로 OpenClaw와 Node.js를 고정하며, OpenClaw 자체 업데이트 명령을 차단해 업그레이드가 `oa --update`를 통해서만 진행되도록 합니다. tmux, ttyd, code-server, Playwright, AI CLI 등의 도구는 설정 중 선택적으로 설치할 수 있습니다.

핵심 기능

  • 01proot Linux 배포판 없이 glibc 동적 링커만 사용해 Android에서 OpenClaw를 실행합니다.
  • 02Linux 경로를 자동으로 변환하고 Termux를 설정해 명령 하나로 설치 프로그램을 실행합니다.
  • 03Termux 없이 터미널과 대시보드를 제공하는 독립형 Claw 앱을 제공합니다.
  • 04업데이트, 백업, 복원, 상태 확인을 위한 `oa` CLI가 포함되어 있습니다.
  • 05검증된 버전으로 OpenClaw와 Node.js를 고정하고 설치 전에 여유 저장 공간을 확인합니다.
  • 06tmux, ttyd, code-server, Playwright, AI CLI 도구를 선택적으로 설치할 수 있습니다.

활용 사례

  • 오래된 Android 휴대폰을 저전력 상시 구동 OpenClaw 호스트로 활용합니다.
  • PC나 root 권한 없이 휴대폰에서 자체 호스팅 AI 에이전트를 실행합니다.
  • 전체 Linux VM이나 컨테이너의 오버헤드 없이 ARM 하드웨어에서 OpenClaw를 테스트합니다.

빠른 시작

  1. 1

    F-Droid에서 Termux를 설치합니다(Play 스토어 버전은 사용하지 마세요).

  2. 2

    Termux를 업데이트하고 curl을 설치합니다.

    pkg upgrade -y && pkg install -y curl
  3. 3

    명령어 하나로 OpenClaw를 설치합니다.

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

    온보딩 설정을 실행합니다.

    openclaw onboard

사용 전 알아둘 점

  • Android만 지원하며, F-Droid에서 설치한 Termux가 필요합니다.
  • 약 2GB의 여유 저장 공간이 필요하고 설치에 3~10분이 걸립니다.
  • 고정된 OpenClaw 버전이 항상 최신 릴리스인 것은 아닙니다.

토픽

#android#termux#ai-agent#openclaw#self-hosted#nodejs#low-power#ai#homelab#repurpose-phone

자주 묻는 질문

openclaw-android은(는) 무엇인가요?
전체 proot Linux 배포판 없이 glibc 동적 링커만 사용해 Termux에서 Android용 OpenClaw AI 에이전트 플랫폼을 설치하고 실행합니다. Android용 OpenClaw는 Termux 안에서 Android 휴대폰으로 OpenClaw AI 에이전트 플랫폼을 실행하는 설치 프로그램입니다. 일반적인 방식은 proot-distro를 통해 Debian 또는 Ubuntu 환경 전체를 설치하는 것으로, 이 경우 추가로 1GB가 훨씬 넘는 저장 공간이 필요합니다. 이 프로젝트는 대신 pacman의 glibc-runner를 통해 glibc 동적 링커만 설치하고, 로더 스크립트로 감싼 linux-arm64 Node.js 빌드를 사용합니다. 따라서 저장 공간을 약 200MB만 사용하면서 OpenClaw를 네이티브 속도로 실행할 수 있습니다.
openclaw-android은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openclaw-android은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openclaw-android은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openclaw-android의 마지막 커밋은 2026년 10월 14일입니다.
openclaw-android은(는) 어디에 사용할 수 있나요?
오래된 Android 휴대폰을 저전력 상시 구동 OpenClaw 호스트로 활용합니다. PC나 root 권한 없이 휴대폰에서 자체 호스팅 AI 에이전트를 실행합니다. 전체 Linux VM이나 컨테이너의 오버헤드 없이 ARM 하드웨어에서 OpenClaw를 테스트합니다.
openclaw-android는 어떻게 설치하나요?
F-Droid에서 Termux를 설치합니다(Play 스토어 버전은 사용하지 마세요). Termux를 업데이트하고 curl을 설치합니다.: pkg upgrade -y && pkg install -y curl 명령어 하나로 OpenClaw를 설치합니다.: curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc 온보딩 설정을 실행합니다.: openclaw onboard
openclaw-android은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aidanpark/openclaw-android

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트