OpenCron

A visual dashboard for your OpenClaw cron jobs. See job statuses at a glance, track run history with outputs, and view scheduled runs on a calendar.

Features

• - Works with your existing OpenClaw cron jobs — zero config
• Live countdown timers to next run
• Auto-refreshes every 30 seconds
• Expandable job cards with schedule, duration, delivery status, and full prompt
• Run history tab with output summaries, model, token usage
• Calendar view showing past runs (ok/error) and upcoming scheduled runs
• Braille unicode progress animation on next-run banner
• Antimetal-inspired dark gradient UI with neon accents
• Secure: gateway token auth, no credentials exposed client-side
• Responsive layout, prefers-reduced-motion support

Quick Start

1. Deploy the dashboard

CODEBLOCK0

This fetches cron-dashboard.html from github.com/firstfloris/opencron and writes live cron-data.json.

2. Start the background sync

CODEBLOCK1

Keeps cron-data.json in sync with jobs.json every 30 seconds.

3. Open the dashboard

The dashboard is served via the nginx proxy on port ${CANVAS_PORT:-8090} — NOT the gateway port.

Get the server's public IP (not the container's internal IP):

CODEBLOCK2

Dashboard URL:

CODEBLOCK3

Important: Never use hostname -I — that returns the container's internal IP which is unreachable from outside.

Scripts

Serving Externally (Optional)

To access the dashboard from outside Docker, add an nginx reverse proxy. See nginx-canvas.conf.template for a production-ready config with:

• - Token validation via query parameter
• Rate limiting (10 req/s per IP)
• GET/HEAD only
• Path allowlisting
• Security headers (CSP, X-Frame-Options, no-referrer)
• Run log JSONL serving from INLINECODE16

Docker Compose snippet

CODEBLOCK4

Data Sources

• - Job definitions & state: /home/node/.openclaw/cron/jobs.json (read by gateway as cron-data.json)
• Run history: /home/node/.openclaw/cron/runs/<job-id>.jsonl (NDJSON, one entry per run)

After Every Cron Job Run

When a cron job finishes executing, always show the user the OpenCron dashboard link. Get the public IP via:

CODEBLOCK5

Then show:

CODEBLOCK6

Rules:

• - Use port ${CANVAS_PORT:-8090} (nginx proxy) — never the gateway port (18789)
• Use curl -s ifconfig.me for the IP — never hostname -I (that's the container's internal IP)
• Resolve all variables to actual values — never show placeholders to the user
• This should be the last line of output after every cron job execution

Demo

Open demo.html in any browser for a fully working demo with mock data — no server required.