Clawbot  by AbuZar-Ansarii

Local AI agent framework for Android devices

Created 3 months ago
262 stars

Top 97.0% on SourcePulse

GitHubView on GitHub
Project Summary

This project transforms an Android device into a 24/7 local AI agent, running OpenClaw entirely on-device without requiring a PC or cloud server. It targets users who want to deploy AI agents locally on mobile hardware, offering a web-based dashboard for control and interaction.

How It Works

The setup utilizes Termux on Android to establish an Ubuntu environment via proot-distro. Within this environment, Node.js and OpenClaw are installed. A custom Node.js script (hijack.js) is employed to resolve a network interface issue specific to Android, enabling the OpenClaw gateway to bind locally. Users then run an onboarding wizard and start the gateway, accessing its web dashboard via the device's browser.

Quick Start & Requirements

  • Primary install/run command: Install Termux from F-Droid. Within Termux, install proot-distro, install and log into Ubuntu (proot-distro install ubuntu, proot-distro login ubuntu). Inside Ubuntu, install Node.js (v22.x) and OpenClaw (npm install -g openclaw@latest). Run openclaw onboard for setup and openclaw gateway --verbose to start.
  • Prerequisites: Android phone (10+ recommended), Termux from F-Droid, Gemini API key (from Google AI Studio).
  • Access: Web dashboard at http://127.0.0.1:18789.

Highlighted Details

  • Enables a fully local AI agent on Android devices.
  • Operates 24/7 without external PC or cloud server dependencies.
  • Provides a web-based dashboard for interaction and control.
  • Supports deep reasoning modes and session memory resets via agent commands (/think high, /reset).

Maintenance & Community

No specific details on contributors, sponsorships, community channels, or roadmaps are provided in the README.

Licensing & Compatibility

The README does not specify a license type or compatibility notes for commercial use.

Limitations & Caveats

Requires specific setup steps including installing Termux from F-Droid and configuring Ubuntu within it. For continuous 24/7 operation, the device must remain plugged in, and Android's battery optimization for Termux should be disabled. Security relies on careful handling of API keys and gateway tokens.

Health Check
Last Commit

3 months ago

Responsiveness

Inactive

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

Explore Similar Projects

Feedback? Help us improve.