Menu

Tree [f43aac] master /
 History

HTTPS access


File Date Author Commit
 .github 2 days ago dreamwing dreamwing [29bc53] ci: run lint and test on both ubuntu and macos
 data 4 days ago Winglet Winglet [8ee651] feat: sync model prices during installation
 public 3 days ago dreamwing dreamwing [5f15c4] refactor: split public/index.html into separate...
 scripts 2 days ago dreamwing dreamwing [cc54bc] feat: parse git history for omitted commits in ...
 src 2 days ago dreamwing dreamwing [3940e9] feat(macos): add launchd support and process/ne...
 tests 3 days ago dreamwing dreamwing [4ab7ea] test: add WebSocket auth tests and session prun...
 .env.example 6 days ago Winglet Winglet [a5d010] docs: update .env.example with latest tunnel co...
 .eslintrc.json 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 .gitignore 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 .prettierignore 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 .prettierrc.json 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 CHANGELOG.md 2 days ago dreamwing dreamwing [f43aac] docs: detail macOS support and IP fixes in v1.1...
 CHANGELOG_CN.md 2 days ago dreamwing dreamwing [f43aac] docs: detail macOS support and IP fixes in v1.1...
 README.md 2 days ago dreamwing dreamwing [347792] docs: correct credit for @斯图超哥 to Twitter link
 README_CN.md 2 days ago dreamwing dreamwing [347792] docs: correct credit for @斯图超哥 to Twitter link
 SKILL.md 3 days ago dreamwing dreamwing [d0c552] fix: expand SKILL.md with full capability discl...
 clawbridge-dashboard.service 6 days ago Winglet Winglet [67ddf8] refactor(rename): standardize naming to 'clawbr...
 clawbridge-tunnel.service 6 days ago Winglet Winglet [67ddf8] refactor(rename): standardize naming to 'clawbr...
 index.js 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 install.sh 2 days ago dreamwing dreamwing [b67ab9] fix(script): resolve sed empty suffix parsing b...
 jest.config.js 3 days ago dreamwing dreamwing [73e071] test: add Jest testing, ESLint, Prettier, and C...
 package-lock.json 2 days ago dreamwing dreamwing [25c64d] chore(release): bump version to 1.1.1 for linux...
 package.json 2 days ago dreamwing dreamwing [25c64d] chore(release): bump version to 1.1.1 for linux...
 setup.sh 2 days ago dreamwing dreamwing [141e5a] fix(setup): robust IP detection, quick tunnel r...
 tunnel.js 4 days ago dreamwing dreamwing [d86110] fix: security hardening, error handling, portab...

Read Me

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:
    bash 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).

MIT License. Built for the OpenClaw Community.

MongoDB Logo MongoDB