# Send Agent Dashboard to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agent-dashboard",
    "name": "Agent Dashboard",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/tahseen137/agent-dashboard",
    "canonicalUrl": "https://clawhub.ai/tahseen137/agent-dashboard",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-dashboard",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-dashboard",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "assets/push-dashboard.sh",
      "assets/templates/dashboard-data.json",
      "assets/templates/setup-supabase.sql",
      "assets/tier1-canvas.html",
      "assets/tier2-github.html"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-dashboard",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T05:58:17.284Z",
      "expiresAt": "2026-05-06T05:58:17.284Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-dashboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-dashboard",
        "contentDisposition": "attachment; filename=\"agent-dashboard-1.0.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-dashboard"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agent-dashboard"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agent-dashboard",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-dashboard",
    "agentUrl": "https://openagent3.xyz/skills/agent-dashboard/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-dashboard/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-dashboard/agent.md"
  }
}
```
## Documentation

### Mission Control 🚀

A real-time dashboard showing what your OpenClaw agent is doing, cron job health, issues requiring attention, and recent activity. Check it from anywhere — your phone, your laptop, wherever.

### Tier 1 — Canvas (Zero Setup) ⚡

No external services. The agent renders the dashboard directly in your OpenClaw session.

How to use:

Show me the mission control dashboard

The agent will:

Gather current state (active tasks, crons, etc.)
Generate a dashboard using the canvas tool
Present it inline in your session

That's it. No deploy, no accounts, nothing to configure.

### Tier 2 — GitHub Pages + Polling (Recommended) 🌐

Free hosting with 30-second auto-refresh. Takes 2 minutes to set up.

Setup:

Create a repo:
gh repo create mission-control --public --clone
cd mission-control



Copy the dashboard:
mkdir -p data
# Copy tier2-github.html to index.html
# Copy assets/templates/dashboard-data.json to data/



Edit index.html:

Change YOUR_PIN_HERE to your chosen PIN



Enable GitHub Pages:

Go to repo Settings → Pages
Source: Deploy from branch main
Folder: / (root)



Deploy:
git add -A && git commit -m "Initial deploy" && git push

Your dashboard is now live at https://YOUR_USERNAME.github.io/mission-control/

### Tier 3 — Supabase Realtime + Vercel (Premium) ⚡🔥

True websocket realtime — updates appear in under 1 second.

Prerequisites:

Supabase account (free tier works)
Vercel account (free tier works)

Step 1: Create Supabase Table

In your Supabase SQL Editor, run assets/templates/setup-supabase.sql.

Step 2: Get Your Keys

From Supabase Dashboard → Settings → API:

Copy SUPABASE_URL (Project URL)
Copy SUPABASE_ANON_KEY (anon public key)

That's it — no service_role key needed. The anon key handles both reads (dashboard) and writes (push script) via table-specific RLS.

Step 3: Edit the Dashboard

In tier3-realtime.html:

Replace YOUR_SUPABASE_URL with your project URL
Replace YOUR_SUPABASE_ANON_KEY with your anon key
Replace YOUR_PIN_HERE with your chosen PIN

Step 4: Deploy to Vercel

mkdir mission-control && cd mission-control
# Copy tier3-realtime.html as index.html
vercel deploy --prod

Step 5: Configure Push Script

export SUPABASE_URL="https://YOUR_PROJECT.supabase.co"
export SUPABASE_ANON_KEY="eyJ..."  # Same anon key used by the dashboard

### 🔄 Keeping It Fresh — Auto-Update Mechanism

The dashboard updates itself automatically. Here's how:

### 1. Cron Auto-Update (Every 30 Minutes)

Set up a cron job that collects data from OpenClaw APIs and pushes it:

Create a cron job called "Dashboard Update" that runs every 30 minutes.
It should:
1. Run \`cron list\` to get all cron job statuses, error counts, last run times
2. Run \`sessions_list\` to find any active sub-agents and their current tasks
3. Build the dashboard JSON from this API data
4. Push to Supabase (or git push for Tier 2)

Data sources: Only OpenClaw built-in APIs (cron list, sessions_list). No local files are read. Action items and recent activity are added manually via the "Manual Update" command below.

Sample cron configuration:

name: Dashboard Update
schedule: "*/30 * * * *"  # Every 30 minutes
model: sonnet             # Fast model for quick updates
prompt: |
  Update the Mission Control dashboard:
  
  1. Run \`cron list\` to get job names, statuses, error counts, last run times
  2. Run \`sessions_list\` to find active sub-agents and their tasks
  3. Build JSON matching the dashboard schema from API data only
  4. Push to Supabase or GitHub
  
  Do not read local files. Only use cron list and sessions_list data.

### 2. Real-Time Event Pushes

Beyond the periodic cron, the agent pushes updates immediately when significant events happen:

✅ Task starts or finishes
❌ Errors or failures
🚀 Deploys complete
📧 Important notifications arrive

This means the dashboard reflects changes within seconds, not just every 30 minutes.

How to enable: When you start a major task, tell the agent:

After this deploy finishes, push an update to Mission Control.

### 3. Force Update Button

Every dashboard tier includes a 🔄 Update button in the header:

Tier 2: Re-fetches dashboard-data.json immediately
Tier 3: Re-fetches from Supabase immediately
Resets the "Updated X ago" timer
Shows loading spinner while fetching

Use this when you want to confirm the latest state without waiting for auto-refresh.

### The Result

The combination of periodic cron + real-time pushes + manual refresh keeps your dashboard accurate at all times. You'll always see what your agent is actually doing.

### 🚨 Action Required

Urgent items that need your attention. Highlighted at the top with priority badges (high/medium/low).

### ⚡ Active Now

What the agent is currently working on, with model name and duration.

### 📊 Products

Your product cards with live/testing/down status badges.

### ⏰ Cron Jobs

Table showing all scheduled jobs with status, last run time, and error counts. Click to expand error details.

### 📋 Recent Activity

Timeline of recent events and accomplishments.

### 🔴 Live Indicator (Tier 3 only)

Green pulsing dot shows websocket is connected. Flash animation when data updates.

### Requirements by Tier

TierTools NeededExternal AccountsEnv VarsTier 1NoneNoneNoneTier 2git, gh CLIGitHub (free)DASHBOARD_PINTier 3curlSupabase (free), Vercel (free)See below

### Environment Variables

VariableRequiredTierPurposeDASHBOARD_PINNoAllPIN code for dashboard access (set directly in HTML config)SUPABASE_URLYesTier 3 onlyYour Supabase project URLSUPABASE_ANON_KEYYesTier 3 onlySupabase anon key — used for both dashboard reads AND push script writes

Tier 1 needs zero env vars. Tier 2 needs only a GitHub repo. Tier 3 needs only SUPABASE_URL and SUPABASE_ANON_KEY — no service_role key required.

### Permissions Used by OpenClaw

TierPermissionsWhyTier 1NoneCanvas is built into OpenClawTier 2execTo run git push to YOUR GitHub repoTier 3execTo run curl to YOUR Supabase project

No other permissions are used. No read permission needed — this skill does not access local files.

### Data Schema

The dashboard expects JSON in this format:

{
  "lastUpdated": "2024-01-15T12:00:00Z",
  "actionRequired": [
    {
      "title": "Review PR #42",
      "url": "https://github.com/you/repo/pull/42",
      "priority": "high"
    }
  ],
  "activeNow": [
    {
      "task": "Deploying new feature",
      "model": "opus",
      "startedAt": "2024-01-15T11:45:00Z"
    }
  ],
  "products": [
    {
      "name": "My App",
      "url": "https://myapp.example.com",
      "status": "live",
      "lastChecked": "2024-01-15T12:00:00Z"
    }
  ],
  "crons": [
    {
      "name": "Daily Report",
      "schedule": "9:00 AM daily",
      "lastRun": "2024-01-15T09:00:00Z",
      "status": "ok",
      "errors": 0,
      "lastError": null
    }
  ],
  "recentActivity": [
    {
      "time": "2024-01-15T11:30:00Z",
      "event": "✅ Deployed v2.1.0 to production"
    }
  ]
}

### Field Reference

FieldTypeDescriptionlastUpdatedISO-8601When data was last refreshedactionRequired[].priorityhigh|medium|lowUrgency levelproducts[].statuslive|testing|downProduct healthcrons[].statusok|error|pausedJob status

### Security & Privacy

This is an instruction-only skill — no executable code, no install scripts, no third-party dependencies.

### What This Skill Does and Doesn't Do

✅ Does❌ Doesn'tRender HTML dashboardsRead local files (no HEARTBEAT.md, no memory files, no source code)Push operational status to YOUR servicesSend data to third-party servicesRead OpenClaw APIs only (cron list, sessions_list)Store, log, or transmit credentialsUse YOUR Supabase/GitHub accountsRequire service_role or admin keys

### Exactly What Data Gets Pushed (Tier 2 & 3)

The dashboard pushes ONLY these fields — nothing else:

FieldExampleContains secrets?actionRequired[].title"Review PR #42"❌ NoactiveNow[].task"Deploying v2.0"❌ Noproducts[].name"My App"❌ Noproducts[].url"https://myapp.com"❌ No (public URLs only)products[].status"live"❌ Nocrons[].name"Daily Report"❌ Nocrons[].status"ok" / "error"❌ Nocrons[].lastError"timeout after 30s"❌ No (error messages only)recentActivity[].event"✅ Deployed v2.1"❌ No

Never pushed: passwords, API keys, tokens, file contents, database credentials, user data, or PII. The agent builds the JSON from operational status only — task names, timestamps, and status codes.

### What Data the Agent Reads

The auto-update cron uses ONLY OpenClaw built-in APIs:

SourceWhat it extractsSensitive?cron list (OpenClaw API)Job names, status, error counts❌ Nosessions_list (OpenClaw API)Active task labels, models❌ No

No local files are read. The cron does not access HEARTBEAT.md, memory files, source code, or any other files on disk. Action items and recent activity are added manually by the user via the "Manual Update" command.

### No Service Role Key Required

This skill does NOT require a Supabase service_role key. The anon key handles both reads and writes via table-specific RLS:

The dashboard_state table allows anon SELECT and UPDATE (via RLS policy)
The anon key can ONLY read/write this single table — it cannot access any other tables
Worst case if someone gets your anon key: they can overwrite dashboard status data (not sensitive)
The anon key is the same one already embedded in your client-side Supabase app

### Row Level Security (Tier 3)

The provided SQL (setup-supabase.sql) configures table-specific RLS:

SELECT: Allowed for anon — dashboard can read status
UPDATE: Allowed for anon on dashboard_state table only — push script can update status
Other tables: Unaffected — the anon key's existing RLS policies on all other tables remain unchanged
No DELETE: Anon cannot delete the dashboard row

### PIN Protection — Limitations

The client-side PIN prevents casual access, NOT determined attackers.

For stronger protection:

Tier 2: Make your GitHub Pages repo private (GitHub Pro)
Tier 3: Use Vercel's password protection (Pro plan) or add Supabase Auth
All tiers: The dashboard only contains operational status — no secrets to steal even if accessed

### Files Included

agent-dashboard/
├── SKILL.md                      # This file
├── assets/
│   ├── tier1-canvas.html         # Lightweight canvas version
│   ├── tier2-github.html         # GitHub Pages + polling
│   ├── tier3-realtime.html       # Supabase Realtime version
│   └── push-dashboard.sh         # Push script for Tier 3
├── assets/templates/
│   ├── dashboard-data.json       # Sample data structure
│   └── setup-supabase.sql        # Supabase table setup
└── references/
    └── customization.md          # Theme and layout customization

### Dashboard shows "Disconnected" (Tier 3)

Check Supabase project is running
Verify anon key is correct
Ensure realtime is enabled on the table

### Data not updating (Tier 2)

Check GitHub Pages is enabled
Verify data/dashboard-data.json was pushed
Hard refresh the page (Ctrl+Shift+R)
Click the Force Update button to confirm data is stale

### PIN not working

PINs are case-sensitive
Check you're using the same PIN in HTML config

### Cron status not accurate

Ensure your Dashboard Update cron is running (cron list)
Check for errors in the cron output
Manually run the update: "Update my Mission Control dashboard now"

### Credits

Built for the OpenClaw community. MIT License.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tahseen137
- Version: 1.0.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T05:58:17.284Z
- Expires at: 2026-05-06T05:58:17.284Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-dashboard)
- [Send to Agent page](https://openagent3.xyz/skills/agent-dashboard/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-dashboard/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-dashboard/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-dashboard)