🦞 OpenClaw for Android (Termux)

Automated installer for running OpenClaw AI agent system on Android devices via Termux

---

⚠️ Important Disclaimer

This project is an independent installer/automation tool created for the community.

• What this is: An automated installation script that makes it easy to run OpenClaw on Android
• What this is NOT: I did not create OpenClaw itself
• OpenClaw: Visit the official OpenClaw project for the actual AI agent framework
• Creator: This installer was created by @iyeoh88-svg to simplify the Android installation process
• Purpose: To automate the complex setup process and make OpenClaw accessible on Android devices

All credit for OpenClaw goes to its original creators and maintainers.

Read Full Disclaimer - Please read to understand the scope of this project

---

OpenClaw is a powerful AI agent framework that can now run natively on Android devices. This installer automates the entire setup process, handling environment configuration, dependency installation, and networking fixes specific to Android.

✨ Features

• One-Command Installation - Fully automated setup process
• Auto-Update System - Script checks for updates on every run
• Android Networking Fix - Automatically patches the Error 13 issue
• Optimized for Android 12+ - Tested on modern Android devices
• Minimal Storage Impact - Efficient PRoot Debian environment

📋 Prerequisites

• Android device running Android 12 or higher
• Termux installed from F-Droid (if you encounter issue using Fdroid's version, you may try to use google playstore's version)
• At least 2GB of free storage space
• Stable internet connection

Quick Start

Method 1: One-Line Install (Recommended)

Run this command in Termux:

# Termux main terminal
curl -fsSL https://raw.githubusercontent.com/iyeoh88-svg/openclaw-android/main/install.sh | bash

# First time setup (enter debian)
proot-distro login debian

# Run the openclaw setup wizard (inside debian)
openclaw onboard

If you see this error after the setup wizard, ignore it and proceed to Start Up.It will still work.

"SystemError [ERR_SYSTEM_ERROR]: A system error occurred: uv_interface_addresses returned Unknown system error 13 (Unknown system error 13)"

Method 2: Manual Download

# Download the installer
curl -O https://raw.githubusercontent.com/iyeoh88-svg/openclaw-android/main/install.sh

# Make it executable
chmod +x install.sh

# Run the installer
./install.sh

📖 What Gets Installed

The script automatically:

1. Updates Termux packages
2. Installs and configures PRoot-Distro with Debian
3. Installs Node.js v22 via NVM
4. Creates networking shim to fix Android Error 13
5. Installs OpenClaw globally
6. Sets up convenient aliases for daily use
7. Configures the environment for optimal performance

Start Up

After installation, use these simple commands:

Starting OpenClaw

Session 1 - Gateway (The Brain)

# In Termux
proot-distro login debian

# Inside Debian
start-claw

Session 2 - TUI (The Interface)

# Swipe left in Termux to open new session
proot-distro login debian

# Inside Debian
openclaw tui

Quick Commands

• start-claw - Launch the OpenClaw gateway
• openclaw tui - Open the terminal interface
• openclaw onboard - Configure API keys
• update-openclaw - Update to latest version

Troubleshooting

Performance Issues

If OpenClaw is running slowly:

# In standard Termux (not Debian)
termux-wake-lock

This prevents Android from throttling CPU when the screen is off.

Storage Issues

# Inside Debian
npm cache clean --force
apt clean

API Configuration

# Inside Debian
openclaw onboard

Follow the prompts to configure Gemini, OpenAI, or other providers.

Complete Reinstall

# In standard Termux
./install.sh --reinstall

System Requirements

Component	Requirement
OS	Android 12+
Storage	2GB minimum, 4GB recommended
RAM	4GB minimum, 6GB+ recommended
Termux	Latest version from F-Droid

🔄 Updating

The installer automatically checks for updates each time you run it. To manually update:

# Re-run the installer
curl -fsSL https://raw.githubusercontent.com/iyeoh88-svg/openclaw-android/main/install.sh | bash

Known Issues

• Error 13: Fixed automatically by the installer
• Performance: Use termux-wake-lock for better performance
• Battery: OpenClaw may drain battery faster; keep device charged during intensive tasks

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

OpenClaw Framework:

• All credit for the OpenClaw AI agent system goes to its original creators and maintainers
• Official OpenClaw: openclaw/openclaw (or official repository)
• This installer is a community contribution to make OpenClaw accessible on Android

This Project:

• Created by: @iyeoh88-svg
• Purpose: Automated installation tool for Android/Termux
• Not affiliated with or endorsed by the official OpenClaw team

Community:

• Termux community for making Linux on Android possible
• NVM team for Node.js version management
• All contributors and testers who helped improve this installer

Note: This is an independent community project. For OpenClaw-specific questions, features, or issues, please refer to the official OpenClaw repository.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Made with ❤️ for the Android AI community