npm - openclaw-droid - Versions diffs - 2.0.6 → 3.0.0 - Mend

openclaw-droid 2.0.6 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of openclaw-droid might be problematic. Click here for more details.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -1,210 +1,209 @@
-# OpenClaw Droid 🤖
-> **Run OpenClaw AI Gateway on Android via Termux**
-> One-command setup. Optimized for mobile. Bionic Bypass included.
-![License](https://img.shields.io/badge/license-MIT-blue.svg)
-![Platform](https://img.shields.io/badge/platform-Android%20%7C%20Termux-green.svg)
-![Version](https://img.shields.io/npm/v/openclaw-droid.svg)
-**OpenClaw Droid** makes running [OpenClaw](https://github.com/openclaw/openclaw) on Android effortless. It handles environment setup (proot-distro, Ubuntu, Node.js) and fixes Android-specific issues automatically.
-## 🚀 Why OpenClaw Droid?
-Running standard Node.js AI tools on Android is painful because of:
-*   **Bionic libc**: Android's C library differs from Linux (glibc), breaking `os.networkInterfaces()` and DNS lookups.
-*   **Permissions**: Termux has restricted access to system resources.
-*   **Environment**: Many tools expect a full Linux userland (Ubuntu/Debian).
-**OpenClaw Droid solves this by:**
-1.  Creating a lightweight **Ubuntu** container inside Termux.
-2.  Injecting a **Bionic Bypass** script to fix networking.
-3.  Providing a simple CLI (`openclaw`) to manage the gateway.
-## 📦 Installation
-### Prerequisites
-*   **Android 10+**
-*   **Termux** (Install from [F-Droid](https://f-droid.org/packages/com.termux/), NOT Play Store)
-*   **Termux:API** and **Termux:GUI** apps (from F-Droid)
-*   ~2GB free storage
-### Required Apps Setup
-1. **Install Termux** from [F-Droid](https://f-droid.org/packages/com.termux/)
-2. **Install Termux:API** from [F-Droid](https://f-droid.org/packages/com.termux.api/)
-3. **Install Termux:GUI** from [F-Droid](https://f-droid.org/packages/com.termux.gui/)
-4. **Grant permissions** in Android Settings:
-   - Go to Settings → Apps → Termux → Permissions
-   - Grant all permissions (Camera, Microphone, Storage, Location, etc.)
-   - Repeat for Termux:API and Termux:GUI
-5. **Disable battery optimization** for Termux:
-   - Go to Settings → Apps → Termux → Battery
-   - Set to "Unrestricted" or "Don't optimize"
-6. **Grant storage permissions** in Termux:
-   ```bash
-   termux-setup-storage
-   ```
-### Install Required Packages
-Update package lists and install essential tools:
-```bash
-# Update package lists
-pkg update && pkg upgrade
-# Install x11-repo (required for termux-gui)
-pkg install -y x11-repo
-# Install required packages
-pkg install -y git python nodejs-lts proot-distro termux-api termux-gui
-# Verify installations
-node --version
-python --version
-```
-If termux-gui is unavailable, continue without it (overlay features disabled).
-### One-Command Setup
-Open Termux and run:
-```bash
-curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/install.sh | bash
-```
-Or via npm:
-```bash
-npm install -g openclaw-droid
-openclaw setup
-```
-**IMPORTANT:** Use `npm install -g openclaw@latest` installation method (not bash script) as it's more reliable on Android. The installation may take 15-30 minutes due to llama.cpp compilation from scratch.
-## 🎮 Usage
-### 1. Initialize
-First, configure your API keys:
-```bash
-openclaw onboarding
-```
-> **IMPORTANT:** Select **Loopback (127.0.0.1)** for Binding.
-### 2. Start Gateway
-Launch the OpenClaw gateway:
-```bash
-openclaw start
-```
-**Recommended:** Run the gateway in a tmux session for better process management:
-```bash
-# Install tmux first if not installed
-pkg install tmux
-# Start a new tmux session
-tmux new -s openclaw
-# Run the gateway
-openclaw start
-# Detach from tmux (keep it running): Ctrl+B, then D
-# Reattach to tmux session: tmux attach -t openclaw
-```
-The dashboard will be available at:
-- **http://127.0.0.1:18789** (on the phone)
-- **http://<phone-ip>:18789** (from other devices on WiFi, requires gateway.bind = lan)
-### 3. Enable Screen Overlay (Optional)
-To allow OpenClaw to display overlay messages on your screen:
-```bash
-# In a separate tmux window or terminal:
-tmux new-window
-cd ~
-python ~/overlay_daemon.py
-```
-Or use the built-in command:
-```bash
-openclaw overlay
-```
-Now OpenClaw can write to the screen by creating `~/overlay.txt`:
-```bash
-printf 'Hello from OpenClaw!' > ~/overlay.txt
-```
-The overlay daemon watches for changes to `~/overlay.txt` and displays the content as a screen overlay. This is useful for displaying status updates, notifications, or important information to the user.
-### 4. Other Commands
-| Command | Description |
-| :--- | :--- |
-| `openclaw status` | Check installation health |
-| `openclaw update` | Update OpenClaw to latest version |
-| `openclaw shell` | Open Ubuntu shell |
-| `openclaw repair` | Re-install dependencies if broken |
-| `openclaw <cmd>` | Run any OpenClaw command (e.g., `openclaw doctor`) |
-## ⚠️ Troubleshooting
-**"Setup not complete" error**
-*   Run `openclaw setup` again.
-*   If it persists, run `openclaw repair`.
-**Process killed in background**
-*   Go to Android Settings → Apps → Termux → Battery → **Unrestricted**.
-**Permission denied errors**
-*   Run `termux-setup-storage` to grant storage permissions
-*   Ensure Termux:API and Termux:GUI have proper permissions
-**Cannot access /tmp/openclaw errors**
-*   OpenClaw requires a custom TMPDIR on Termux. The installer should configure this automatically.
-*   If you still see these errors, manually add to `~/.bashrc`:
-  ```bash
-  echo 'export TMPDIR="$PREFIX/tmp"' >> ~/.bashrc
-  echo 'export TMP="$TMPDIR"' >> ~/.bashrc
-  echo 'export TEMP="$TMPDIR"' >> ~/.bashrc
-  echo 'if [ ! -d "$TMPDIR" ]; then mkdir -p "$TMPDIR"; fi' >> ~/.bashrc
-  source ~/.bashrc
-  mkdir -p /data/data/com.termux/files/usr/tmp/openclaw
-  ```
-**"systemd not found" errors**
-*   These are normal on Android/Termux and can be safely ignored.
-*   OpenClaw will function without systemd.
-**Installation fails on dependencies**
-*   Some dependencies may fail to install initially. Install them manually:
-  ```bash
-  pkg install -y python git proot-distro
-  npm install -g openclaw@latest
-  ```
-*   The llama.cpp compilation takes 15-30 minutes - let it complete.
-**"E: unable to locate package termux-git" errors**
-*   Install Termux from F-Droid and update repositories: `pkg update && pkg upgrade`
-*   Use `pkg install git` (the Termux package name is `git`, not `termux-git`)
-**"E: unable to locate package termux-gui" errors**
-*   Run `pkg install x11-repo` then retry `pkg install termux-gui`
-*   If it still fails, continue without termux-gui (overlay features disabled)
-**Gateway not accessible from other devices**
-*   Ensure `gateway.bind` is set to `lan` in your openclaw.json
-*   Check your phone's IP address: `ip addr show wlan0`
-*   Access via: `http://<phone-ip>:18789`
-## 📜 License
-MIT License.
+# OpenClaw Droid
+> **The 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.
+## 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
+## Prerequisites
+- **Android**: 10 or newer
+- **Termux**: F-Droid version only (https://f-droid.org/packages/com.termux/)
+- **API Key**: OpenClaw API key or compatible AI service
+## 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
+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
+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
+```
+**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
+curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+apt install -y nodejs
+```
+**Step 6: Install OpenClaw**
+```bash
+npm install -g openclaw
+```
+**Step 7: Create network interface patch**
+```bash
+cat << 'EOF' > /root/patch.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"
+      }
+    ]
+  };
+};
+EOF
+```
+**Step 8: Configure environment**
+```bash
+echo "export NODE_OPTIONS='--require /root/patch.js'" >> ~/.bashrc
+```
+**Step 9: Run onboarding**
+```bash
+export NODE_OPTIONS='--require /root/patch.js'
+openclaw onboard
+```
+**Step 10: Start the gateway**
+```bash
+openclaw gateway --token YOUR_TOKEN
+```
+## Usage
+### Start the AI Gateway
+```bash
+openclaw gateway --token YOUR_TOKEN
+```
+### Run onboarding wizard
+```bash
+openclaw onboard
+```
+### Analyze a website
+```bash
+openclaw analyze https://example.com
+```
+### Get help
+```bash
+openclaw --help
+```
+## Access the Dashboard
+Once the gateway is running, open your browser to:
+```
+http://127.0.0.1:18789/chat?
+```
+## Troubleshooting
+### 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/patch.js`
+### Network interface errors
+- The patch.js file fixes Android network restrictions
+- Make sure `NODE_OPTIONS` is set: `echo $NODE_OPTIONS`
+- Reapply the patch if needed
+### 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`
+### Ubuntu container issues
+- Reinstall container: `proot-distro remove ubuntu && proot-distro install ubuntu`
+- Check disk space: `df -h`
+## Advanced Usage
+### 24/7 Mode with tmux
+```bash
+pkg install tmux -y
+tmux new -s openclaw
+proot-distro login ubuntu
+openclaw gateway --token YOUR_TOKEN
+```
+Detach with `Ctrl+b` then `d`. Reattach with `tmux attach -t openclaw`.
+### Update OpenClaw
+```bash
+proot-distro login ubuntu
+npm update -g openclaw
+```
+## Project Structure
+```
+openclaw-droid/
+├── install.sh    # Main installer script
+├── patch.js      # Network interface patch
+├── README.md     # This file
+├── LICENSE       # MIT License
+└── 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
+## License
+MIT © [NosytLabs](https://github.com/NosytLabs)
+## Support
+- **Issues**: https://github.com/NosytLabs/openclaw-droid/issues
+- **Discussions**: https://github.com/NosytLabs/openclaw-droid/discussions

package/install.sh CHANGED Viewed

@@ -1,79 +1,104 @@
 #!/bin/bash
-#
-# OpenClaw Droid Installer
-# One-liner: curl -fsSL https://raw.githubusercontent.com/NosytLabs/openclaw-droid/main/install.sh | bash
-#
 set -e
-# Colors
 RED='\033[0;31m'
 GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
 BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
 NC='\033[0m'
 echo -e "${BLUE}"
 echo "╔═══════════════════════════════════════════╗"
-echo "║ OpenClaw Droid Installer v2.0.6           ║"
-echo "║ AI Gateway for Android (via Ubuntu Proot) ║"
+echo "║        OPENCLAW DROID INSTALLER          ║"
+echo "║           NosytLabs 2026                  ║"
 echo "╚═══════════════════════════════════════════╝"
 echo -e "${NC}"
-# Check if running in Termux
 if [ -z "$TERMUX_VERSION" ]; then
-    echo -e "${YELLOW}Warning:${NC} Not running in Termux - this script is designed for Termux."
+    echo -e "${RED}Error:${NC} This script must be run inside Termux."
+    echo -e "Install Termux from F-Droid: ${BLUE}https://f-droid.org/packages/com.termux/${NC}"
+    exit 1
 fi
-# Update and install packages
-echo -e "\n${BLUE}[1/3]${NC} Setting up Termux environment..."
+echo -e "\n${BLUE}[1/6]${NC} Updating Termux packages..."
+# Set non-interactive mode to avoid prompts
+export DEBIAN_FRONTEND=noninteractive
-pkg update -y && pkg upgrade -y
-pkg install proot-distro -y
+# Attempt update, but don't exit if it fails (common due to repo mirrors or dependency conflicts)
+# We use -o Dpkg::Options::="--force-confnew" to automatically accept new config files
+if ! pkg update -y -o Dpkg::Options::="--force-confnew" || ! pkg upgrade -y -o Dpkg::Options::="--force-confnew"; then
+    echo -e "${YELLOW}Warning: Termux package update had issues.${NC}"
+    echo -e "Attempting to proceed. If installation fails, try running 'pkg remove nodejs' manually."
+fi
+echo -e "\n${BLUE}[2/6]${NC} Installing proot-distro..."
+# Check if proot-distro is already installed to avoid re-installation issues
+if command -v proot-distro &> /dev/null; then
+    echo -e "  ${GREEN}✓${NC} proot-distro already installed."
+else
+    if ! pkg install proot-distro -y; then
+         echo -e "${RED}Error:${NC} Failed to install proot-distro."
+         echo -e "${YELLOW}Tip:${NC} Try running 'pkg remove nodejs' if you have dependency conflicts, then run this script again."
+         exit 1
+    fi
+fi
-# Install Ubuntu
-echo -e "\n${BLUE}[2/3]${NC} Installing Ubuntu environment..."
+echo -e "\n${BLUE}[3/6]${NC} Installing Ubuntu container..."
 if proot-distro list | grep -q "ubuntu.*(installed)"; then
-    echo -e "  ${GREEN}✓${NC} Ubuntu is already installed. Skipping installation."
+    echo -e "  ${GREEN}✓${NC} Ubuntu container already installed."
 else
-    proot-distro install ubuntu || true
+    echo -e "  ${YELLOW}Installing Ubuntu...${NC}"
+    if ! proot-distro install ubuntu; then
+        echo -e "${RED}Error:${NC} Failed to install Ubuntu container."
+        echo -e "Check your internet connection and disk space."
+        exit 1
+    fi
 fi
-# Add login alias
+echo -e "\n${BLUE}[4/6]${NC} Configuring auto-login..."
 if ! grep -q "proot-distro login ubuntu" ~/.bashrc; then
     echo "proot-distro login ubuntu" >> ~/.bashrc
-    echo -e " ${GREEN}✓${NC} Added 'proot-distro login ubuntu' alias to .bashrc"
+    echo -e "  ${GREEN}✓${NC} Auto-login configured."
+else
+    echo -e "  ${GREEN}✓${NC} Auto-login already configured."
 fi
+echo -e "\n${BLUE}[5/6]${NC} Creating internal setup script..."
 TERMUX_HOME="$HOME"
-INTERNAL_SCRIPT="$TERMUX_HOME/openclaw_setup_internal.sh"
+INTERNAL_SCRIPT="$TERMUX_HOME/openclaw_internal_setup.sh"
-# Create the internal setup script
 cat << 'EOF' > "$INTERNAL_SCRIPT"
 #!/bin/bash
 set -e
-# Colors inside proot
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
 NC='\033[0m'
-echo -e "\n${BLUE}[3/3]${NC} Configuring Ubuntu and installing OpenClaw..."
+echo -e "\n${BLUE}[6/6]${NC} Setting up OpenClaw in Ubuntu..."
+# Cleanup locks in case of previous failures
+rm -f /var/lib/dpkg/lock-frontend /var/lib/dpkg/lock
+dpkg --configure -a || true
-apt update && apt upgrade -y
-apt install -y curl nano git
+echo -e "\n${YELLOW}Updating Ubuntu packages...${NC}"
+export DEBIAN_FRONTEND=noninteractive
+apt update && apt upgrade -y -o Dpkg::Options::="--force-confnew"
-# Install Node.js 22
-echo -e "  Installing Node.js 22..."
-curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
-apt install -y nodejs
+echo -e "\n${YELLOW}Installing Node.js 22 from NodeSource...${NC}"
+# Check if already installed
+if ! command -v node &> /dev/null; then
+    curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+    apt install -y nodejs
+else
+    echo -e "  ${GREEN}✓${NC} Node.js already installed."
+fi
-# Install OpenClaw
-echo -e "  Installing OpenClaw..."
+echo -e "\n${YELLOW}Installing OpenClaw globally...${NC}"
 npm install -g openclaw
-# Create patch for network interfaces
-echo -e "  Applying network patch..."
+echo -e "\n${YELLOW}Creating network interface patch...${NC}"
 cat << 'JS' > /root/patch.js
 const os = require('os');
 os.networkInterfaces = function() {
@@ -92,34 +117,28 @@ os.networkInterfaces = function() {
 };
 JS
-# Set NODE_OPTIONS permanently
+echo -e "\n${YELLOW}Configuring environment...${NC}"
 if ! grep -q "NODE_OPTIONS" /root/.bashrc; then
     echo "export NODE_OPTIONS='--require /root/patch.js'" >> /root/.bashrc
 fi
-# Run onboarding
-echo -e "\n${GREEN}Starting OpenClaw Onboarding...${NC}"
+echo -e "\n${GREEN}Starting OpenClaw onboarding...${NC}"
 export NODE_OPTIONS='--require /root/patch.js'
-openclaw onboard
-echo -e "\n${GREEN}Installation complete!${NC}"
-echo -e "To start OpenClaw in the future:"
-echo -e "1. Run 'proot-distro login ubuntu'"
-echo -e "2. Run 'openclaw gateway'"
+openclaw onboard || echo -e "${YELLOW}Onboarding skipped or already completed.${NC}"
-# Optional: Start gateway now
-# openclaw gateway --token 1234
+echo -e "\n${GREEN}╔═══════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║        INSTALLATION COMPLETE!             ║${NC}"
+echo -e "${GREEN}╚═══════════════════════════════════════════╝${NC}"
 EOF
 chmod +x "$INTERNAL_SCRIPT"
-# Execute the internal script inside Ubuntu
-echo -e "\n${BLUE}Entering Ubuntu to finish setup...${NC}"
-proot-distro login ubuntu --bind "$TERMUX_HOME":/mnt/termux -- bash /mnt/termux/openclaw_setup_internal.sh
+echo -e "\n${BLUE}Entering Ubuntu container to run setup...${NC}"
+# Run the internal script
+proot-distro login ubuntu --bind "$TERMUX_HOME":/mnt/termux -- bash /mnt/termux/openclaw_internal_setup.sh
-# Cleanup
+echo -e "\n${GREEN}Cleaning up temporary files...${NC}"
 rm -f "$INTERNAL_SCRIPT"
-echo -e "\n${GREEN}═══════════════════════════════════════════${NC}"
-echo -e "${GREEN}OpenClaw Droid Setup Complete!${NC}"
-echo -e "${GREEN}═══════════════════════════════════════════${NC}"
+echo -e "\n${BLUE}Logging you into Ubuntu now...${NC}"
+exec proot-distro login ubuntu