openclaw-droid 1.0.2 → 1.0.5

package/README.md

@@ -1,77 +1,127 @@
-# OpenClaw Droid 🤖
-> **The Official Android AI Gateway Installer** by [NosytLabs](https://github.com/NosytLabs)
-
-![Version](https://img.shields.io/npm/v/openclaw-droid.svg?style=flat-square)
-![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)
-![Platform](https://img.shields.io/badge/platform-Android%20Termux-green.svg?style=flat-square)
-
-Turn your Android device into a powerful **AI Gateway**. Run [OpenClaw](https://github.com/openclaw/openclaw) natively on your phone with a single command.
-
----
-
-## 🚀 Features
-
-- **One-Click Install**: Automated setup script handles everything.
-- **Proot Container**: Runs a full Ubuntu environment inside Termux.
-- **Bionic Bypass**: Automatically patches Android network restrictions.
-- **Node.js 22**: Installs the latest optimized Node.js runtime.
-- **Battery Optimized**: Configured for long-running background tasks.
-
-## 📦 Installation
-
-**Prerequisites:**
-1. Install [Termux](https://f-droid.org/packages/com.termux/) (F-Droid version only).
-2. Open Termux and paste this command:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/install.sh | bash
-```
-
-That's it! The script will:
-1. Setup the Ubuntu container.
-2. Install Node.js & dependencies.
-3. Patch the network layer.
-4. Launch the OpenClaw configuration wizard.
-
-## 🎮 Usage
-
-Once installed, your device is a fully functioning AI Gateway.
-
-### Start the Gateway
-To start the gateway, simply run:
-
-```bash
-openclaw gateway
-```
-
-### Dashboard Access
-- **Local:** `http://127.0.0.1:18789`
-- **Network:** `http://<PHONE_IP>:18789` (Enable LAN bind in config)
-
-## 🛠 Advanced
-
-### Access the Shell
-To manually enter the Ubuntu environment where OpenClaw lives:
-
-```bash
-proot-distro login ubuntu
-```
-
-### Update
-To update OpenClaw to the latest version:
-
-```bash
-npm install -g openclaw@latest
-```
-
-## ⚠️ Troubleshooting
-
-**"Ubuntu already installed"**
-- The script detects existing installations and will skip re-installing the OS, proceeding directly to configuration.
-
-**Network Errors**
-- Android restricts some low-level network calls. Our `patch.js` fixes this automatically. Ensure you see `Loading network patch...` when starting.
-
-## 📜 License
-
-MIT © [NosytLabs](https://github.com/NosytLabs)
+# OpenClaw Droid
+
+> **The Android AI Gateway Installer** by [NosytLabs](https://github.com/NosytLabs)
+
+Turn your Android device into a 24/7 AI Gateway. Run powerful agents, connect to LLMs (Gemini, Claude, OpenAI), and automate tasks directly from your phone—no root required.
+
+## Features
+
+- **Zero Root Required**: Runs entirely in user-space using Termux and Proot.
+- **24/7 Operation**: optimized for long-running background tasks with wake locks.
+- **Visual Overlay**: Display AI thoughts and status directly on your Android screen (requires Termux:GUI).
+- **Hardware Acceleration**: Auto-compiles llama.cpp for ARM64/mobile performance.
+- **Bionic Bypass**: Automatically fixes Android 10+ "System Error 13" networking restrictions.
+
+## Prerequisites
+
+- **Android Device**: Android 10 or higher.
+- **Termux**: Installed from **F-Droid** (Do not use the Play Store version).
+- **API Key**: Gemini API (free tier available), Anthropic, or OpenAI.
+
+## Installation
+
+### Option 1: Automatic Installation (Recommended)
+
+Run these commands in Termux:
+
+```bash
+# Update packages
+pkg update -y && pkg upgrade -y
+
+# Install Node.js and Git
+pkg install nodejs-lts git -y
+
+# Install OpenClaw Droid
+npm install -g openclaw-droid
+
+# Run the setup wizard
+openclaw setup
+```
+
+### Option 2: Manual Installation
+
+If the automatic installer fails or you prefer full control:
+
+1.  **Prepare Environment**:
+    ```bash
+    termux-setup-storage
+    pkg update -y && pkg upgrade -y
+    pkg install nodejs-lts git proot-distro termux-api -y
+    ```
+
+2.  **Install Ubuntu Environment**:
+    ```bash
+    proot-distro install ubuntu
+    proot-distro login ubuntu
+    ```
+
+3.  **Setup Inside Ubuntu**:
+    ```bash
+    # (Inside Ubuntu prompt)
+    apt update && apt upgrade -y
+    apt install curl git build-essential python3 -y
+    curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+    apt install nodejs -y
+    npm install -g openclaw@latest
+    ```
+
+4.  **Configure Bionic Bypass (Fix Network Errors)**:
+    OpenClaw requires a networking fix for Android.
+    Create `~/.openclaw/bionic-bypass.js` with the content from [this repo](https://github.com/NosytLabs/openclaw-droid/blob/main/lib/bionic-bypass.js) and add to `.bashrc`:
+    ```bash
+    export NODE_OPTIONS="--require /root/.openclaw/bionic-bypass.js"
+    ```
+
+5.  **Launch**:
+    ```bash
+    openclaw start
+    ```
+
+## Usage
+
+- **Start the Gateway**:
+  ```bash
+  openclaw start
+  ```
+- **Run Setup Wizard**:
+  ```bash
+  openclaw setup
+  ```
+- **Test Overlay**:
+  ```bash
+  openclaw overlay "Hello Android!"
+  ```
+
+## Troubleshooting
+
+### Permission Denied (Storage)
+If you see `EACCES` when accessing files:
+1. Run `termux-setup-storage`
+2. Grant "Files and Media" permission in Android Settings > Apps > Termux.
+
+### Process Killed Automatically
+Android aggressively kills background apps.
+1. Run `openclaw setup` and ensure "Wake Lock" is enabled.
+2. Disable "Battery Optimization" for Termux in Android Settings.
+3. Keep the Termux notification active.
+
+### System Error 13 (Permission Denied / Network)
+This is a known Android 10+ kernel restriction on `getifaddrs`.
+**Fix**: Ensure the **Bionic Bypass** is active. The installer sets this up automatically. If you installed manually, see Option 2, Step 4.
+
+### GUI Overlay Not Showing
+1. Install the **Termux:GUI** app from F-Droid.
+2. Install the `termux-gui` package: `pkg install termux-gui`.
+3. Ensure "Draw over other apps" permission is granted to Termux:GUI.
+
+## Useful Resources
+
+- **[OpenClaw](https://github.com/openclaw/openclaw)**: The core AI Gateway repository.
+- **[ClawHub](https://clawhub.ai/)**: Discover, share, and install new skills for your AI agent.
+- **[OpenClaw Skills](https://github.com/openclaw/skills)**: Official library of verified skills.
+- **[CellHasher](https://github.com/cellhasher)**: Essential Termux tools and scripts.
+- **[CrabWalk](https://github.com/crabwalk)**: Mobile-first AI optimizations.
+
+## License
+
+MIT © [NosytLabs](https://github.com/NosytLabs)

package/install.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e
 
-# OpenClaw Droid Installer v1.0.2
+# OpenClaw Droid Installer v1.0.5
 # NosytLabs
 
 RED='\033[0;31m'
@@ -11,9 +11,9 @@ NC='\033[0m'
 
 echo -e "${BLUE}"
 echo "╔═══════════════════════════════════════════╗"
-echo "║           OPENCLAW DROID v1.0.2           ║"
+echo "║           OPENCLAW DROID v1.0.5           ║"
 echo "║         The Android AI Gateway            ║"
-echo "║           Powered by NosytLabs            ║"
+echo "║                                           ║"
 echo "╚═══════════════════════════════════════════╝"
 echo -e "${NC}"
 

package/lib/index.js

@@ -19,7 +19,7 @@ import { fileURLToPath } from 'url';
 import { logger, safeExecSync } from './utils.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const VERSION = '2.0.1';
+const VERSION = '1.0.5';
 
 let activeIntervals = [];
 let activeProcesses = [];

package/lib/installer.js

@@ -389,7 +389,11 @@ EOF
   `;
 
   try {
-    safeExecSync(`proot-distro login ubuntu -- bash -c '${setupScript}'`, { stdio: 'inherit', timeout: 3600000 });
+    safeExecSync(`proot-distro login ubuntu -- bash -c '${setupScript}'`, { 
+      stdio: 'inherit', 
+      timeout: 3600000,
+      disableSanitization: true 
+    });
     return true;
   } catch (err) {
     logger.error('Failed to setup Ubuntu:', err);

package/lib/utils.js

@@ -44,16 +44,22 @@ function sanitizeCommand(cmd) {
 }
 
 function safeExecSync(command, options = {}) {
-  const sanitizedCmd = sanitizeCommand(command);
-  logger.debug(`Executing: ${sanitizedCmd}`);
+  const { disableSanitization, ...execOptions } = options;
+  const cmdToRun = disableSanitization ? command : sanitizeCommand(command);
+  
+  if (disableSanitization) {
+    logger.debug(`Executing (unsafe): ${cmdToRun}`);
+  } else {
+    logger.debug(`Executing: ${cmdToRun}`);
+  }
   
   const defaultOptions = {
     stdio: 'pipe',
     timeout: 30000,
-    ...options
+    ...execOptions
   };
   
-  return execSync(sanitizedCmd, defaultOptions);
+  return execSync(cmdToRun, defaultOptions);
 }
 
 function safeWriteFileSync(filePath, content, encoding = 'utf8') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-droid",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "OpenClaw Droid - Android AI Gateway Installer",
   "main": "lib/index.js",
   "type": "module",