OpenClaw

Run OpenClaw AI Gateway on Android — standalone Flutter app with built-in terminal, web dashboard, optional dev tools, and one-tap setup. Also available as a Termux CLI package.

Screenshots

Dashboard	Setup Wizard	Onboarding
Web Dashboard	Logs	Settings

What is OpenClaw?

OpenClaw brings the OpenClaw AI gateway to Android. It sets up a full Ubuntu environment via proot, installs Node.js and OpenClaw, and provides a native Flutter UI to manage everything — no root required.

Two Ways to Use

	Flutter App (Standalone)	Termux CLI
Install	Build APK or download release	`npm install -g openclaw-termux`
Setup	Tap "Begin Setup"	`openclawx setup`
Gateway	Tap "Start Gateway"	`openclawx start`
Terminal	Built-in terminal emulator	Termux shell
Dashboard	Built-in WebView	Browser at `localhost:18789`

Features

Flutter App

One-Tap Setup — Downloads Ubuntu rootfs, Node.js 22, and OpenClaw automatically
Built-in Terminal — Full terminal emulator with extra keys toolbar, copy/paste, clickable URLs
Gateway Controls — Start/stop gateway with status indicator and health checks
Node Device Capabilities — 9 capabilities (21 commands) exposed to AI via WebSocket node protocol
Token URL Display — Captures auth token from onboarding, shows it with a copy button
Web Dashboard — Embedded WebView loads the dashboard with authentication token
View Logs — Real-time gateway log viewer with search/filter
Onboarding — Configure API keys and binding directly in-app
Optional Packages — Install Go (Golang) and Homebrew as optional dev tools from the setup wizard or dashboard
Settings — Auto-start, battery optimization, system info, package status, re-run setup
Foreground Service — Keeps the gateway alive in the background with uptime tracking
Setup Notifications — Progress bar notifications during environment setup

Optional Packages

After the initial setup completes, you can optionally install development tools directly from the app:

Package	Install Method	Size
Go (Golang)	`apt install golang`	~150 MB
Homebrew	Official installer (with root workaround)	~500 MB

These are accessible from:

Setup Wizard — Package cards appear after setup completes
Dashboard — "Packages" card in Quick Actions
Settings — Shows installation status under System Info

Node Device Capabilities

The Flutter app connects to the gateway as a node, exposing Android hardware to the AI. Permissions are requested proactively when the node is enabled.

Capability	Commands	Permission
Camera	`camera.snap`, `camera.clip`, `camera.list`	Camera
Canvas	`canvas.navigate`, `canvas.eval`, `canvas.snapshot`	None (not implemented)
Flash	`flash.on`, `flash.off`, `flash.toggle`, `flash.status`	Camera (torch)
Location	`location.get`	Location
Screen	`screen.record`	MediaProjection consent
Sensor	`sensor.read`, `sensor.list`	Body Sensors
Haptic	`haptic.vibrate`	None
Serial	`serial.scan`, `serial.connect`, `serial.write`, `serial.read`, `serial.disconnect`, `serial.list`	Bluetooth (BT only)

The gateway's openclaw.json is automatically patched before startup to clear denyCommands and set allowCommands for all registered commands.

Serial Capability

The serial capability enables AI agents to communicate with physical hardware over Bluetooth Classic (RFCOMM/SPP) and USB serial (CDC-ACM, FTDI, CH340, CP210x) — perfect for controlling Arduino, Micro:bit, HC-05, and similar devices.

Supported transports:

Transport	Package	Supported Chips
USB Serial	`flutter_serial_communication`	CDC-ACM, FTDI, CH340, CP210x
Bluetooth Classic	`flutter_bluetooth_classic_serial`	Any SPP/RFCOMM device

Usage flow:

serial.scan transport:"usb"                          # Discover USB devices
serial.connect transport:"usb" deviceId:3 baudRate:9600   # Connect
serial.write connectionId:"usb_3" data:"Hello\n"    # Send data
serial.read connectionId:"usb_3" timeoutMs:2000      # Read response
serial.disconnect connectionId:"all"                 # Clean up

Notes:

USB devices are detected automatically via USB OTG — no permissions required
Bluetooth devices must be paired via Android Settings first, then serial.scan transport:"bluetooth" lists them
One active connection per transport (USB and BT can be connected simultaneously)
Incoming data is buffered (64KB per connection) and read on demand with optional delimiter matching

Termux CLI

One-Command Setup — Installs proot-distro, Ubuntu, Node.js 22, and OpenClaw
Bionic Bypass — Fixes os.networkInterfaces() crash on Android's Bionic libc
Smart Loading — Shows spinner until the gateway is ready
Pass-through Commands — Run any OpenClaw command via openclawx

Quick Start

Flutter App (Recommended)

