Agent Dashboard

核心用法

Agent Dashboard 为 OpenClaw 用户提供三种监控层级，覆盖从即时会话到全球访问的全场景需求：

| 层级 | 部署方式 | 延迟 | 配置耗时 |

|:---|:---|:---|:---|

| **Tier 1** | 内置 Canvas 渲染 | 即时 | 0 秒 |

| **Tier 2** | GitHub Pages + 30 秒轮询 | ~30 秒 | 2 分钟 |

| **Tier 3** | Supabase Realtime + Vercel | <1 秒 | 10 分钟 |

用户只需说出「Show me the mission control dashboard」即可在 Tier 1 生成可视化面板；Tier 2/3 通过环境变量配置后，实现跨设备远程监控。面板集成「待处理事项」「当前任务」「Cron 健康度」「产品状态」「营收数据」五大模块，支持移动端适配。

显著优点

1. 隐私优先架构：核心数据始终驻留用户机器，Tier 1 完全不依赖外部服务，Tier 2/3 仅传输 JSON 状态数据而非敏感日志
2. 渐进式复杂度：从「一句话调出」到「企业级实时」，用户按需升级，无需一次性投入
3. 零侵入设计：技能本身不执行安装脚本，所有凭证通过环境变量注入，无硬编码风险
4. 开源可审计：MIT 协议，SQL/Shell/HTML 全模板化，用户可完全掌控数据流

潜在局限与风险

• PIN 保护强度有限：客户端校验仅防 casual access，非加密级身份验证；敏感场景建议叠加 GitHub/Vercel 原生鉴权
• Tier 3 依赖外部 SaaS：Supabase 免费额度有限，Vercel hobby plan 有带宽限制，大规模监控需成本评估
• Git 历史暴露风险：Tier 2 的 git push 会将 dashboard-data.json 纳入版本历史，虽无敏感密钥，但活动轨迹可被追溯
• RLS 配置责任：Supabase 的 Row Level Security 需用户自行验证，模板提供的策略是「公开读、服务密钥写」，误配可导致未授权写入

适合人群

• 需要随时掌握 AI agent 状态的开发者与运营者
• 运营多产品、多 Cron 任务的独立创始人/小团队
• 对数据主权敏感、希望避免第三方监控平台的企业用户
• 已使用 OpenClaw 生态、追求「单一 pane of glass」统一视图的进阶用户

常规风险提醒

• SUPABASE_SERVICE_KEY 泄露：该密钥拥有数据库全部写权限，务必仅配置于 OpenClaw 服务器环境变量，严禁提交至仓库或前端代码
• GitHub Pages 公开性：Tier 2 默认 public repo，dashboard URL 可被猜测访问；建议启用 private repo + GitHub 身份验证或更换为 Tier 3
• Cron 更新频率权衡：自动更新若设置过密（如每分钟），可能触发 GitHub API 限流或 Supabase 连接数上限

核心用法

Agent Dashboard 是专为 OpenClaw 设计的实时监控仪表板，提供三种部署层级满足不同场景需求：

Tier 1 — 零配置画布模式：无需任何外部服务，直接在 OpenClaw 会话中通过 Canvas 工具渲染仪表板。只需说出"Show me the mission control dashboard"，Agent 自动收集当前任务状态、定时任务健康度等数据并可视化呈现。

Tier 2 — GitHub Pages + 轮询（推荐）：2 分钟快速部署，利用 GitHub Pages 免费托管，30 秒自动刷新。Agent 通过 git push 更新 JSON 数据文件，适合需要远程查看的场景。

Tier 3 — Supabase Realtime + Vercel（高级）：真正的 WebSocket 实时更新，延迟低于 1 秒。利用 Supabase 的 Realtime 功能和 Vercel 边缘部署，适合对实时性要求极高的专业场景。

仪表板涵盖六大核心模块：紧急待办事项（Action Required）、当前活跃任务、产品状态监控、定时任务健康度、最近活动流水以及可选的收入数据。所有数据通过标准化 JSON Schema 交互，支持手动更新或定时自动同步。

显著优点

部署灵活性极佳：从完全离线的零配置方案到企业级实时架构，覆盖个人实验到生产监控全场景。用户可根据技术能力和安全需求自由选择，无需被锁定在单一供应商。

数据主权保障：核心设计理念强调"All data stays on your machine"，Tier 1 和 Tier 2 完全不依赖第三方云服务，敏感运营数据不会流经外部服务器。即使 Tier 3 使用 Supabase，也仅传输用户主动配置的仪表板状态，而非原始业务数据。

安全实践透明：无硬编码密钥、无安装脚本执行、凭证全走环境变量。Supabase 集成采用 Row Level Security 策略，严格区分 anon key（只读公开）和 service_role key（服务端写入），符合现代 SaaS 安全模型。

开源可审计：MIT 协议开源，代码结构清晰（3 个 HTML 文件、1 个 Shell 脚本、1 个 SQL 模板），无任何混淆或打包，社区可自行 fork 审查和定制。

潜在缺点与局限性

PIN 保护强度有限：当前的 PIN 校验为纯客户端 JavaScript 实现，PIN 以明文存在于 HTML 配置中，仅防"偶然访问"，无法抵御恶意分析或 XSS 提取。对于真正敏感的场景，需额外叠加 GitHub 私有仓库认证或 Cloudflare Access 等服务。

Tier 3 依赖外部 SaaS：虽然 Supabase 和 Vercel 提供免费层，但本质是将数据托管至第三方，存在服务条款变更、区域可用性或账户封禁的潜在风险。且 Supabase Realtime 的连接稳定性受网络环境影响，弱网环境下可能频繁断线重连。

无内置持久化存储：仪表板本身不存储历史数据，每次更新覆盖 JSON 文件。如需趋势分析或长期审计，需用户自行接入时序数据库。

功能聚焦单一：专注于"监控"场景，不包含告警通知（Webhook/邮件/短信）、权限分级管理（多用户/角色）或复杂的 APM 指标采集，不适合替代 Datadog、Grafana 等企业级监控平台。

适合的目标群体

• OpenClaw 重度用户：需要随时了解 Agent 执行状态、定时任务是否健康、有哪些紧急事项待处理的个人开发者或小团队。

• 追求数据隐私的独立开发者：希望监控运营数据但不希望接入复杂云服务、担心数据外泄的 privacy-conscious 用户。

• 技术爱好者与早期采用者：愿意尝试新兴 Agent 工具链，享受从 Tier 1 快速体验逐步升级到 Tier 3 完整架构的过程。

• 小型 SaaS 运营者：需要简单的 MRR 展示、产品状态页面和任务看板，但业务规模尚未达到需要专业运维平台的阶段。

使用风险与注意事项

性能风险：Tier 2 的 30 秒轮询在数据量大或 GitHub API 限速时可能延迟；Tier 3 的 WebSocket 连接在弱网环境会消耗额外重连资源。建议为高频更新场景设置合理的 debounce 策略。

依赖项风险：Tier 3 依赖 jsDelivr CDN 加载 Supabase SDK，存在 CDN 劫持或供应链攻击的理论可能；Supabase 服务本身也有可用性 SLA 约束（免费层无保障）。

配置泄露风险：SUPABASE_SERVICE_KEY 具有数据库完全写入权限，若误配置到客户端代码或泄露到日志，将导致数据被篡改。务必通过环境变量注入，避免出现在 shell 历史或代码仓库中。

长期维护风险：作为个人开发者（T3 来源）维护的社区项目，存在维护者精力转移、功能迭代停滞的可能性。生产环境使用建议 fork 后自行维护关键依赖版本。