Skip to content

ClawBridge is the OpenClaw Mobile Dashboard. Monitor agent's real-time thoughts, actions, track token costs, and manage tasks from anywhere using your pocket-sized Mission Control.

Notifications You must be signed in to change notification settings

dreamwing/clawbridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

173 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClawBridge Logo

ClawBridge Dashboard

The OpenClaw Mobile Dashboard & Mission Control.

Website OpenClaw License



[ English | 简体中文 ]


ClawBridge is the definitive Mobile Dashboard for OpenClaw agents. It serves as your pocket-sized Mission Control—monitor real-time thoughts, track token costs, and manage background tasks from anywhere, securely and instantly.

✨ Key Features

  • 📱 Mobile-First Dashboard: Optimized for phone screens. View logs, stats, and controls without squinting.
  • 🧠 Live Activity Feed: Watch your agent "think" and execute tools in real-time. Features intelligent parallel logging (no missed background tasks) and deduplication.
  • 💰 Token Economy: Track daily/monthly LLM costs and usage trends. Know exactly where your money goes.
  • 📜 Memory Timeline: Browse your agent's daily journals and long-term memory evolution.
  • 🚀 Mission Control: Trigger cron jobs, restart services, or kill runaway scripts directly from the UI.
  • ⚡ Zero-Config Remote:
    • Auto-Port: Automatically finds an available port if 3000 is busy.
    • Smart Networking: Auto-detects Tailscale/WireGuard for direct secure access.
    • Quick Tunnel: If no VPN is found, auto-generates a temporary public URL via Cloudflare (Zero Config).

🚀 Installation

Run this one-liner on your OpenClaw server (Ubuntu/Debian):

curl -sL https://clawbridge.app/install.sh | bash

That's it. The script will:

  1. Detect your environment (VPN or Public).
  2. Generate a secure Access Key.
  3. Give you a ready-to-use URL.

📱 Usage

1. Zero-Config Access (Default)

If you just want to try it out, the installer provides a Quick Tunnel URL: https://<random-name>.trycloudflare.com/?key=<YOUR_KEY>

  • Pros: Instant access from anywhere.
  • Cons: URL changes if you restart the service.

2. VPN Direct Access (Privacy First)

If Tailscale or WireGuard is detected, the installer skips the public tunnel and gives you a private link: http://<VPN_IP>:3000/?key=<YOUR_KEY>

  • Pros: Fastest speed, maximum privacy.
  • Cons: Your phone must be connected to the VPN.

3. Permanent Public Domain (Advanced)

Want a fixed URL like dash.yoursite.com?

  1. Obtain a Cloudflare Tunnel Token from the Zero Trust Dashboard.
  2. Run the installer with the token:
    cd skills/clawbridge
    ./install.sh --token=<YOUR_TOKEN>
    • Or force a new Quick Tunnel: ./install.sh --force-cf

📱 Mobile App (PWA)

  1. Open the dashboard in Safari (iOS) or Chrome (Android).
  2. Tap "Share" -> "Add to Home Screen".
  3. Launch it like a native app (full screen, no browser bar).

🛠️ Tech Stack

  • Backend: Node.js (Express, WebSocket) - Lightweight sidecar process.
  • Frontend: Vanilla JS - Zero build step, instant load.
  • Tunnel: Cloudflared

Credits

Special thanks to our community for helping improve ClawBridge:

  • @yaochao for reporting critical security and portability issues and suggesting architectural refactoring (#1, #2, #3, #4, #5, #6, #7).
  • @斯图超哥 for feedback on Linux compatibility, IP detection stability, and Quick Tunnel refresh logic (#12).
  • @zjy4fun for valuable contributions in workspace detection fix (PR #22).
  • @chrisuhg for valuable contributions in resolving installation and auth loop issues (Issue #19).

MIT License. Built for the OpenClaw Community.

About

ClawBridge is the OpenClaw Mobile Dashboard. Monitor agent's real-time thoughts, actions, track token costs, and manage tasks from anywhere using your pocket-sized Mission Control.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors