🦞 CLAW Agent 智控驾驶舱#

Coding Plan Edition · 专为 OpenClaw Coding Plan 订阅用户打造

产品简介#

CLAW Agent 智控驾驶舱是面向 OpenClaw Coding Plan 订阅用户的一站式运维监控平台，集额度管控、智能预测、Agent 状态监控、资源分析、定时任务管理于一体，帮助用户在有限的 API 额度内高效运营多 Agent 团队。

核心亮点#

• 🎓 自学习预测 — 根据实际数据自动校准预测参数，越用越准
• 📊 实际 vs 预测 — 双轨对比，一眼看清消耗趋势和偏差
• 🚨 四级告警 — 正常→关注→警告→危险，提前预警超额风险
• 🧠 Token 透视 — 各 Agent 资源消耗全景分析
• ⏰ Cron 可控 — 页面直接管理定时任务频率和开关
• 🦞 订阅倒计时 — 实时天/时/分/秒倒计时 + 进度条 + 四级颜色提醒 + 一键续订
• 💰 零额外消耗 — 本地数据追踪，不浪费 API 调用

---

快速部署#

1. 复制资源文件到工作区#

bash

cp -r assets/dashboard/* "$OPENCLAW_WORKSPACE/"

2. 安装 PM2（如未安装）#

bash

npm install -g pm2

3. 启动服务#

bash

cd "$OPENCLAW_WORKSPACE" && pm2 start ecosystem.config.js

4. 打开驾驶舱#

text

http://localhost:8888/agent-dashboard.html

---

配置说明#

编辑 quota-data.json 匹配你的 Coding Plan：

配置项说明示例config.monthlyQuota月度 API 调用上限18000config.billingCycleStart计费周期开始日期"2026-04-11"config.billingCycleEnd计费周期结束日期"2026-05-11"

---

操作手册#

📝 填写实际额度（核心操作）#

1. 登录阿里云控制台，查看 Coding Plan 当前已用次数
2. 在页面 "📝 实际已用" 输入框中填入数字
3. 点击 "保存"

效果：

• 环形图和告警基于实际值更新
• 对比表显示实际 vs 预测偏差
• 系统自动学习，校准预测参数
• 建议每天填 1 次，越频繁预测越准

🚨 告警等级说明#

等级触发条件颜色建议操作正常预估月末 ≤70%🟢无需操作关注预估月末 >70%🔵关注趋势警告预估月末 >85%🟡减少非必要调用危险预估月末 >100%🔴立即节流！

⏰ 管理 Cron 任务#

1. 找到 "⏰ Cron 定时任务管理" 区域
2. 开关控制启用/禁用
3. 下拉框调整频率
4. 修改后点击 "保存并生效"

🧠 分析 Agent 消耗#

• 柱状图：哪个 Agent 消耗最多
• 饼图：各 Agent 占比分布
• 针对高消耗 Agent 优化策略

🤖 Agent 状态说明#

状态含义🟢 正常任务进行中🔵 休息任务完成，≤24h 未活动🟠 待业≥24h 但 <7天 未活动🔴 失联≥7 天未活动

🦞 订阅到期倒计时#

页面顶部显示 Lite 订阅套餐的到期倒计时：

• 大字显示剩余天数 + 时:分:秒实时跳动
• 进度条显示订阅剩余比例
• 四级颜色提醒：🟢 >14天安全 → 🔵 714天注意 → 🟡 37天警告 → 🔴 ≤3天紧急
• 🔄 续订按钮：点击弹出确认弹窗，确认后自动延长 30 天
• 到期日、总天数、进度条随续订自动更新

---

自学习预测原理#

text

用户填入实际值
  → 系统对比同期 Token 增量
  → 反推 tokensPerCall 参数
  → EMA 指数平滑更新（α=0.4）
  → 下次预测使用校准后参数
  → 填得越多，预测越准

---

数据更新机制#

数据更新方式频率API 消耗Agent 状态Cron 自动每 3 小时2-3 次/轮Token 追踪本地计算每 3 分钟0（零消耗）预测值本地计算每 3 分钟0（零消耗）实际值手动填入建议每天 1 次0（零消耗）

---

Cron 配置#

部署后需创建数据更新 Cron，详见 references/cron-setup.md。

文件说明#

文件用途agent-dashboard.html驾驶舱主页面agent-api.jsAPI 服务 (port 8889)update-agent-data.jsAgent 数据更新器quota-tracker.js自学习额度预测器ecosystem.config.jsPM2 服务配置agent-data.jsonAgent 状态数据quota-data.json额度追踪数据

故障排查#

• 页面空白 → pm2 list 检查服务状态
• 无数据 → 确认 agent-data.json 存在且格式正确
• 预测不动 → 填入实际值触发校准
• PM2 未找到 → npm install -g pm2

---

🦞 CLAW Agent 智控驾驶舱 v1.1 · Powered by OpenClaw