OpenClaw on Android – Quick Overview

What it is – A thin installer that lets you run the OpenClaw AI‑agent platform on an Android phone without a full Linux distribution. It ships a glibc dynamic linker, a glibc‑built Node.js binary, and a set of scripts that translate standard Linux paths to Termux’s filesystem, so the regular OpenClaw binaries work natively.

---

Why it matters

Traditional way (proot‑distro)	This project
Installs a whole Debian/Ubuntu rootfs (≈1‑2 GB)	Installs only ld.so (≈200 MB)
20‑30 min setup, extra proot layer → slower	3‑10 min one‑command install, native speed
Requires managing a Linux environment inside Termux	Works directly in Termux (or via the optional Claw app)

The result is a much smaller footprint, faster execution, and a simpler user experience for anyone who wants to run OpenClaw agents on a phone.

---

Main components

Component	What it does
glibc ld.so	Provides the GNU C library loader so standard Linux binaries run on Android’s Bionic/Termux environment.
Node.js (arm64, glibc)	Runs the OpenClaw JavaScript runtime; wrapped with a tiny loader script, no need for patchelf.
oa CLI	Helper command for install, update, backup, restore, and tool management (oa --install, oa --update, oa --backup, …).
Claw Android app (optional)	Bundles a terminal emulator + WebView UI; one‑tap bootstrap, dashboard, and tool installer – works completely independent of Termux.
Additional tools	tmux, ttyd, dufs, Android‑specific utilities, Playwright, Claude‑Code, Gemini‑CLI, Codex‑CLI (installed via oa --install).

---

Installation steps (Termux)

1. Install Termux from F‑Droid (Play Store version is dead).
2. Upgrade & install curl:

   pkg upgrade -y && pkg install -y curl
   

3. Run the one‑liner installer:

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

   Installs the glibc loader, Node.js, and OpenClaw in ~200 MB.
4. Finish OpenClaw onboarding:

   openclaw onboard
   

5. Start the gateway (the long‑running process that serves the web dashboard):

   openclaw gateway
   

   Run this in a separate Termux tab; press Ctrl+C to stop.

---

Using the optional Claw app

• Download the APK from the Releases page.
• The app boots a terminal, runs the same installer, and then provides a graphical dashboard (http://127.0.0.1:18789) and a Settings → Install & Update screen that calls oa --update under the hood.
• It can install extra tools, manage backups, and show runtime info without touching any existing Termux installation.

---

Managing your installation (the oa command)

Command	Purpose
oa --update	Pulls the pinned OpenClaw, Node.js, and optional tools; creates a pre‑update backup; validates free space.
oa --install	Installs optional extras (tmux, code‑server, AI CLIs, etc.).
oa --uninstall	Removes OpenClaw and the glibc loader from the device.
oa --backup / oa --restore	Tar‑archives ~/.openclaw (including SQLite DBs) with safety checks; restores data only, not the binaries.
oa --status	Shows which components are present and whether the hard‑link patch is active.

All commands are safe to re‑run; they lock to avoid concurrent updates.

---

Data safety & backups

• Backups are stored in ~/.openclaw-android/backup/ and are private (chmod 600). They contain API keys and conversation history – never share them.
• Before any version change, the installer creates an automatic pre‑update backup (keeps the latest three).
• Restores rewrite any stale absolute paths that may remain after moving data between the Termux install and the Claw app.

---

Performance & limitations

• Commands can feel slower than on a desktop because they read many files on the phone’s storage.
• The gateway must run directly in Termux, not over SSH; otherwise it will stop when the SSH session ends.
• Some heavy tools (code‑server, Chromium) cannot be installed from the app yet, but can be added manually via the terminal.

---

Who should use this?

• AI‑agent developers who want to experiment with OpenClaw on a mobile device.
• Power users who need a portable, low‑overhead OpenClaw node for testing or on‑the‑go debugging.
• Anyone who wants a single‑command, no‑Linux‑distro setup on Android.

---

Quick reference cheat‑sheet

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

# Onboard the first time
openclaw onboard

# Run the gateway (keep it alive in a tab)
openclaw gateway

# Update everything
oa --update && source ~/.bashrc

# Install extra tools (tmux, AI CLIs, etc.)
oa --install

# Backup data
oa --backup

# Restore a backup
oa --restore

---

Bottom line: OpenClaw on Android removes the heavyweight proot‑distro requirement, giving you a lightweight (~200 MB) native installation that lets the full OpenClaw agent ecosystem run directly on your phone, with optional GUI support via the Claw app.