mirror of
https://github.com/Heretek-AI/openclaw-android-assistant.git
synced 2026-07-21 01:25:26 -04:00
John Smith
e477f56f75
The APK build pipeline produces artifacts that should not be committed: - openclaw-android/android/app/build/ (gradle build output) - openclaw-android/android/app/src/main/assets/server-bundle/ (built Vue + CLI bundle) - openclaw-android/android/app/src/main/assets/bootstrap-*.zip (~30MB Termux download) - openclaw-android/android/gradle/wrapper/gradle-wrapper.jar (auto-downloaded) - openclaw-android/dist/ and dist-cli/ (vite/tsup build output) The root .gitignore line 213 silently blocks nested .gitignore files, so additions use 'git add -f' here.
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)