🤖 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 • 🦙 Local LLM • 📖 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)	One-command install (2 mins)
Limited AI tools	4+ AI CLIs pre-configured
No remote access	SSH server included
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.

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

Step 3: Initial Setup 🔧

Open Termux and run:

pkg update -y && pkg install -y curl

Step 4: Install OCA 🚀

curl -sL https://raw.githubusercontent.com/PsProsen-Dev/OpenClaw-On-Android/master/bootstrap.sh | bash && source ~/.bashrc

Takes 3-10 minutes depending on network and device.

Step 5: Start OpenClaw Setup

openclaw onboard

Follow the on-screen instructions.

Step 6: 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.0
No Proot overhead	Official linux-arm64 binaries
100% ARM64 optimized	Bypasses Android linker restrictions

🤖 AI CLI Tools	🦙 Local LLM
Qwen Code, Claude Code, Gemini, Codex	node-llama-cpp + Ollama support
Zero-config setup	Run models locally (experimental)
Cloud API routing	☁️ NEW: Ollama Cloud Models

🌐 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	🔧 Unified CLI
One-command updates via `oca --update`	`oa` command for all operations
Automatic security patches	Update, status, install, uninstall
Rolling release model	Platform-aware architecture

🔧 CLI Reference

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

Command	Description
`oa --update`	Update OpenClaw and Android patches
`oa --install`	Install optional tools (tmux, code-server, AI CLIs)
`oa --uninstall`	Remove OpenClaw on Android
`oa --status`	Show installation status
`oa --version`	Show version
`oa --help`	Show available options

Update example:

oa --update && source ~/.bashrc

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

🦙 Local LLM

Run AI models directly on your phone!

☁️ NEW: Ollama Cloud Models - No local resources needed!

OCA now supports local LLM inference via node-llama-cpp and Ollama (including cloud models!).

☁️ Ollama Cloud Models (Recommended)

Run powerful models in the cloud — zero local RAM/storage usage!

# Pull and launch with cloud model
ollama pull kimi-k2.5:cloud
ollama launch openclaw --model kimi-k2.5:cloud

Recommended Cloud Models:

kimi-k2.5:cloud - Multimodal reasoning (64k context)
minimax-m2.5:cloud - Fast coding (64k context)
glm-5:cloud - Reasoning & code generation
gpt-oss:120b-cloud - High-performance (128k context)

🏠 Local Models (Experimental)

⚠️ Important Constraints (click to expand)

Constraint	Requirement	Reality Check
RAM	2-4GB free	Phone RAM is shared with Android
Storage	4-70GB+	Model files are large
Speed	CPU-only	No GPU offloading on Android
Use Case	Testing/Experimentation	Cloud APIs for production

Quick Start

# Option 1: node-llama-cpp (Recommended)
npm install -g node-llama-cpp --ignore-scripts

# Option 2: Ollama (Full Server)
curl -fsSL https://ollama.com/install.sh | sh

Model Recommendations

Model	Size	RAM Needed	Speed	Best For
TinyLlama 1.1B	~670MB	2GB	⚡⚡⚡	Testing
Phi-3 Mini	~2.3GB	4GB	⚡⚡	Light tasks
Llama 3.2 1B	~670MB	2GB	⚡⚡⚡	Mobile-friendly
Mistral 7B	~4.1GB	8GB	⚡	Advanced only

📖 Read Full Local LLM Guide for detailed setup, troubleshooting, and cloud comparison.

🏗 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

Pacman glibc-runner: Injects ld-linux-aarch64.so.1 to bypass Android's restricted linker
Path Rewriting: UNIX paths (/tmp, /bin/sh) dynamically mapped to Termux prefixes
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
🦙 Local LLM	Run models locally (node-llama-cpp, Ollama)
🌐 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)

L1/L2/L3 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/)                                   │
│ ── L1: install-infra-deps.sh (always)                       │
│ ── L2: install-glibc.sh, install-nodejs.sh (conditional)    │
│ ── L3: 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
L1	Infrastructure (always)	git, pkg update	Orchestrator
L2	Platform runtime (conditional)	glibc, Node.js, build tools	config.env flags
L3	Optional tools (user-selected)	tmux, code-server, AI CLIs	User prompts

Installed Components

Core Infrastructure (L1): git

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

OpenClaw Platform: OpenClaw, clawdhub, PyYAML, libvips

Optional Tools (L3): tmux, ttyd, dufs, android-tools, code-server, OpenCode, Claude Code, Gemini CLI, Codex CLI

🎯 What's New in v10.03.2026

Feature	Description
node-llama-cpp	Prebuilt binary support with `--ignore-scripts`
Ollama Integration	Full server with model management
Model Guide	Recommendations for RAM/Storage constraints
Cloud vs Local	Comparison table for decision making

📦 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⚡) / OpenClaw Authored Architecture

🚀 Ready to transform your Android phone?

curl -sL https://raw.githubusercontent.com/PsProsen-Dev/OpenClaw-On-Android/master/bootstrap.sh | bash

Your phone is now an AI server. ⚡

Name		Name	Last commit message	Last commit date
Latest commit History 42 Commits
RELEASES		RELEASES
docs		docs
patches		patches
platforms/openclaw		platforms/openclaw
reference		reference
scripts		scripts
tests		tests
.gitignore		.gitignore
COMMIT_MSG.txt		COMMIT_MSG.txt
COMMIT_MSG2.txt		COMMIT_MSG2.txt
COMMIT_MSG3.txt		COMMIT_MSG3.txt
COMPARISON.md		COMPARISON.md
LICENSE		LICENSE
README.md		README.md
bootstrap.sh		bootstrap.sh
create-release.bat		create-release.bat
install.sh		install.sh
mint.json		mint.json
oca.sh		oca.sh
uninstall.sh		uninstall.sh
update-core.sh		update-core.sh
update.sh		update.sh

Folders and files

Latest commit

History

Repository files navigation

🤖 OpenClaw on Android (OCA)

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

🌟 The Vision

🚀 Quick Start

Deploying OCA takes under 5 minutes

Step 1: Prepare Your Phone ⚙️

Step 2: Install Termux 📱

Step 3: Initial Setup 🔧

Step 4: Install OCA 🚀

Step 5: Start OpenClaw Setup

Step 6: Start Gateway

⚡ Features

🔧 CLI Reference

🦙 Local LLM

Run AI models directly on your phone!

☁️ Ollama Cloud Models (Recommended)

🏠 Local Models (Experimental)

Quick Start

Model Recommendations

🏗 Project Architecture

How OCA Works

Technical Highlights

📖 Documentation

Everything you need to run OCA like a pro

🛑 Important: Android 12+ Users

📱 Phone Preparation

Essential for 24/7 Operation

🌐 Dashboard & Remote Access

SSH Setup

Dashboard Connect (Multi-Device)

🏗 Platform Architecture (Developer Info)

L1/L2/L3 Dependency Layers

Installed Components

🎯 What's New in v10.03.2026

🤝 Community

🙏 Credits & License

🚀 Ready to transform your Android phone?

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages