内容摘录
OpenClaw
Download APK
Build Flutter APK & AAB
npm version
License: MIT
Node.js
Android
Flutter
PRs Welcome
<p align="center">
<img src="assets/ic_launcher.png" alt="OpenClaw App Mockup" width="700"/>
</p>
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
<table align="center">
<tr>
<td align="center"><img src="assets/dashboard.png" alt="Dashboard" width="220"/><br/><b>Dashboard</b></td>
<td align="center"><img src="assets/setupscreen.png" alt="Setup" width="220"/><br/><b>Setup Wizard</b></td>
<td align="center"><img src="assets/onboardingscreen.png" alt="Onboarding" width="220"/><br/><b>Onboarding</b></td>
</tr>
<tr>
<td align="center"><img src="assets/websscreen.png" alt="Web Dashboard" width="220"/><br/><b>Web Dashboard</b></td>
<td align="center"><img src="assets/logscreen.png" alt="Logs" width="220"/><br/><b>Logs</b></td>
<td align="center"><img src="assets/settingsscreen.png" alt="Settings" width="220"/><br/><b>Settings</b></td>
</tr>
</table>
---
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
**AI Providers** — Configure API keys and select models for 7 providers (Anthropic, OpenAI, Google Gemini, OpenRouter, NVIDIA NIM, DeepSeek, xAI)
**SSH Remote Access** — Start/stop SSH server, set root password, view connection info with copyable commands
**Configure Menu** — Run openclaw configure in a built-in terminal to manage gateway settings
**Node Device Capabilities** — 7 capabilities (15 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), Homebrew, and OpenSSH as optional dev tools
**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 |
| **OpenSSH** | apt install openssh-server | ~10 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 |
The gateway's openclaw.json is automatically patched before startup to clear denyCommands and set allowCommands for all 15 commands.
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
---
Important Warnings
**Storage Permission** — This app does **NOT** need full storage access to function. If prompted, **deny** the storage permission unless you specifically need proot to access /sdcard. Granting MANAGE_EXTERNAL_STORAGE allows the proot environment to read and modify **all files** on your device including photos, downloads, and documents. Previous versions requested this permission automatically on launch, which could lead to unintended data loss (see #67, #63). This has been fixed — storage access is now opt-in from Settings only.
**Battery Optimization** — Disable battery optimization for the app in Android Settings to prevent Android from killing the gateway process in the background. Without this, the gateway may crash silently after a few minutes.
**First Launch** — The initial setup downloads ~500MB (Ubuntu rootfs + Node.js). Ensure you have a stable internet connection and sufficient storage before starting.
---
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 pack…