Files
alfred-mobile/SETUP_BUILD_ENVIRONMENT.md
jknapp 6d4ae2e5c3 Initial commit: Alfred Mobile - AI Assistant Android App
- OAuth authentication via Authentik
- WebSocket connection to OpenClaw gateway
- Configurable gateway URL with first-run setup
- User preferences sync across devices
- Multi-user support with custom assistant names
- ElevenLabs TTS integration (local + remote)
- FCM push notifications for alarms
- Voice input via Google Speech API
- No hardcoded secrets or internal IPs in tracked files
2026-02-09 11:12:51 -08:00

2.6 KiB

Setup Build Environment

The Android app is ready to build! You just need to install Java first.

Install Java 17

Download and install Java 17 JDK for Windows, then WSL can use it:

  1. Download Oracle JDK 17:

  2. Install on Windows

  3. Add to WSL PATH:

# Add to ~/.bashrc
echo 'export JAVA_HOME="/mnt/c/Program Files/Java/jdk-17"' >> ~/.bashrc
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Verify
java -version

Option 2: SDKMAN (Linux-native)

# Install SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Install Java 17
sdk install java 17.0.9-tem

# Verify
java -version

Build the App

Once Java is installed:

cd ~/.openclaw/workspace/alfred-mobile

# First build (downloads Android SDK, takes 5-10 min)
./gradlew assembleDebug

# Output
app/build/outputs/apk/debug/app-debug.apk

Install on Tablet

Method 1: ADB (USB)

# Enable USB debugging on tablet:
# Settings → About → Tap "Build number" 7 times
# Settings → Developer options → USB debugging → ON

# Connect tablet via USB
adb devices

# If device not found:
# - Allow USB debugging on tablet
# - Try different USB cable/port

# Install
adb install app/build/outputs/apk/debug/app-debug.apk

# Or reinstall if already installed
adb install -r app/build/outputs/apk/debug/app-debug.apk

Method 2: Direct Install

  1. Copy APK to tablet:

    # Via ADB
    adb push app/build/outputs/apk/debug/app-debug.apk /sdcard/Download/
    
    # Or use file sharing, email, etc.
    
  2. On tablet:

    • Open Files app → Downloads
    • Tap app-debug.apk
    • Allow "Install from unknown sources" if prompted
    • Tap "Install"

Test OAuth Flow

See BUILD_STATUS.md for testing instructions.


Troubleshooting

"No Java runtime present"

Java not installed or not in PATH. Follow instructions above.

"SDK location not found"

Gradle will auto-download Android SDK on first build. Just wait.

"Build failed"

# Clean and rebuild
./gradlew clean assembleDebug

# Check logs
./gradlew assembleDebug --stacktrace

"Could not HEAD 'https://dl.google.com/...'"

Network issue. Check internet connection and retry.


Once Java is installed, run:

cd ~/.openclaw/workspace/alfred-mobile
./gradlew assembleDebug

Then install on your tablet and test! 🚀