Summary

ClawApp provides a mobile-first, browser-based chat client for OpenClaw AI agents, addressing the limitation of the default local-only Gateway. It enables users to interact with their AI agents from any smartphone, offering features like real-time streaming chat, image transfer, and tool invocation, thereby extending the usability of OpenClaw beyond a desktop environment.

How It Works

ClawApp acts as a WebSocket proxy server, bridging mobile browsers to the OpenClaw Gateway. A mobile device connects via WebSocket (WS/WSS) to the ClawApp Server (port 3210), which then establishes a secure connection to the OpenClaw Gateway (port 18789) using WebSocket and Ed25519 device signature authentication. This architecture facilitates remote access, supports offline message caching via IndexedDB, and provides a seamless chat experience without requiring native app installation for its H5 interface.

Quick Start & Requirements

• Prerequisites:
  • OpenClaw Gateway running (default port 18789).
  • Node.js 18+ or Docker installed.
• Installation:
  • One-click deploy (Mac/Linux):

    curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawapp/main/install.sh | bash
    

  • One-click deploy (Windows PowerShell):

    irm https://raw.githubusercontent.com/qingchencloud/clawapp/main/install.ps1 | iex
    

  • Docker: git clone https://github.com/qingchencloud/clawapp.git, cd clawapp, configure .env with PROXY_TOKEN and OPENCLAW_GATEWAY_TOKEN/OPENCLAW_GATEWAY_PASSWORD, then docker compose up -d --build.
  • Direct Install: git clone, cd clawapp, npm run install:all, npm run build:h5, configure server/.env, then npm start.
• Mobile Access: Open http://<your-computer-ip>:3210 in your phone's browser.
• Links: Product Homepage: clawapp.qt.cool, cftunnel: https://github.com/qingchencloud/cftunnel.

Highlighted Details

• Real-time streaming chat with typewriter effect, Markdown rendering, and code highlighting (XSS protected).
• Image send/receive capabilities and voice input (requires HTTPS).
• Offline message caching using IndexedDB, with PWA support for home screen installation and offline use.
• Robust authentication via Token/Password and Ed25519 device signatures (compatible with OpenClaw 2.13+).
• Android APK packaging is automated via Capacitor and GitHub Actions.

Maintenance & Community

Developed and maintained by 晴辰云 (Qingchen Cloud). Community engagement is facilitated through Discord, QQ Group, WeChat Group, and Feishu Group. Related projects include OpenClaw, OpenClaw Chinese Localization, and cftunnel.

Licensing & Compatibility

Released under the MIT License, which is permissive for commercial use and integration. The project is compatible with OpenClaw 2.13+.

Limitations & Caveats

Voice input functionality is restricted to HTTPS environments, necessitating solutions like Cloudflare Tunnel for external access. Remote access requires specific network configurations (e.g., cftunnel, SSH tunneling, Nginx reverse proxy). Network stability and proxy timeout configurations are critical for reliable WebSocket connections.