<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
</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
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
- Installs the ClawBridge Node.js app from GitHub into
skills/clawbridge/
- Generates a random
ACCESS_KEY and writes it to .env
- Registers a user-level systemd service for auto-start
- Optionally downloads
cloudflared and configures a tunnel for remote access
Installation
curl -sL https://raw.githubusercontent.com/dreamwing/clawbridge/master/install.sh | bash
See README.md for full documentation.