openclaw-droid 3.10.0 → 4.20.0

package/LICENSE

@@ -1,21 +1,19 @@
-MIT License
-
-Copyright (c) 2026 Mithun Gowda B
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,10 @@
-# OpenClaw Droid
+# OpenClaw Droid v4.20 - Android AI Gateway Installer
 
-> **The Android AI Gateway Installer** by [NosytLabs](https://github.com/NosytLabs)
+> **The Ultimate Android AI Gateway Installer** by [NosytLabs](https://github.com/NosytLabs)
 
-Turn your Android device into a 24/7 AI Gateway using OpenClaw with proot-distro Ubuntu.
+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
 
 ## Features
 
@@ -10,6 +12,10 @@ Turn your Android device into a 24/7 AI Gateway using OpenClaw with proot-distro
 - **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**: Automatically patches Android network restrictions
+- **Systemd Compatibility**: Enhanced proot-distro compatibility with fake systemctl
+- **Seamless Gateway Management**: Automatic service management without systemd
+- **V4.20 Release**: Latest stable version with improved reliability
 
 ## Prerequisites
 
@@ -29,12 +35,12 @@ curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/insta
 
 This will:
 1. Update Termux packages
-2. Install proot-distro
-3. Set up Ubuntu container
-4. Configure auto-login to Ubuntu
-5. Install Node.js 22
-6. Install OpenClaw globally
-7. Apply network interface patch
+2. Install proot-distro and Ubuntu
+3. Configure auto-login
+4. Install Node.js 22 and OpenClaw
+5. Apply network patch
+6. Install proot-distro compatibility wrapper
+7. Configure systemd fallback for gateway management
 8. Run onboarding wizard
 
 ### Manual Install
@@ -65,39 +71,27 @@ 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
+npm install -g openclaw@latest
 ```
 
 **Step 7: Create network interface patch (Bionic Bypass)**
 ```bash
-cat << 'JS' > /root/patch.js
+cat << 'JS' > /root/hijack.js
 const os = require('os');
-os.networkInterfaces = function() {
-  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"
-      }
-    ]
-  };
-};
+os.networkInterfaces = () => ({});
 JS
 ```
 
 **Step 8: Configure environment**
 ```bash
-echo 'export NODE_OPTIONS="--require /root/patch.js"' >> ~/.bashrc
+echo 'export NODE_OPTIONS="-r /root/hijack.js"' >> ~/.bashrc
 source ~/.bashrc
 ```
 
@@ -135,6 +129,21 @@ openclaw analyze https://example.com
 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:
@@ -143,54 +152,132 @@ Once the gateway is running, open your browser to:
 http://127.0.0.1:18789
 ```
 
-## Troubleshooting
+**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`.
 
-### Gateway not starting
-- Ensure Ubuntu container is running: `proot-distro login ubuntu`
-- Check Node.js version: `node -v` (should be v22.x)
-- Verify network patch is applied: `ls /root/hijack.js`
+## Verifying Installation
 
-### Network interface errors
-- The hijack.js file fixes Android network restrictions
-- Make sure `NODE_OPTIONS` is set: `echo $NODE_OPTIONS`
-- Reapply the patch if needed
+After installation completes, you can verify everything is working by running:
 
-### Termux crashes or kills process
-- Disable battery optimization for Termux in Android settings
-- Keep Termux notification active
-- Consider using tmux for persistent sessions: `pkg install tmux -y`
+```bash
+# From Termux (outside Ubuntu)
+bash verify.sh
+```
+
+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
 
-### Ubuntu container issues
-- Reinstall container: `proot-distro remove ubuntu && proot-distro install ubuntu`
-- Check disk space: `df -h`
+If all checks pass, you're ready to use OpenClaw!
 
-## Advanced Usage
+### Quick Test Commands
 
-### 24/7 Mode with tmux
+**From Termux (after reopening):**
 ```bash
-pkg install tmux -y
-tmux new -s openclaw
-proot-distro login ubuntu
-openclaw gateway --verbose
+openclaw --help
 ```
 
-Detach with `Ctrl+b` then `d`. Reattach with `tmux attach -t openclaw`.
+**From inside Ubuntu:**
+```bash
+openclaw --help
+```
 
-### Update OpenClaw
+Both should show the OpenClaw help menu.
+
+## 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
+
+### 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"`
+
+### "systemctl --user unavailable" error
+This is automatically handled in v4.20 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 v4.20
+
+### 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
-proot-distro login ubuntu
-npm update -g openclaw
+openclaw config get gateway.auth.token
 ```
 
 ## Project Structure
 
 ```
 openclaw-droid/
-├── install.sh    # Main installer script
-├── hijack.js     # Network interface patch
-├── README.md     # This file
-├── LICENSE       # MIT License
-└── package.json  # NPM package configuration
+├── 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

package/bin/openclaw

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+console.log("This package 'openclaw-droid' is an installer script.");
+console.log("Please run the install.sh script to install the OpenClaw Android Gateway.");
+console.log("Usage: curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/install.sh | bash");

package/hijack.js

@@ -1,15 +1,2 @@
 const os = require('os');
-os.networkInterfaces = function() {
-  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"
-      }
-    ]
-  };
-};
+os.networkInterfaces = () => ({});