🤖 OpenClaw on Android (OCA)

🚀 Turn any Android phone into a 24/7 AI server — one command, zero hassle.

Native performance via Termux & glibc. No Proot. No VM. Pure ARM64 power.

🚀 Quick Start • ⚡ Features • 📖 Docs • 🏗 Architecture • 🤝 Community

---

🌟 The Vision

Your old Android phone is not e-waste. It's a powerful ARM64 server waiting to happen.

OCA seamlessly installs the OpenClaw AI ecosystem directly onto your device via Termux. This completely bypasses sluggish Linux distributions (like Ubuntu on Proot), running natively with full glibc compatibility instead of Android's default Bionic libraries.

Before OCA ❌	After OCA ✅
Slow Proot containers	Native ARM64 execution
Bionic libc limitations	Full glibc compatibility
Manual setup (hours)	Zero-Prompt Auto-Install (2 mins)
Limited AI tools	Optimized Qwen/Gemini Arsenal
Individual tool prompts	Total Autonomous Deployment
Static installation	Auto-updating ecosystem

---

🚀 Quick Start

Deploying OCA takes under 5 minutes

Step 1: Prepare Your Phone ⚙️

Configure Developer Options, Stay Awake, and battery optimization to prevent Android from killing Termux.

👉 Read Phone Setup Guide for step-by-step instructions.

Step 2: Install Termux 📱

⚠️ Important: The Play Store version of Termux is discontinued. You must install from F-Droid.

1. Open browser and go to f-droid.org
2. Search for Termux → Tap Download APK
3. Install and allow "Install from unknown sources"

Step 3: Initial Setup 🔧

Open Termux and run:

pkg update -y && pkg upgrade -y
pkg install -y curl openssl libngtcp2 ca-certificates

If Termux prints an error like CANNOT LINK EXECUTABLE "curl" or mentions SSL_set_quic_tls_transport_params, your Termux SSL/HTTP packages are out of sync. Re-run the two commands above, then start a fresh Termux session or run hash -r before installing OCA.

Step 4: Install OCA 🚀

BOOTSTRAP="${TMPDIR:-/tmp}/oca-bootstrap.sh"
curl -fsSL https://raw.githubusercontent.com/PsProsen-Dev/OpenClaw-On-Android/master/bootstrap.sh -o "$BOOTSTRAP" \
  && bash "$BOOTSTRAP" \
  && [ -f "$HOME/.bashrc" ] && source "$HOME/.bashrc"

This downloads the bootstrap script first instead of piping directly into bash, so a broken curl cannot accidentally run an empty installer and then try to source a missing ~/.bashrc.

Takes 3-10 minutes depending on network and device.

Step 5: Automatic glibc extras layer

On the OpenClaw platform, OCA now installs Homebrew (Linuxbrew) and the Go toolchain automatically once the glibc runtime is ready.

Why automatic? glibc-runner provides the glibc dynamic linker that standard Linux binaries need on Android. Since Homebrew and many Go-based helper tools depend on that same Linux-compatible layer, OCA treats them as part of the default glibc stack instead of separate opt-in extras.

After install completes, verify the extra toolchain:

source ~/.bashrc && brew --version && go version

Step 6: Start OpenClaw Setup

openclaw onboard

Follow the on-screen instructions.

Step 7: Start Gateway

openclaw gateway

⚠️ Important: Run directly in Termux app, not via SSH. SSH session disconnect will stop the gateway.

That's it. You now have a full AI server on your phone.

---

⚡ Features

📱 Native Execution	☁️ Full Node.js v24
OpenClaw runs bare-metal in Termux	glibc-patched Node.js v24.14.1
No Proot overhead	Official linux-arm64 binaries
100% ARM64 optimized	Bypasses Android linker restrictions

🤖 AI CLI Tools
Qwen Code, Gemini CLI, OpenCode
Zero-prompt auto-setup
Cloud API routing only

🌐 Remote Access	🛡️ Safe Root
SSH server on port 8022	oca-root wrapper for rooted devices
Remote terminal access	Selective root commands
24/7 headless operation	No system compromise

🔄 Auto-Updates	🔧 Master CLI
One-command updates via oca --update	oca command for all operations
Automatic security patches	Global status, health, & maintenance
Rolling release model	Platform-aware architecture

---

🔧 CLI Reference

After installation, use the oca command for managing your installation:

Command	Description
oca --update	Update OpenClaw and Android patches
oca --status	Show global installation health
oca --clean	Purge caches and binary junk
oca --uninstall	Clean removal of OCA ecosystem
oca --version	Show version info
oca --help	Show Jarvis-grade help

Update example:

oca --update && source ~/.bashrc

This updates: OpenClaw core, code-server, OpenCode, AI CLI tools, Android patches

