clawapp

Project Overview

ClawApp lets you chat with your OpenClaw AI agent from your phone browser. OpenClaw is a powerful AI agent platform, but its Gateway only listens on localhost (127.0.0.1:18789) by default, so phones cannot connect directly. ClawApp solves this: the phone browser (on any network) connects through a WebSocket proxy server (ClawApp Server, port 3210, with offline caching) to the OpenClaw Gateway (port 18789). The proxy server automatically completes Ed25519 device signature handshake authentication (compatible with OpenClaw 2.13+) and provides an H5 chat page that works right away without installing an app.

Key Features

• Real-time streaming chat (typewriter effect)
• Image sending/receiving (camera/album upload, AI image replies)
• Markdown rendering + code highlighting (XSS protection)
• Quick command panel (/model, /think, /new, etc.)
• Real-time tool call status display
• Voice input (speech-to-text, requires HTTPS)
• Multi-agent support (choose different Agents when creating sessions)
• Session management (switch, create, delete)
• Theme switching (light / dark / follow system)
• Chinese/English switching
• Smart reconnection (auto-recovery, no flicker, message deduplication)
• Token / Password + Ed25519 device authentication (compatible with OpenClaw 2.13+)
• Offline message caching (IndexedDB persistence, view history offline, auto-sync on recovery)
• New user onboarding
• PWA support (add to home screen, offline available)
• Android APK packaging

Target Audience

• OpenClaw users
• Users who want to use the AI agent from their phone browser
• Users who need to access the OpenClaw Gateway from outside the local network

Quick Start

1. Ensure OpenClaw Gateway is running on your computer (default port 18789)
2. Deploy the ClawApp proxy server with one command (Mac/Linux or Windows PowerShell)
3. With phone and computer on the same WiFi, open http://computer-IP:3210 in your phone browser
4. Enter the server address and Token, then click connect

Core Advantages

• Solves the problem of phones being unable to connect directly to OpenClaw Gateway
• No app installation needed; works right in the phone browser
• Supports both PWA and Android APK
• Offline message caching for viewing history without network
• Automatic Ed25519 device signature authentication

System Requirements

• OS: Windows, macOS, Linux (server); Android / iOS (client)
• Additional dependencies: OpenClaw Gateway must be running; Node.js 18+ or Docker; HTTPS environment for voice input