mirror of
https://github.com/Heretek-AI/openclaw-android-assistant.git
synced 2026-07-19 14:13:42 -04:00
John Smith
dbbe2a7957
The script previously ran 'npm install' and 'npm run build:frontend:bundle'
/ 'npm run build:cli' at the project root, but those scripts live in
openclaw-android/package.json (the codex-web-local source). It also tried
to copy from a non-existent <project_root>/dist and /dist-cli.
Now the script:
- cd's into PROJECT_ROOT/openclaw-android/ before installing/building
- guards on missing source dir
- copies from openclaw-android/{dist,dist-cli,package.json}
- uses --no-audit --no-fund and a strict 'cd' instead of the previous
silent-fallback '|| true' on the prod-deps install, so a bundle
failure surfaces rather than producing an APK with missing node_modules.
Verified end-to-end: vite build + tsup + npm install --omit=dev, APK
rebuilds to 41 MB with the new bundle.
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)