https://github.com/dreamwing/clawbridge

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.
https://github.com/dreamwing/clawbridge

openclaw openclaw-dashboard openclaw-extension openclaw-mobile-dashboard openclaw-monitoring openclaw-plugin openclaw-skills

Last synced: 2 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/dreamwing/clawbridge
• Owner: dreamwing
• Created: 2026-02-15T07:20:56.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2026-03-01T13:01:24.000Z (2 months ago)
• Last Synced: 2026-03-01T13:09:26.602Z (2 months ago)
• Topics: openclaw, openclaw-dashboard, openclaw-extension, openclaw-mobile-dashboard, openclaw-monitoring, openclaw-plugin, openclaw-skills
• Language: JavaScript
• Homepage: https://clawbridge.app/
• Size: 36.5 MB
• Stars: 136
• Watchers: 1
• Forks: 6
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-openclaw - dreamwing/clawbridge - Mobile dashboard for monitoring sessions, costs, and tasks. (🎛️ Dashboards & Control Centers)

README

          


  

  
ClawBridge Dashboard

  
The OpenClaw Mobile Dashboard & Mission Control.


  

    

  

  

    

  

  

    

  

  

  



  [ 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):

```bash

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://.trycloudflare.com/?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://:3000/?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:

    ```bash

    cd skills/clawbridge

    ./install.sh --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](https://github.com/yaochao) for reporting critical security and portability issues and suggesting architectural refactoring (#1, #2, #3, #4, #5, #6, #7).

- [@斯图超哥](https://x.com/StewartLi666) for feedback on Linux compatibility, IP detection stability, and Quick Tunnel refresh logic (#12).

- [@zjy4fun](https://github.com/zjy4fun) for valuable contributions in workspace detection fix (PR #22).

- [@chrisuhg](https://github.com/chrisuhg) for valuable contributions in resolving installation and auth loop issues (Issue #19).

---

*MIT License. Built for the OpenClaw Community.*