---

☁️ Cloud LLM Only

⚠️ Local LLM/model inference is NOT supported on mobile/Android. Due to RAM, storage, and CPU limitations, only cloud-hosted LLMs (Gemini, GPT-OSS, etc) are available in OCA.

☁️ Cloud Model Usage (Recommended)

Run powerful language models with zero local RAM/storage usage!

# Example cloud model usage
# (Follow CLI tool docs for details — only cloud endpoints are supported)

Recommended Cloud Models:

• Gemini (Google Cloud)
• Qwen (Alibaba Cloud)
• GPT-OSS:120b-cloud (Open OSS; cloud-hosted)

---

🟢 Getting Free AI Models

Want to use powerful LLMs like GPT-4.1, GPT-5 mini, MiniMax, Big Pickle—FREE? OpenCode, GitHub, and Zen offer incredible models at zero cost for development, hobby coding, or tinkering.

🟩 Quick Start: Free Models via GitHub & OpenCode

• GitHub Copilot/Opencode App: Simply open the model picker (/models command or menu) — you’ll see models like:
  • GPT-4.1, GPT-5 mini (both free! green tick)
  • GPT-5.2-Codex, Claude, MiniMax, and more
  • See screenshot →
• Fun fact: Main (Jarvis RTX⚡) bhi GPT-4.1 hoon—vohi model OpenCode free mode me available hai!

🔑 API Key Required

• Free endpoints bhi active OpenCode API key (or provider key) maangte hain.
  • Register at OpenCode Zen for a free key.

🌍 Top Free Hosted Models

Model Name	Platform	Use-case	Cost	Free Limit
GPT-4.1, 5-mini	GitHub/Copilot	Coding/chat/agents	₹0	~200 requests/5hr
MiniMax, Kimi	Zen	Coding/AI agents	₹0	Quota + fair use
Big Pickle	Zen, OpenCode	Reasoning/coding	₹0	Shared pool, capped
GLM-5	Zen/Copilot	Big context/agents	₹0	Shared pool, capped

⚡ Pro-tips

• Most free models rotate! Check Zen dashboard or model picker for live free options.
• Personal/sensitive code: Avoid using free APIs for private IP—data may be logged for model improvements.
• Usage limits: Each provider sets request/token quota and/or rate throttling; expect pauses or slowdowns.
• Upgrade available: If you hit free cap, OpenCode Go plan is cheap and offers full privacy + speed.

⚠️ Caveats

• Data sent to free/experimental models may be retained for quality improvement—use only for safe code/playground!
• Free models change frequently; always check docs/model picker.

For advanced usage, quotas, and API docs:

• OpenCode Zen Documentation
• GitHub, Copilot, Kilo Code, Mistral

---

🏗 Project Architecture

How OCA Works

┌─────────────────────────────────────────────────────────┐
│              Android Device (Termux)                    │
│                         │                               │
│                         ▼                               │
│              ┌──────────────────┐                       │
│              │  glibc-runner    │                       │
│              │  (ld.so wrapper) │                       │
│              └────────┬─────────┘                       │
│                       │                                 │
│                       ▼                                 │
│              ┌──────────────────┐                       │
│              │  Node.js v24     │                       │
│              │  linux-arm64     │                       │
│              └────────┬─────────┘                       │
│                       │                                 │
│         ┌─────────────┴──────────────┐                 │
│         ▼                            ▼                 │
│  ┌──────────────┐           ┌──────────────┐          │
│  │ OpenClaw     │           │  Local LLM   │          │
│  │ Gateway      │           │  (Optional)  │          │
│  │              │           │              │          │
│  │ • AI CLIs    │           │ • llama.cpp  │          │
│  │ • SSH        │           │ • Ollama     │          │
│  │ • clawdhub   │           │ • GGUF       │          │
│  └──────────────┘           └──────────────┘          │
└─────────────────────────────────────────────────────────┘

Technical Highlights

1. Pacman glibc-runner: Injects ld-linux-aarch64.so.1 to bypass Android's restricted linker
2. Path Rewriting: UNIX paths (/tmp, /bin/sh) dynamically mapped to Termux prefixes
3. JS Runtime Shims: glibc-compat.js polyfills os.cpus() and os.networkInterfaces() for V8

---

📖 Documentation

Everything you need to run OCA like a pro

📚 Guide	Description
🚀 Quick Start	Get running in 5 minutes
📱 Phone Setup	Developer Options, Stay Awake, Battery
🔧 Installation	Full 8-step installer breakdown
🤖 AI CLI Tools	Qwen, Claude, Gemini, Codex setup

