Repolode
Submit
aidanpark

aidanpark/openclaw-android

Installs and runs the OpenClaw AI agent platform on Android directly in Termux, using only the glibc dynamic linker instead of a full proot Linux distribution.

View on GitHub
Stars
1,784
Forks
227
Open issues
14
Last commit
6 days ago

What is it?

OpenClaw on Android is an installer that runs the OpenClaw AI agent platform on Android phones inside Termux. The usual approach installs a full Debian or Ubuntu environment through proot-distro, which adds well over a gigabyte of overhead. This project instead installs only the glibc dynamic linker through pacman's glibc-runner, along with a linux-arm64 Node.js build wrapped by a loader script, so OpenClaw runs at native speed with roughly 200MB of storage used.

The installer handles the differences between Termux and standard Linux automatically, including path conversion for /tmp, /bin/sh and /usr/bin/env, temp folder setup, and bypassing systemd. A separate Claw Android app bundles a terminal and WebView dashboard into one APK without requiring Termux. The project also provides an `oa` CLI for updating, backing up, restoring and checking status of the installation.

The project pins OpenClaw and Node.js to versions it has verified, and blocks OpenClaw's own update command so upgrades go through `oa --update`. Optional tools such as tmux, ttyd, code-server, Playwright and AI CLIs can be installed during setup.

Key features

  • 01Runs OpenClaw on Android with only the glibc dynamic linker, without a proot Linux distribution.
  • 02Automatically converts Linux paths and configures Termux so the installer runs with one command.
  • 03Provides a standalone Claw app that bundles a terminal and dashboard without Termux.
  • 04Includes the `oa` CLI for updates, backup, restore and status checks.
  • 05Pins OpenClaw and Node.js to verified versions and checks free storage before installing.
  • 06Offers optional installs for tmux, ttyd, code-server, Playwright and AI CLI tools.

Use cases

  • Repurposing an old Android phone as a low-power always-on OpenClaw host.
  • Running a self-hosted AI agent on a phone without a PC or root access.
  • Testing OpenClaw on ARM hardware without the overhead of a full Linux VM or container.

Quick start

  1. 1

    Install Termux from F-Droid (not the Play Store version)

  2. 2

    Update Termux and install curl

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

    Install OpenClaw with one command

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

    Run the onboarding setup

    openclaw onboard

Things to know

  • Android only, and it requires Termux installed from F-Droid.
  • Needs about 2GB of free storage and takes 3–10 minutes to install.
  • Pinned OpenClaw version is not always the newest release.

Topics

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

FAQ

What is openclaw-android?
Installs and runs the OpenClaw AI agent platform on Android directly in Termux, using only the glibc dynamic linker instead of a full proot Linux distribution. OpenClaw on Android is an installer that runs the OpenClaw AI agent platform on Android phones inside Termux. The usual approach installs a full Debian or Ubuntu environment through proot-distro, which adds well over a gigabyte of overhead. This project instead installs only the glibc dynamic linker through pacman's glibc-runner, along with a linux-arm64 Node.js build wrapped by a loader script, so OpenClaw runs at native speed with roughly 200MB of storage used.
Is openclaw-android free to use? What license does it have?
openclaw-android is open source under the MIT license. Check the license terms before using it in commercial products.
Is openclaw-android still maintained?
Actively maintained. The last commit to openclaw-android was on Oct 14, 2026.
What can I use openclaw-android for?
Repurposing an old Android phone as a low-power always-on OpenClaw host. Running a self-hosted AI agent on a phone without a PC or root access. Testing OpenClaw on ARM hardware without the overhead of a full Linux VM or container.
How do I install openclaw-android?
Install Termux from F-Droid (not the Play Store version) Update Termux and install curl: pkg upgrade -y && pkg install -y curl Install OpenClaw with one command: curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc Run the onboarding setup: openclaw onboard
Where can I get openclaw-android?
The source code and installation instructions are on GitHub: https://github.com/aidanpark/openclaw-android

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects