mirror of https://github.com/Heretek-AI/openclaw-android-assistant.git synced 2026-07-21 01:25:26 -04:00

Files

T

Igor c138df5e26 Rename Codex App to AnyClaw, redesign GitHub Pages website

- Rename app display name, notification, theme, release artifacts
- Update CLI output, login page, page titles to AnyClaw
- Redesign docs/index.html with dark industrial-organic theme
- APK artifact renamed from codexapp.apk to anyclaw.apk

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-23 12:46:42 +07:00

3.3 KiB

Raw Permalink Blame History

AnyClaw (Android)

Android APK that embeds a Termux-style Linux bootstrap environment, installs OpenClaw + Codex on first run, and presents the AnyClaw UI inside a WebView.

Architecture

┌─────────────────────────────────────────┐
│              Android APK                │
│                                         │
│  ┌──────────────┐  ┌────────────────┐   │
│  │   WebView    │  │  Bootstrap     │   │
│  │              │  │  Installer     │   │
│  │ localhost:   │  │                │   │
│  │   18923      │  │  Extracts      │   │
│  │              │  │  Termux env    │   │
│  └──────┬───────┘  └───────┬────────┘   │
│         │                  │            │
│         ▼                  ▼            │
│  ┌──────────────────────────────────┐   │
│  │    /data/data/com.codex.mobile/  │   │
│  │    files/usr/  (Termux prefix)   │   │
│  │                                  │   │
│  │    ├── bin/node                   │   │
│  │    ├── bin/codex                  │   │
│  │    └── lib/node_modules/         │   │
│  │        └── codex-web-local/      │   │
│  │            ├── dist/      (Vue)  │   │
│  │            └── dist-cli/  (srv)  │   │
│  └──────────────────────────────────┘   │
└─────────────────────────────────────────┘

Prerequisites

Android Studio (or just the Android SDK command-line tools)
Java 17+
curl (for downloading bootstrap)

Build Instructions

1. Download the Termux bootstrap

cd android
./scripts/download-bootstrap.sh

This downloads bootstrap-aarch64.zip (~30 MB) from Termux releases into app/src/main/assets/.

2. (Optional) Bundle the server

If you want to pre-bundle the codex-web-local server in the APK so users don't need to npm install it on first run:

./scripts/build-server-bundle.sh

This builds the Vue frontend + Express CLI from the parent project and copies them into app/src/main/assets/server-bundle/.

3. Build the APK

./gradlew assembleDebug

The APK will be at app/build/outputs/apk/debug/app-debug.apk.

For a release build:

./gradlew assembleRelease

First Run

On first launch, the app will:

Extract the bootstrap environment (~30 MB compressed, ~100 MB extracted)
Run apt-get install nodejs-lts (downloads ~30 MB)
Run npm install -g @openai/codex codex-web-local
Prompt for your OpenAI API key (stored encrypted on device)
Start the server and load the WebView

Steps 1-3 only happen once. Subsequent launches skip straight to step 4-5.

Minimum Requirements

Android 7.0 (API 24) or higher
arm64-v8a device (most modern Android phones)
~500 MB free storage for bootstrap + Node.js + Codex
Internet connection (for API calls and first-run package installs)

3.3 KiB Raw Permalink Blame History