| 🌐 Dashboard Connect | Multi-device management from PC | | 🔐 SSH Setup | Remote access configuration | | ⚙️ Configuration | Manage settings and preferences | | 🔧 Troubleshooting | Common errors and fixes | | 👻 Phantom Process Killer | Android 12+ fix |

📑 Browse all docs: docs/

---

🛑 Important: Android 12+ Users

If you see [Process completed (signal 9)], Android's Phantom Process Killer has terminated Termux.

Fix it in 30 seconds:

adb shell settings put global development_settings_enabled 1
adb shell settings put global max_phantom_processes 64

📖 Read Full Fix Guide

---

📱 Phone Preparation

Essential for 24/7 Operation

Android may kill background processes or throttle them when the screen is off. For 24/7 operation:

Setting	Purpose	How To
Developer Options	Enable advanced controls	Settings → About → Tap Build Number 7x
Stay Awake	Prevent CPU throttling	Developer Options → Stay Awake
Battery Optimization	Prevent app killing	Settings → Apps → Termux → Battery → Unrestricted
Charge Limit	Protect battery during 24/7 use	Use AccuBattery or similar

📖 Read Complete Phone Setup Guide for detailed instructions.

---

🌐 Dashboard & Remote Access

SSH Setup

Access your OCA dashboard from PC browser via SSH tunnel:

# From your PC terminal
ssh -L 3000:localhost:3000 -L 8080:localhost:8080 u0_aXXX@192.168.X.X -p 8022

📖 Read SSH Setup Guide for complete instructions.

Dashboard Connect (Multi-Device)

Running OCA on multiple devices? Use Dashboard Connect to manage them from your PC:

• Save connection settings (IP, token, ports) for each device with a nickname
• Generates SSH tunnel commands automatically
• Switch between devices with one click
• Your data stays local — Settings saved only in browser localStorage

💡 Tip: Name your devices (e.g., "Old Pixel", "Bedroom Phone") for easy identification.

---

🏗 Platform Architecture (Developer Info)

RTX⚡1/RTX⚡2/RTX⚡3 Dependency Layers

OCA uses a platform-plugin architecture that separates platform-agnostic infrastructure from platform-specific code:

┌─────────────────────────────────────────────────────────────┐
│ Orchestrators (install.sh, update-core.sh, uninstall.sh)    │
│ ── Platform-agnostic. Read config.env and delegate.         │
├─────────────────────────────────────────────────────────────┤
│ Shared Scripts (scripts/)                                   │
│ ── RTX⚡1: install-infra-deps.sh (always)                   │
│ ── RTX⚡2: install-glibc.sh, install-nodejs.sh (conditional)│
│ ── RTX⚡3: Optional tools (user-selected)                   │
├─────────────────────────────────────────────────────────────┤
│ Platform Plugins (platforms/<platform>/)                    │
│ ── config.env: declares dependencies                        │
│ ── install.sh / update.sh / uninstall.sh / ...              │
└─────────────────────────────────────────────────────────────┘

Dependency layers:

Layer	Scope	Examples	Controlled by
RTX⚡1	Infrastructure (always)	git, pkg update	Orchestrator
RTX⚡2	Platform runtime (conditional)	glibc, Node.js, build tools	config.env flags
RTX⚡3	Optional tools (user-selected)	tmux, code-server, AI CLIs	User prompts

Installed Components

Core Infrastructure (RTX⚡1): git

Platform Runtime (RTX⚡2): pacman, glibc-runner, Node.js v24, python, make, cmake, clang, binutils

OpenClaw Platform: OpenClaw, clawdhub, PyYAML, libvips

Optional Tools (RTX⚡3): tmux, ttyd, dufs, android-tools, code-server, OpenCode, Qwen Code CLI, Gemini CLI.

---

🎯 What's New in v01.04.2026

Feature	Description
RTX⚡ Protocol	New tiered 3-tier architecture (Infra, Engine, Arsenal)
Master CLI (oca)	Updated for protocol-aware health & sync
Playwright Arsenal	Native Chromium FHS automation suite
Repo Cleanup	Optimized infrastructure for 0% crash rate

📦 View Release Notes

---

🤝 Community

Join the discussion! Ask questions, share your Android setup, or request features.

💬 GitHub Discussions  •  🐛 Report an Issue

---

🙏 Credits & License

Built with ⚡ by PsProsen-Dev

Using Jarvis (RTX⚡)

---

🚀 Ready to transform your Android phone?

BOOTSTRAP="${TMPDIR:-/tmp}/oca-bootstrap.sh"
curl -fsSL https://raw.githubusercontent.com/PsProsen-Dev/OpenClaw-On-Android/master/bootstrap.sh -o "$BOOTSTRAP" \
  && bash "$BOOTSTRAP"

Your phone is now an AI server. ⚡