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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/dreamwing--clawbridge)HTML
<a href="/listings/dreamwing--clawbridge"><img src="/api/listings/dreamwing--clawbridge/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 100 lines · 3 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <skill>
- <id>clawbridge</id>
- <name>ClawBridge Dashboard</name>
- <version>1.0.0</version>
- <description>Mobile-first mission control for OpenClaw agents. Runs as a local Node.js sidecar process, providing a web dashboard to monitor real-time agent activity, track token costs across 340+ models, and trigger cron tasks remotely. Optionally creates an outbound-only Cloudflare tunnel for remote access.</description>
- <author>DreamWing</author>
- <homepage>https://clawbridge.app</homepage>
- <license>MIT</license>
- <tags>dashboard,monitoring,mobile,ui,control-panel,cost-tracking,cloudflare,tunnel</tags>
- <!-- What this skill installs and runs -->
- <runtime>
- <type>node</type>
- <entrypoint>index.js</entrypoint>
- <persistence>Registers a user-level systemd service (clawbridge.service) that auto-starts on login and restarts on failure.</persistence>
- </runtime>
- <!-- System requirements -->
- <requires>
- <dependency name="node" version=">=18" required="true" />
- <dependency name="npm" version=">=9" required="true" />
- <dependency name="git" version="any" required="false" description="Used for incremental updates; falls back to tarball download if absent." />
- <dependency name="cloudflared" version="latest" required="false" description="Downloaded automatically from github.com/cloudflare/cloudflared if Cloudflare tunnel is enabled. Only required if using remote access without a VPN (Tailscale/WireGuard)." />
- </requires>
- <!-- Credentials / environment variables written to .env -->
- <credentials>
- <env name="ACCESS_KEY" description="Randomly generated 32-character hex key used to authenticate dashboard logins. Auto-generated on first install." required="true" generated="true" />
- <env name="PORT" description="Local TCP port the dashboard listens on. Defaults to 3000, auto-incremented if busy." required="false" default="3000" />
- <env name="TUNNEL_TOKEN" description="Cloudflare Tunnel token for a permanent named tunnel. Optional — omit to use a temporary Quick Tunnel instead." required="false" />
- <env name="ENABLE_EMBEDDED_TUNNEL" description="Set to 'true' when a Cloudflare tunnel (permanent or quick) is active." required="false" />
- <env name="OPENCLAW_PATH" description="Absolute path to the openclaw binary. Auto-detected from PATH; only written to .env if found." required="false" />
- </credentials>
- <!-- Network activity -->
- <network>
- <connection purpose="Dependency install" destination="registry.npmjs.org" direction="outbound" trigger="install/update" />
- <connection purpose="Source code download" destination="github.com/dreamwing/clawbridge" direction="outbound" trigger="install/update" />
- <connection purpose="cloudflared binary download" destination="github.com/cloudflare/cloudflared" direction="outbound" trigger="install (only if tunnel enabled and cloudflared not found)" />
- <connection purpose="Cloudflare Tunnel relay" destination="*.cloudflareaccess.com, *.trycloudflare.com" direction="outbound" trigger="runtime (only if tunnel enabled)" />
- <connection purpose="Dashboard UI" destination="localhost" direction="inbound" trigger="runtime" />
- </network>
- <!-- File system paths written or modified -->
- <filesystem>
- <path type="write" location="skills/clawbridge/.env" description="Stores ACCESS_KEY, PORT, and optional tunnel config." />
- <path type="write" location="skills/clawbridge/data/" description="Stores local agent log and token usage analytics." />
- <path type="write" location="~/.config/systemd/user/clawbridge.service" description="User-level systemd service unit for auto-start." />
- <path type="write" location="skills/clawbridge/cloudflared" description="cloudflared binary, only if downloaded during tunnel setup." />
- </filesystem>
- <!-- Installation — uses the script bundled in this repository -->
- <install>
- curl -sL https://raw.githubusercontent.com/dreamwing/clawbridge/master/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 54 on GitHub
- </install>
- <instructions>
- ClawBridge installs itself as a persistent background service.
- After installation, the dashboard is accessible at the local IP shown in the terminal output.
- An ACCESS_KEY is generated and displayed — keep it safe, it is required to log in.
- To enable remote access (optional), supply a Cloudflare Tunnel token when prompted,
- or leave it blank to use a temporary Quick Tunnel URL.
- To update to the latest version:
- curl -sL https://raw.githubusercontent.com/dreamwing/clawbridge/master/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 67 on GitHub
- To stop the service:
- systemctl --user stop clawbridge
- Full documentation: https://github.com/dreamwing/clawbridge/blob/master/README.md
- </instructions>
- </skill>
- # ClawBridge Dashboard
- **Your Agent. In Your Pocket.**
- ClawBridge is a lightweight, mobile-first web dashboard for OpenClaw. It runs as a local sidecar process and provides:
- * 🧠 **Live Activity Feed**: Watch agent execution and thinking in real-time via WebSocket.
- * 💰 **Token Economy**: Track costs across 340+ models with daily/monthly breakdowns.
- * 🚀 **Mission Control**: Trigger cron jobs manually from your phone.
- * 🔒 **Secure by Default**: API key auth, session cookies, and optional Cloudflare Tunnel for remote access.
- ## What This Skill Does
- 1. **Installs** the ClawBridge Node.js app from GitHub into `skills/clawbridge/`
- 2. **Generates** a random `ACCESS_KEY` and writes it to `.env`
- 3. **Registers** a user-level systemd service for auto-start
- 4. **Optionally downloads** `cloudflared` and configures a tunnel for remote access
- ## Installation
- ```bash
- curl -sL https://raw.githubusercontent.com/dreamwing/clawbridge/master/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 97 on GitHub
- ```
- See [README.md](https://github.com/dreamwing/clawbridge/blob/master/README.md) for full documentation.
README.md · README · 111 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="public/app-icon.png" width="120" alt="ClawBridge Logo" />
- <h1>ClawBridge Dashboard</h1>
- <p><strong>The OpenClaw Mobile Dashboard & Mission Control.</strong></p>
- <a href="https://clawbridge.app">
- <img src="https://img.shields.io/badge/Website-clawbridge.app-3b82f6?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Website" />
- </a>
- <a href="https://github.com/openclaw/openclaw">
- <img src="https://img.shields.io/badge/OpenClaw-Compatible-22c55e?style=for-the-badge&logo=robot-framework&logoColor=white" alt="OpenClaw" />
- </a>
- <a href="LICENSE">
- <img src="https://img.shields.io/badge/License-MIT-fab005?style=for-the-badge" alt="License" />
- </a>
- <br/><br/>
- [ <strong>English</strong> | <a href="README_CN.md">简体中文</a> ]
- </div>
- ---
- **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.
- * **🔍 [Cost Control Center](docs/cost-control-center.md)**: 10 automated diagnostics that scan your usage, calculate savings, and let you apply optimizations with one tap. Cut API costs by 30–90%.
- * **📜 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
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 42 on GitHub
- ```
- 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 [Cloudflare Dash \> Networking \> Tunnels](https://dash.cloudflare.com/?to=/:account/tunnels).
- 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`
- 3. After the installation is successful, go back to the Cloudflare Tunnel's **Public Hostname** (or **Routes**) page and click **Add a public hostname** to bind your own domain to `localhost:3000` for permanent access.
- ### 4. Docker (Containerized)
- You can run ClawBridge as a Docker container. The images are automatically published to the [GitHub Container Registry (ghcr.io)](https://github.com/dreamwing/clawbridge/pkgs/container/clawbridge).
- ```bash
- docker pull ghcr.io/dreamwing/clawbridge:latest
- docker run -d --name clawbridge \
- -p 3000:3000 \
- -e ACCESS_KEY=your_secret_key \
- -e OPENCLAW_STATE_DIR=/openclaw \
- -e OPENCLAW_WORKSPACE=/openclaw/workspace \
- -v ~/.openclaw:/openclaw:ro \
- -v ./data:/app/data \
- ghcr.io/dreamwing/clawbridge:latest
- ```
- ## 📱 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).
- - [@ForceConstant](https://github.com/ForceConstant) for valuable contributions in Feature Request: versioned docker images (#24) (Issue #24).
- ---
- *MIT License. Built for the OpenClaw Community.*
install.sh · Bundled script · 253 lines · 1 finding marked
- #!/bin/bash
- # ClawBridge Installer (Git + Tarball Fallback)
- # Usage: curl -sL https://raw.githubusercontent.com/dreamwing/clawbridge/master/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 4 on GitHub
- set -e
- echo "🌊 ClawBridge Installer"
- echo "-----------------------"
- # OS Detection
- OS_TYPE=$(uname -s)
- if [ "$OS_TYPE" = "Darwin" ]; then
- sed_inplace() { sed -i '' "$@"; }
- else
- sed_inplace() { sed -i "$@"; }
- fi
- # Default values
- TARGET_DIR="skills/clawbridge"
- [ "$(basename "$PWD")" == "clawbridge" ] && [ "$(basename "$(dirname "$PWD")")" == "skills" ] && TARGET_DIR="."
- # Arguments parsing
- PASSTHROUGH_ARGS=""
- EXTRACTED_TOKEN=""
- for arg in "$@"; do
- case $arg in
- --token=*)
- EXTRACTED_TOKEN="${arg#*=}"
- PASSTHROUGH_ARGS="$PASSTHROUGH_ARGS $arg"
- ;;
- *)
- PASSTHROUGH_ARGS="$PASSTHROUGH_ARGS $arg"
- ;;
- esac
- done
- if [ "$TARGET_DIR" == "." ]; then
- echo "📂 Detected execution from inside installation directory."
- else
- mkdir -p "$(dirname "$TARGET_DIR")"
- fi
- NEEDS_BUILD=true
- BACKUP_MSG=""
- # --- STRATEGY SELECTION ---
- if command -v git &> /dev/null; then
- INSTALL_MODE="git"
- echo "✅ Git detected. Using Git for incremental updates."
- else
- INSTALL_MODE="tarball"
- echo "⚠️ Git not found. Using Tarball download mode."
- fi
- # ==============================
- # STRATEGY A: GIT (Preferred)
- # ==============================
- if [ "$INSTALL_MODE" == "git" ]; then
- if [ -d "$TARGET_DIR" ]; then
- echo "ℹ️ Updating existing installation..."
- cd "$TARGET_DIR"
- # Stash local changes
- git stash >/dev/null 2>&1 || true
- echo "⬇️ Fetching updates..."
- git fetch --all --tags --force --prune
- # Find latest tag
- LATEST_TAG=$(git tag -l "v*" | sort -V | tail -n1)
- if [ ! -z "$LATEST_TAG" ]; then
- CURRENT_TAG=$(git describe --tags --exact-match 2>/dev/null || echo "none")
- if [ "$CURRENT_TAG" == "$LATEST_TAG" ]; then
- echo "✅ Already on latest version ($LATEST_TAG). Skipping update."
- NEEDS_BUILD=false
- else
- echo "🔖 Found new version: $LATEST_TAG (Current: $CURRENT_TAG)"
- echo "🔄 Switching to release $LATEST_TAG..."
- git checkout "tags/$LATEST_TAG"
- fi
- else
- echo "⚠️ No release tags found. Using master branch..."
- git checkout master
- git pull origin master
- fi
- cd - > /dev/null
- else
- echo "⬇️ Cloning repository..."
- mkdir -p skills
- git clone https://github.com/dreamwing/clawbridge.git "$TARGET_DIR"
- cd "$TARGET_DIR"
- # Post-clone: Checkout tag
- LATEST_TAG=$(git tag -l "v*" | sort -V | tail -n1)
- if [ ! -z "$LATEST_TAG" ]; then
- echo "🔖 Checkout release $LATEST_TAG..."
- git checkout "tags/$LATEST_TAG"
- fi
- cd - > /dev/null
- fi
- # ==============================
- # STRATEGY B: TARBALL (Fallback)
- # ==============================
- else
- # 1. Determine Latest Version (via Redirect)
- echo "🔍 Checking latest version..."
- # Hack to get latest tag from GitHub redirect without API rate limits
- LATEST_URL=$(curl -sL -o /dev/null -w %{url_effective} https://github.com/dreamwing/clawbridge/releases/latest)
- LATEST_TAG=$(basename "$LATEST_URL")
- if [[ "$LATEST_TAG" == "releases" ]]; then
- echo "⚠️ Could not determine latest tag. Defaulting to master."
- DOWNLOAD_URL="https://github.com/dreamwing/clawbridge/archive/refs/heads/master.tar.gz"
- VER_STRING="master"
- else
- DOWNLOAD_URL="https://github.com/dreamwing/clawbridge/archive/refs/tags/${LATEST_TAG}.tar.gz"
- VER_STRING="$LATEST_TAG"
- fi
- # 2. Check & Backup Existing
- TS=$(date +%Y%m%d_%H%M%S)
- if [ -d "$TARGET_DIR" ]; then
- # Check current version from package.json
- if [ -f "$TARGET_DIR/package.json" ]; then
- CURRENT_VER=$(grep '"version":' "$TARGET_DIR/package.json" | cut -d'"' -f4)
- else
- CURRENT_VER="unknown"
- fi
- BACKUP_DIR="skills/_backups"
- mkdir -p "$BACKUP_DIR"
- BACKUP_FILE="$BACKUP_DIR/clawbridge_v${CURRENT_VER}_${TS}.tar.gz"
- echo "📦 Backing up current version to $BACKUP_FILE..."
- # Ignore node_modules AND the backup folder itself
- PARENT=$(dirname "$TARGET_DIR")
- NAME=$(basename "$TARGET_DIR")
- tar --exclude='node_modules' --exclude='_backups' -czf "$BACKUP_FILE" -C "$PARENT" "$NAME"
- BACKUP_MSG="♻️ Previous version backed up to: $BACKUP_FILE"
- fi
- # 3. Download & Prepare Temp
- # Unique temp dir to prevent collisions
- TMP_DIR_NAME="clawbridge_${VER_STRING}_${TS}"
- TMP_DIR=$(mktemp -d -t "${TMP_DIR_NAME}.XXXXXX")
- echo "⬇️ Downloading $VER_STRING..."
- curl -sL "$DOWNLOAD_URL" | tar -xz -C "$TMP_DIR"
- # GitHub tarballs extract to 'clawbridge-1.0.0' or 'clawbridge-master'
- EXTRACTED_DIR=$(find "$TMP_DIR" -maxdepth 1 -type d -name "clawbridge-*" | head -n 1)
- # 4. Data Migration (Hot-Swap)
- if [ "$TARGET_DIR" == "." ]; then
- echo "♻️ Migrating configuration and data (In-Place)..."
- # When running inside target, we must copy config TO temp dir first
- # Because in step 5 we will overwrite current dir with temp dir content
- # Wait, the previous logic copied FROM target TO temp. That is correct.
- [ -f ".env" ] && cp ".env" "$EXTRACTED_DIR/"
- [ -d "data" ] && cp -r "data" "$EXTRACTED_DIR/"
- [ -f ".quick_tunnel_url" ] && cp ".quick_tunnel_url" "$EXTRACTED_DIR/"
- else
- if [ -d "$TARGET_DIR" ]; then
- echo "♻️ Migrating configuration and data..."
- [ -f "$TARGET_DIR/.env" ] && cp "$TARGET_DIR/.env" "$EXTRACTED_DIR/"
- [ -d "$TARGET_DIR/data" ] && cp -r "$TARGET_DIR/data" "$EXTRACTED_DIR/"
- [ -f "$TARGET_DIR/.quick_tunnel_url" ] && cp "$TARGET_DIR/.quick_tunnel_url" "$EXTRACTED_DIR/"
- rm -rf "$TARGET_DIR"
- else
- mkdir -p skills
- fi
- fi
- # 5. Final Move
- echo "🔄 Applying update..."
- if [ "$TARGET_DIR" == "." ]; then
- # Overwrite current dir with new content
- cp -rf "$EXTRACTED_DIR"/* .
- cp -rf "$EXTRACTED_DIR"/.[!.]* . 2>/dev/null || true
- else
- mv "$EXTRACTED_DIR" "$TARGET_DIR"
- fi
- rm -rf "$TMP_DIR"
- echo "✅ Code updated to $VER_STRING"
- NEEDS_BUILD=true
- fi
- # ==============================
- # COMMON: BUILD & LAUNCH
- # ==============================
- if [ "$NEEDS_BUILD" = true ]; then
- echo "📦 Installing dependencies..."
- cd "$TARGET_DIR"
- if [ -f "package-lock.json" ]; then
- npm ci --production --silent
- else
- npm install --production --silent
- fi
- else
- cd "$TARGET_DIR"
- echo "⏭️ Skipping dependency install (Version match)."
- fi
- # Run Setup
- echo "🚀 Configuring..."
- chmod +x setup.sh
- # Determine final arguments for setup.sh
- FINAL_ARGS="$PASSTHROUGH_ARGS"
- # If no token in args, but exists in .env, append it to FINAL_ARGS
- # Note: We've already cd'd into TARGET_DIR, so use .env directly
- if [ -z "$EXTRACTED_TOKEN" ] && [ -f ".env" ]; then
- ENV_TOKEN=$(grep "TUNNEL_TOKEN=" ".env" | cut -d'=' -f2)
- if [ ! -z "$ENV_TOKEN" ]; then
- echo "ℹ️ Found existing tunnel token in .env, reusing it..."
- FINAL_ARGS="$FINAL_ARGS --token=$ENV_TOKEN"
- fi
- fi
- # If after that we still don't have a token, and no explicit tunnel mode set, default to --quick
- # We check if FINAL_ARGS contains --token, --quick, or --no-tunnel
- if [[ ! "$FINAL_ARGS" == *"--token="* ]] && [[ ! "$FINAL_ARGS" == *"--quick"* ]] && [[ ! "$FINAL_ARGS" == *"--no-tunnel"* ]]; then
- echo "🌊 No tunnel mode specified, defaulting to Quick Tunnel..."
- FINAL_ARGS="$FINAL_ARGS --quick"
- fi
- # Log without exposing token
- SAFE_LOG=$(echo "$FINAL_ARGS" | sed 's/--token=[^ ]*/--token=****/g')
- echo "✅ Running setup: ./setup.sh $SAFE_LOG"
- ./setup.sh $FINAL_ARGS
- # Final Notification
- if [ ! -z "$BACKUP_MSG" ]; then
- echo ""
- echo "$BACKUP_MSG"
- fi
- echo ""
- echo "✅ [Agent Notice] Update successfully completed. The dashboard service has been restarted."
- echo "👉 Please verify the version on the dashboard and inform the user."
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.