AI

Deploy Openclaw on Android

AI Android Deployment Mobile Openclaw
Image
Karinov Webmaster
Table of contents: [Show]

Quick Start

Deploying Openclaw on Android lets you run your AI agent companion directly on your mobile device. This guide walks you through connecting your Android phone to an Openclaw Gateway running on your main machine.

Openclaw Android Deployment

Prerequisites

  • An Android phone (Android 8.0+ recommended)
  • A host machine running the Openclaw Gateway
  • Both devices on the same network (or connected via Tailscale VPN)

Step-by-Step Setup

Step 1: Start Your Gateway

Ensure your Openclaw Gateway is running on your main host machine. Start it in your terminal with:

Openclaw gateway --port 18789 --verbose

Note: If your phone and Gateway are on different networks but connected via Tailscale, ensure your Gateway is bound to the tailnet IP.

Step 2: Install the Openclaw Android App

  1. Download the Openclaw Android APK from the official releases page
  2. Enable Install from Unknown Sources in your Android settings
  3. Install the APK and open the app

Step 3: Pair Your Device

When you first open the app, it will scan for available Gateways or prompt you to enter a Gateway URL manually.

Option A: Auto-discovery (same network)

If your phone and Gateway are on the same WiFi network, the app should automatically detect the Gateway.

Option B: Manual entry

Enter your Gateway URL: http://YOUR_GATEWAY_IP:18789

Step 4: Approve the Connection

On your Gateway host machine, list and approve the pending device:

Openclaw devices list

Note the request ID, then approve it:

Openclaw devices approve <requestId>

Configuration

For persistent connections, add the following to your ~/.Openclaw/Openclaw.json:

{"devices": {"allowPairing": true, "autoApprove": false}} Openclaw Web Interface

Troubleshooting & Best Practices

  • Connection refused: Ensure your Gateway is bound to 0.0.0.0 or your local network IP, not just 127.0.0.1
  • Firewall issues: Open port 18789 on your host machine's firewall
  • Battery optimization: Disable battery optimization for the Openclaw app to prevent disconnections
  • Background sync: Enable background data usage for the app to receive messages when not actively open

For remote deployments, consider using Fly.io hosting for always-on access.

Next Steps

Once connected, you can start chatting with your Openclaw agent, execute tools, and manage your workspace directly from your Android device. The mobile interface supports all the same features as the web dashboard.

Tags: