核心用法
OpenClaw Dashboard Skill 是一套用于部署和管理 OpenClaw 实时运维仪表盘的完整解决方案，涵盖后端 API 服务 (api-server.js) 和前端交互界面 (agent-dashboard.html)。主要功能模块包括：
- 会话监控：实时追踪活跃会话状态与历史记录
- 成本分析：聚合 API 调用费用，支持多供应商成本核算
- 定时任务 (Cron)：可视化 cron 任务调度与执行日志
- 网关健康：24小时可用性条形图 (watchdog)，实时反映服务稳定性
- 双语界面：内置 EN/中文一键切换
典型使用场景
- 首次安装并启动仪表盘服务
- 为仪表盘添加新功能模块
- 更新后端路由逻辑或前端交互行为
- 调整环境配置与访问安全策略
显著优点
1. 安全优先设计：所有敏感操作默认禁用，需显式环境变量开启；CORS 默认限制本地回环，防泄漏机制完善
2. 最小化依赖：仅需 Node.js 与 OpenClaw 核心，无重型工具链
3. 分层权限控制：通过 OPENCLAW_AUTH_TOKEN、HttpOnly Cookie 与 query param 实现灵活认证
4. 防御性编程：路径操作含符号链接逃逸保护，子进程调用使用 execFileSync 避免 shell 注入
潜在缺点与局限性
- 功能边界保守：大量高阶功能（配置端点、附件跨目录复制、systemctl 重启等）默认关闭，需手动启用环境变量
- Tailscale 等外网暴露需额外配置：超出本地回环使用时必须设置
OPENCLAW_AUTH_TOKEN，否则存在未授权访问风险 - 无内置持久化数据库：依赖本地文件系统 (
~/.openclaw/) 存储状态，不适合多实例分布式部署
适合人群
- OpenClaw 系统管理员与 SRE 工程师
- 需要成本可视化的 AI 服务运营团队
- 注重数据隐私、倾向本地化部署的中小团队
- 对供应链安全有要求、希望避免云 SaaS 依赖的组织
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | `OPENCLAW_AUTH_TOKEN` 等环境变量若硬编码至代码库 | 强制使用 `process.env` 与占位符，提交前敏感字符串扫描 |
| 路径遍历 | 附件复制功能若误启用可能读取敏感目录 | 默认关闭，启用后含 `realpathSync` 二次校验 |
| SSRF/命令注入 | 任务 payload 被恶意构造 | 结构化 JSON 传输，禁用直接命令插值，使用数组参数执行 |
| 未授权访问 | 外网暴露时未设置认证令牌 | 文档强制要求设置 `OPENCLAW_AUTH_TOKEN`，CORS 非通配符限制 |