ClawPhone enables running advanced AI agents like OpenClaw, Claude Code, and Codex on low-cost Android smartphones. It transforms inexpensive devices into isolated, mobile sandboxes for AI experimentation, allowing Discord interaction and leveraging phone hardware. This project offers a highly accessible, portable, and cost-effective entry point for AI agent functionalities.

How It Works

This project utilizes Termux on Android (8+) to host AI agents, installing tmux, nodejs-lts, python, Termux:API, and Termux:GUI. OpenClaw is installed via npm. A key challenge addressed is Termux's limited /tmp access, resolved by exporting TMPDIR, TMP, TEMP to $PREFIX/tmp and configuring OpenClaw's log path. The OpenClaw Gateway runs within tmux, bound to 0.0.0.0 (lan) for network access, and can use a termux-gui overlay daemon for visual output.

Quick Start & Requirements

• Primary Install: npm install -g openclaw@latest
• Prerequisites: Android 8+, Termux, Termux:API, Termux:GUI, tmux, nvim, nodejs-lts, python (via pkg). Grant Termux apps full permissions.
• Setup: llama.cpp compilation takes 15-30 mins on Termux. Initial npm installs may require manual pkg dependency resolution.
• Links: No official quick-start, docs, or demo links provided.

Highlighted Details

• Runs sophisticated AI agents on budget Android devices ($25-$30).
• Facilitates Discord interaction with agents.
• Grants agents control over smartphone hardware via Termux:API.
• Supports visual output via Termux:GUI and an overlay daemon.
• Provides workarounds for Termux's /tmp limitations.
• Gateway binds to lan (0.0.0.0) for network access.

Maintenance & Community

No information regarding maintainers, community channels, or project roadmap is present in the provided README.

Licensing & Compatibility

The README does not specify a software license. This absence may pose compatibility concerns for commercial use or integration into closed-source projects.

Limitations & Caveats

Setup requires specific environment variable (TMPDIR) and log path adjustments for Termux filesystem limitations. Expect lengthy llama.cpp compilation (15-30 mins) and potential initial installation failures needing manual dependency management. Expected "no systemd" errors are noted, and running the gateway in a Termux service is a future TODO.