Download the latest APK from Releases
Install the APK on your Android device
Open the app and tap Begin Setup
After setup completes, optionally install Go or Homebrew from the package cards
Configure your API keys in Onboarding
Tap Start Gateway on the dashboard

Or build from source:

git clone https://github.com/mithun50/openclaw-termux.git
cd openclaw-termux/flutter_app
flutter build apk --release

Termux CLI

One-liner (recommended)

curl -fsSL https://raw.githubusercontent.com/mithun50/openclaw-termux/main/install.sh | bash

Or via npm

npm install -g openclaw-termux
openclawx setup

Requirements

Requirement	Details
Android	10 or higher (API 29)
Storage	~500MB for Ubuntu + Node.js + OpenClaw
Architectures	arm64-v8a, armeabi-v7a, x86_64
Termux (CLI only)	From F-Droid (NOT Play Store)

CLI Usage

# First-time setup (installs proot + Ubuntu + Node.js + OpenClaw)
openclawx setup

# Check installation status
openclawx status

# Start OpenClaw gateway
openclawx start

# Run onboarding to configure API keys
openclawx onboarding

# Enter Ubuntu shell
openclawx shell

# Any OpenClaw command works directly
openclawx doctor
openclawx gateway --verbose

Architecture

┌───────────────────────────────────────────────────┐
│                Flutter App (Dart)                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────────┐       │
│  │ Terminal  │ │ Gateway  │ │ Web Dashboard│       │
│  │ Emulator  │ │ Controls │ │   (WebView)  │       │
│  └─────┬────┘ └─────┬────┘ └──────┬───────┘       │
│        │            │             │                │
│  ┌─────┴────────────┴─────────────┴─────────────┐  │
│  │           Native Bridge (Kotlin)             │  │
│  └─────────────────┬────────────────────────────┘  │
│                    │                               │
│  ┌─────────────────┴────────────────────────────┐  │
│  │         Node Provider (WebSocket)            │  │
│  │  Camera · Flash · Location · Screen          │  │
│  │  Sensor · Haptic · Canvas · Serial           │  │
│  └─────────────────┬────────────────────────────┘  │
└────────────────────┼──────────────────────────────┘
                     │
┌────────────────────┼──────────────────────────────┐
│  proot-distro      │              Ubuntu          │
│  ┌─────────────────┴──────────────────────────┐   │
│  │   Node.js 22 + Bionic Bypass               │   │
│  │   ┌─────────────────────────────────────┐  │   │
│  │   │  OpenClaw AI Gateway                │  │   │
│  │   │  http://localhost:18789             │  │   │
│  │   │  ← Node WS: 21 device commands     │  │   │
│  │   └─────────────────────────────────────┘  │   │
│  │   Optional: Go, Homebrew                  │   │
│  └────────────────────────────────────────────┘   │
└───────────────────────────────────────────────────┘

Flutter App Structure

flutter_app/lib/
├── main.dart                  # App entry point
├── constants.dart             # App constants, URLs, author info
├── models/
│   ├── gateway_state.dart     # Gateway status, logs, token URL
│   ├── node_state.dart        # Node connection status
│   ├── node_frame.dart        # WebSocket frame model (req/res/event)
│   ├── setup_state.dart       # Setup wizard progress
│   └── optional_package.dart  # Optional package metadata (Go, Homebrew)
├── providers/
│   ├── gateway_provider.dart  # Gateway state management
│   ├── node_provider.dart     # Node capabilities + permission management
│   └── setup_provider.dart    # Setup state management
├── screens/
│   ├── splash_screen.dart     # Launch screen with routing
│   ├── setup_wizard_screen.dart    # First-time setup + optional packages
│   ├── onboarding_screen.dart      # API key configuration terminal
│   ├── dashboard_screen.dart       # Main dashboard with quick actions
│   ├── terminal_screen.dart        # Full terminal emulator
│   ├── web_dashboard_screen.dart   # WebView for OpenClaw dashboard
│   ├── packages_screen.dart        # Optional package manager
│   ├── package_install_screen.dart # Terminal-based package installer
│   ├── logs_screen.dart            # Gateway log viewer
│   └── settings_screen.dart        # App settings and about
├── services/
│   ├── native_bridge.dart     # Kotlin platform channel bridge
│   ├── gateway_service.dart   # Gateway lifecycle, health checks, config patching
│   ├── node_service.dart      # Node WebSocket connection + invoke handling
│   ├── node_ws_service.dart   # Raw WebSocket transport
│   ├── node_identity_service.dart # Device identity + crypto signing
│   ├── terminal_service.dart  # proot shell configuration
│   ├── bootstrap_service.dart # Environment setup orchestration
│   ├── package_service.dart   # Optional package status checking
│   ├── preferences_service.dart # Persistent settings (token URL, etc.)
│   └── capabilities/
│       ├── capability_handler.dart   # Base class with permission handling
│       ├── camera_capability.dart    # Photo/video capture
│       ├── canvas_capability.dart    # WebView stub (NOT_IMPLEMENTED)
│       ├── flash_capability.dart     # Torch on/off/toggle
│       ├── location_capability.dart  # GPS with timeout + fallback
│       ├── screen_capability.dart    # Screen recording via MediaProjection
│       ├── sensor_capability.dart    # Accelerometer, gyroscope, etc.
│       ├── serial_capability.dart   # Bluetooth Classic + USB serial
│       └── vibration_capability.dart # Haptic feedback
└── widgets/
    ├── gateway_controls.dart  # Start/stop, URL display, copy button
    ├── node_controls.dart     # Node enable/disable, status badge
    ├── terminal_toolbar.dart  # Extra keys (Tab, Ctrl, Esc, arrows)
    ├── status_card.dart       # Reusable status card
    └── progress_step.dart     # Setup wizard step indicator

