OpenClaw Dashboard

OpenClaw Dashboard 是为 OpenClaw AI 代理框架设计的本地监控仪表盘，采用零依赖架构（前端纯 HTML/CSS/JS 单文件 ~1160 行，后端 Python stdlib ~400 行）。

核心功能#

11 个仪表盘面板：

• Header Bar：Bot 名称、在线/离线状态、自动刷新倒计时、主题选择器
• Alerts Banner：智能告警（高成本、cron 失败、高上下文占用、gateway 离线）
• System Health：Gateway 状态、PID、运行时间、内存、压缩模式、活跃会话数
• Cost Cards：今日成本、总成本、月度预估、成本分布甜甜圈图
• Token Usage & Cost：按模型分层的 token 与成本（7d/30d/全时间）
• Cron Jobs：定时任务状态、调度、上次/下次运行时间、模型
• Active Sessions：最近会话（模型、类型标签、上下文 %、tokens）
• Sub-Agent Activity：子代理运行记录（成本、时长、状态、token 分解）
• Charts & Trends：成本趋势线图、模型成本柱状图（纯 SVG）
• Bottom Row：可用模型网格、技能列表、Git 日志
• AI Chat：自然语言查询仪表盘数据

关键特性：

• 6 种内置主题（3 深色 + 3 浅色，19 CSS 变量可自定义）
• 智能刷新：按需刷新 + 可配置自动刷新（默认 30 秒防抖）
• 5 级模型解析链确保真实模型名
• 本地优先，无云依赖

安装部署#

环境要求：Python 3.6+、OpenClaw 安装于 ~/.openclaw、现代浏览器、macOS 10.15+ / Linux (Ubuntu 18.04+, Debian 10+)

一键安装：

curl -fsSL https://raw.githubusercontent.com/mudrii/openclaw-dashboard/main/install.sh | bash

手动安装：

git clone https://github.com/mudrii/openclaw-dashboard.git ~/.openclaw/dashboard
cd ~/.openclaw/dashboard
cp examples/config.minimal.json config.json
python3 server.py &

配置说明#

config.json 主要配置项：

• bot.name / bot.emoji：Bot 显示名称和图标
• theme.preset：主题预设（nord 等）
• refresh.intervalSeconds：刷新间隔
• server.port / server.host：服务端口和绑定地址
• ai.enabled / ai.gatewayPort：AI Chat 功能配置
• alerts：告警阈值（日成本、上下文占用、内存）

配置优先级：CLI flags > 环境变量 > config.json > 默认值

架构要点#

数据流水线：Browser → server.py → refresh.sh → data.json（原子写入）

API 端点：

• GET /api/refresh：刷新并返回仪表盘数据 JSON
• POST /api/chat：AI 自然语言查询

数据来源：openclaw.json、agents//sessions/.jsonl、cron/jobs.json、进程表

安全注意#

• 默认绑定 127.0.0.1（仅本地）
• LAN 模式无内置认证
• 无 HTTPS，需反向代理实现 TLS
• data.json 包含敏感数据