openclaw-android  by Mohd-Mursaleen

AI agent gateway for native Android execution

Created 1 month ago
253 stars

Top 99.4% on SourcePulse

GitHubView on GitHub
Project Summary

This repository provides a method for running the OpenClaw AI agent gateway natively on Android via Termux, bypassing the common, slower approach of using a proot-based Ubuntu environment. It targets developers and power users seeking efficient, low-resource AI agent deployment on mobile devices, offering significantly faster boot times, reduced RAM usage, and simplified setup compared to traditional methods.

How It Works

The core innovation lies in running OpenClaw directly within Termux's native environment, eliminating the overhead of a virtualized Linux distribution. This is achieved through a small Node.js patch that resolves Android's Bionic libc incompatibilities, allowing OpenClaw to function seamlessly without root or containerization. This native approach yields substantial performance gains and a more streamlined user experience.

Quick Start & Requirements

  • Primary Install: Requires Termux (installable via F-Droid) and the specific Node.js patch detailed in SETUP.md. ADB is needed for Android automation features.
  • Prerequisites: Android device, Termux, Node.js patch, ADB.
  • Documentation: Comprehensive guides are available for setup (SETUP.md), ADB bridging (ADB-BRIDGE.md), local LLM integration (LOCAL-LLM.md), and use cases (USE-CASES.md).

Highlighted Details

  • Native Termux Execution: Achieves fast, snappy performance by avoiding proot and Ubuntu layers.
  • Android Automation: Integrates with the Android OS via ADB using a dedicated skill (android-automation-agent) for natural language app control.
  • On-Device LLM: Supports running models like Gemma 4 using LiteRT-LM (GPU + CPU) for offline LLM capabilities, offering a viable alternative to slow CPU-only solutions.

Maintenance & Community

This project is documented and maintained by @Mohd-Mursaleen. No specific community channels (like Discord/Slack) or sponsorship details are provided in the README.

Licensing & Compatibility

The license type is not explicitly stated in the provided README content. Compatibility is focused on Android devices running Termux.

Limitations & Caveats

This method is presented as an unofficial approach not covered by official documentation. Running complex LLMs on mobile hardware remains resource-intensive, and while this setup improves performance over CPU-only alternatives, it relies on specific hardware capabilities and the LiteRT-LM framework due to the limitations of other frameworks like llama.cpp on this platform.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
19 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.