openclaw-droid 5.0.0 → 5.2.0

package/README.md

@@ -1,321 +1,73 @@
-# OpenClaw Droid v5.0 - Android AI Gateway Installer
+# OpenClaw Droid v5.1
 
-> **The Ultimate Android AI Gateway Installer** by [NosytLabs](https://github.com/NosytLabs)
+> **The Simplified Installer** based on [Sagar Tamang's Guide](https://sagartamang.com/blog/openclaw-on-android-termux).
 
-Transform your Android device into a powerful 24/7 AI Gateway with OpenClaw and proot-distro Ubuntu. Now with enhanced systemd compatibility and seamless gateway management.
-
-**Keywords**: Android AI Gateway, OpenClaw Android, Termux AI Gateway, proot-distro Ubuntu, Android AI Agent, Mobile AI Gateway, OpenClaw Installer, Android AI Tools, AI Gateway Setup, Termux AI Tools
+This installer automates the exact steps from the "Bionic Bypass" guide to run OpenClaw on Android using Termux and Ubuntu.
 
 ## Features
 
-- **Zero Root Required**: Runs in Termux + proot-distro Ubuntu container
-- **Full Linux Environment**: Complete Ubuntu container with Node.js 22
-- **24/7 Operation**: Optimized for long-running background sessions
-- **Easy Installation**: One-command installer with automatic setup
-- **Bionic Bypass v2**: Enhanced network patch preventing "System Error 13"
-- **Systemd Compatibility**: Enhanced proot-distro compatibility with fake systemctl
-- **Seamless Gateway Management**: Automatic service management without systemd
-- **V5.0 Release**: Major stability update with robust self-healing
-
-## Prerequisites
-
-- **Android**: 10 or newer
-- **Termux**: F-Droid version only (https://f-droid.org/packages/com.termux/)
-- **API Key**: Gemini API key from Google AI Studio
+- **Strict Adherence**: Follows the blog guide exactly (no extra wrappers or complex logic).
+- **Automated Setup**: Installs Node 22, OpenClaw, and the Bionic Bypass automatically.
+- **Zero Root**: Runs in Termux + proot-distro.
 
 ## Installation
 
-### Quick Install (Recommended)
-
 Run this single command in Termux:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/install.sh | bash
 ```
 
-This will:
-1. Update Termux packages
-2. Install proot-distro and Ubuntu
-3. Configure auto-login
-4. Install Node.js 22 and OpenClaw
-5. Apply enhanced network patch (Bionic Bypass v2)
-6. Install proot-distro compatibility wrapper
-7. Configure systemd fallback for gateway management
-8. Run onboarding wizard
-
-### Manual Install
-
-If you prefer step-by-step installation:
-
-**Step 1: Update Termux and install dependencies**
-```bash
-pkg update && pkg upgrade -y
-pkg install proot-distro -y
-```
-
-**Step 2: Install Ubuntu container**
-```bash
-proot-distro install ubuntu
-```
-
-**Step 3: Configure auto-login**
-```bash
-echo "proot-distro login ubuntu" >> ~/.bashrc
-```
+## Manual Steps (What the script does)
 
-**Step 4: Login to Ubuntu**
-```bash
-proot-distro login ubuntu
-```
-
-**Step 5: Update Ubuntu and install Node.js 22**
-```bash
-apt update && apt upgrade -y
-apt install curl git build-essential -y
-curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
-apt install -y nodejs
-```
-
-**Step 6: Install OpenClaw**
-```bash
-npm install -g openclaw@latest
-```
-
-**Step 7: Create network interface patch (Bionic Bypass)**
-```bash
-cat << 'JS' > /root/hijack.js
-const os = require('os');
-os.networkInterfaces = () => ({
-  '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'
-  }]
-});
-JS
-```
-
-**Step 8: Configure environment**
-```bash
-echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
-source ~/.bashrc
-```
-
-**Step 9: Run onboarding**
-```bash
-openclaw onboard
-```
-
-When asked for Gateway Bind, select **Loopback (127.0.0.1)**.
-
-**Step 10: Start the gateway**
-```bash
-openclaw gateway --verbose
-```
+1. Updates Termux and installs `proot-distro`.
+2. Installs `ubuntu` container.
+3. Logs into Ubuntu and installs:
+   - `curl`, `git`, `build-essential`
+   - `Node.js 22`
+   - `openclaw` (global)
+4. Creates the **Bionic Bypass** (`/root/hijack.js`):
+   ```js
+   const os = require('os');
+   os.networkInterfaces = () => ({});
+   ```
+5. Adds `export NODE_OPTIONS="-r /root/hijack.js"` to `.bashrc`.
 
 ## Usage
 
-### Start the AI Gateway
-```bash
-openclaw gateway --verbose
-```
-
-### Run onboarding wizard
-```bash
-openclaw onboard
-```
-
-### Analyze a website
-```bash
-openclaw analyze https://example.com
-```
-
-### Get help
-```bash
-openclaw --help
-```
-
-### Check gateway status
-```bash
-openclaw-service-manager status
-```
-
-### Stop the gateway
-```bash
-openclaw-service-manager stop
-```
-
-### Restart the gateway
-```bash
-openclaw-service-manager restart
-```
-
-## Access the Dashboard
-
-Once the gateway is running, open your browser to:
-
-```
-http://127.0.0.1:18789
-```
-
-**Note**: To use the Web Gateway chat, copy the `token` from `~/.openclaw/openclaw.json` and paste it in the dashboard under **Overview -> Gateway Access**.
-You can also fetch the token with `openclaw config get gateway.auth.token`.
-
-## Verifying Installation
-
-After installation completes, you can verify everything is working by running:
+After installation, you will be automatically logged into the Ubuntu environment.
 
+**1. Setup & Configuration:**
+Run the configuration wizard to set up your Gateway, LLM Models, and Social Channels (Telegram/WhatsApp):
 ```bash
-# From Termux (outside Ubuntu)
-bash verify.sh
+openclaw config
 ```
+*   **Gateway Bind**: MUST be `127.0.0.1` (Loopback).
+*   **Telegram Pairing**: Select "Telegram" in the menu. You will be prompted to enter your Bot Token and then given a pairing code/link to verify in your Telegram app.
 
-This will check:
-- Termux/Ubuntu environment
-- proot-distro and Ubuntu container
-- Node.js and npm installation
-- OpenClaw global package
-- Termux shortcut and Ubuntu command
-- Network bypass script
-- Environment configuration
-
-If all checks pass, you're ready to use OpenClaw!
-
-### Quick Test Commands
-
-**From Termux (after reopening):**
+**2. Start Gateway:**
 ```bash
-openclaw --help
+openclaw gateway --verbose
 ```
 
-**From inside Ubuntu:**
-```bash
-openclaw --help
-```
+## Termux Controls & Tips
 
-Both should show the OpenClaw help menu.
+- **Backing Out / Exit**:
+  - To kill a running process (like the gateway): Press `CTRL` + `C`.
+  - To exit the Ubuntu shell (back to Termux): Press `CTRL` + `D` (or `CAPS LOCK` + `CTRL` + `D`) or type `exit`.
+- **Keyboard Shortcuts**:
+  - On touch keyboards, `Volume Down` often acts as `CTRL`.
+  - `Volume Up` + `Q` can toggle extra keys row.
 
 ## Troubleshooting
 
-### "openclaw: command not found"
-If you see this error after installation:
-1. Ensure you are inside Ubuntu (`proot-distro login ubuntu`)
-2. Run `source ~/.bashrc` to reload your path
-3. If that fails, run `npm install -g openclaw@latest` again inside Ubuntu
-
-### "System Error 13" or "Failed to start CLI"
-This is a critical issue on Android caused by network interface restrictions.
-v5.0 fixes this with an enhanced Bionic Bypass.
-1. Run `cat /root/hijack.js` and verify it contains the 'lo' interface mock.
-2. Check if NODE_OPTIONS is set: `echo $NODE_OPTIONS`
-3. If empty, run `export NODE_OPTIONS="--require /root/hijack.js"`
-4. **Self-Repair**: The new wrapper automatically fixes this. Just run `openclaw gateway` again.
-
-### Gateway not starting / System Error 13
-This usually means the network patch isn't applied.
-1. Check if patch exists: `ls /root/hijack.js`
-2. Check if NODE_OPTIONS is set: `echo $NODE_OPTIONS`
-3. It should print `--require /root/hijack.js`. If empty, run `export NODE_OPTIONS="--require /root/hijack.js"`
-4. **Best Solution**: Run `bash full_repair.sh` to fix everything automatically.
-
-### "systemctl --user unavailable" error
-This is automatically handled in v5.0 with our proot-distro compatibility wrapper. The installer creates a fake systemctl that provides fallback functionality for gateway management.
-
-### Gateway service management issues
-Use the built-in service manager:
-- Check status: `openclaw-service-manager status`
-- Start service: `openclaw-service-manager start`
-- Stop service: `openclaw-service-manager stop`
-- Restart service: `openclaw-service-manager restart`
-
-### Termux crashes or kills process
-Android kills background apps to save battery.
-1. **Disable Battery Optimization**: Go to Android Settings -> Apps -> Termux -> Battery -> Unrestricted
-2. **Acquire Wake Lock**: Run `termux-wake-lock` in a separate Termux session
-3. **Use tmux**: `pkg install tmux -y` then run `tmux` before logging into Ubuntu. This keeps your session alive even if the app closes.
-
-## Pro Tips
-
-- **Keep it Alive**: Android will kill Termux in the background. Run `termux-wake-lock` in a separate Termux session and disable "Battery Optimization" for Termux.
-- **The UI**: Access your dashboard by going to `http://127.0.0.1:18789` in your phone's browser. Get your token using `openclaw config get gateway.auth.token`.
-- **Security**: Never show your full API keys or Gateway tokens in videos. Revoke keys if exposed.
-- **Remote Access**: Install `openssh` in Termux to SSH into your phone from your PC.
-- **Reset**: If things get messy, you can reinstall Ubuntu: `proot-distro remove ubuntu && proot-distro install ubuntu`
-
-## What's New in v5.0
-
-### Bionic Bypass v2
-- **Enhanced Mocking**: Mocks loopback interface to satisfy strict Node.js networking checks
-- **Self-Healing**: Wrapper automatically restores the bypass if deleted
-- **Robustness**: Prevents System Error 13 in more edge cases
-
-### Enhanced proot-distro Compatibility
-- **Fake systemctl**: Automatically creates a compatibility layer for systemd commands
-- **Service Manager**: Built-in service management without requiring systemd
-- **Gateway Auto-Start**: Seamless gateway startup without manual intervention
-- **Error Handling**: Improved error messages and recovery mechanisms
-
-### Improved Installation Process
-- **One-Command Setup**: Enhanced installer with automatic compatibility detection
-- **Systemd Fallback**: Automatic fallback when systemd is unavailable
-- **Better Logging**: Enhanced logging for troubleshooting installation issues
-- **Service Management**: Integrated service manager for gateway control
-
-### Enhanced User Experience
-- **Simplified Commands**: Use `openclaw-service-manager` for gateway control
-- **Better Status Reporting**: Clear status messages for service operations
-- **Automatic Recovery**: Self-healing mechanisms for common issues
-- **Backward Compatibility**: Maintains compatibility with existing OpenClaw features
-
-## Verified Commands
-
-Once the gateway is live, use these chat commands in your linked WhatsApp/Telegram:
-
-- `/status` — Check the health of your pocket agent
-- `/think high` — Put the bot in "deep reasoning" mode
-- `/reset` — Clear the current session memory
-
-## Additional Resources
-
-### Access the Web Gateway
-To chat using the web gateway, copy the `token` value from `~/.openclaw/openclaw.json` and paste it at:
-```
-http://127.0.0.1:18789
-```
-Navigate to **Overview → Gateway Access → Gateway Token**.
-
-### Get Gateway Token
-```bash
-openclaw config get gateway.auth.token
-```
-
-## Project Structure
-
-```
-openclaw-droid/
-├── install.sh           # Main installer script
-├── hijack.js            # Network interface patch (reference)
-├── openclaw-wrapper.sh  # proot-distro compatibility wrapper
-├── README.md            # This file
-└── package.json         # NPM package configuration
-```
-
-## Useful Resources
-
-- **[OpenClaw](https://github.com/openclaw/openclaw)**: Core AI Gateway
-- **[ClawHub](https://clawhub.ai/)**: Discover and install skills
-- **[OpenClaw Skills](https://github.com/openclaw/skills)**: Official skill library
-- **[Termux Wiki](https://wiki.termux.com/)**: Termux documentation
-- **[proot-distro](https://github.com/termux/proot-distro)**: Linux distro manager
+- **DPKG/APT Errors**: If installation fails with `dpkg error processing package` or `sub-process returned an error code (1)`:
+  - Run `dpkg --configure -a` manually in Termux.
+  - Run `apt --fix-broken install`.
+  - Re-run the installer.
+- **System Error 13**: Ensure `NODE_OPTIONS` is set (`echo $NODE_OPTIONS`). If not, run `source ~/.bashrc`.
+- **Gateway Bind Crash**: You MUST select Loopback (127.0.0.1) during onboarding.
 
 ## License
 
-MIT © [NosytLabs](https://github.com/NosytLabs)
-
-## Support
-
-- **Issues**: https://github.com/NosytLabs/openclaw-droid/issues
-- **Discussions**: https://github.com/NosytLabs/openclaw-droid/discussions
+MIT

package/hijack.js

@@ -1,5 +1,2 @@
-cat <<EOF > /root/hijack.js
-const { EOF } = require('dns');
 const os = require('os');
 os.networkInterfaces = () => ({});
-EOF