Configuration

Onboarding

When running onboarding (in-app or via openclawx onboarding):

Binding: Select Loopback (127.0.0.1) for non-rooted devices
API Keys: Add your Gemini/OpenAI/Claude keys
Token URL: The app automatically captures and stores the auth token URL (e.g. http://localhost:18789/#token=...)

Battery Optimization

Important: Disable battery optimization for the app to keep the gateway alive in the background.

For the Flutter app: Settings > Battery Optimization > tap to disable

For Termux: Android Settings > Apps > Termux > Battery > Unrestricted

Dashboard

Access the web dashboard at the token URL shown in the app (e.g. http://localhost:18789/#token=...).

The Flutter app automatically loads the dashboard with your auth token via the built-in WebView.

Command	Description
`/status`	Check gateway status
`/think high`	Enable high-quality thinking
`/reset`	Reset session

Troubleshooting

Gateway won't start

# Check status
openclawx status

# Re-run setup if needed
openclawx setup

# Make sure onboarding is complete
openclawx onboarding

"os.networkInterfaces" error

Bionic Bypass not configured. Run setup again:

openclawx setup

Process killed in background

Disable battery optimization for the app in Android settings.

Permission denied

termux-setup-storage

Manual Setup

Click to expand manual installation steps

1. Install proot-distro and Ubuntu

pkg update && pkg install -y proot-distro
proot-distro install ubuntu

2. Setup Node.js in Ubuntu

proot-distro login ubuntu
apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
npm install -g openclaw

3. Create Bionic Bypass

mkdir -p ~/.openclaw
cat > ~/.openclaw/bionic-bypass.js << 'EOF'
const os = require('os');
const originalNetworkInterfaces = os.networkInterfaces;
os.networkInterfaces = function() {
  try {
    const interfaces = originalNetworkInterfaces.call(os);
    if (interfaces && Object.keys(interfaces).length > 0) {
      return interfaces;
    }
  } catch (e) {}
  return {
    lo: [{
      address: '127.0.0.1',
      netmask: '255.0.0.0',
      family: 'IPv4',
      mac: '00:00:00:00:00:00',
      internal: true,
      cidr: '127.0.0.1/8'
    }]
  };
};
EOF

4. Add to bashrc

echo 'export NODE_OPTIONS="--require ~/.openclaw/bionic-bypass.js"' >> ~/.bashrc
source ~/.bashrc

5. Run OpenClaw

openclaw onboarding  # Select "Loopback (127.0.0.1)"
openclaw gateway --verbose

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Author

Mithun Gowda B | NextGenX

GitHub: @mithun50
Email: mithungowda.b7411@gmail.com
Instagram: @nexgenxplorer_nxg
YouTube: @nexgenxplorer
Play Store: NextGenX Apps
Contact: nxgextra@gmail.com

License

MIT License - see LICENSE file for details.

Made with ❤️ for the Android community by Mithun Gowda B | NextGenX

Uh oh!

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

OpenClaw

Screenshots

What is OpenClaw?

Two Ways to Use

Features

Flutter App

Optional Packages

Node Device Capabilities

Serial Capability

Termux CLI

Quick Start

Flutter App (Recommended)

Termux CLI

One-liner (recommended)

Or via npm

Requirements

CLI Usage

Architecture

Flutter App Structure

Configuration

Onboarding

Battery Optimization

Dashboard

Troubleshooting

Gateway won't start

"os.networkInterfaces" error

Process killed in background

Permission denied

Manual Setup

1. Install proot-distro and Ubuntu

2. Setup Node.js in Ubuntu

3. Create Bionic Bypass

4. Add to bashrc

5. Run OpenClaw

Contributing

Author

License