Install
openclaw skills install @thcjp/ops-dashboard运维看板(专业版)
全功能实时运维监控看板，支持成本分析、变更操作、告警通知与审计日志。运维看板专业版是面向团队和企业的完整运维监控方案，在免费版基础上解锁成本分析与用量统计、变更操作与备份管理、告警通知与自动。支持自动化配置和灵活的参数设置，适覆盖多种使用场景，优化工作流程和效率。运维看板专业版是面向团队和企业的完整运维监控方案，在免费版基础上解锁成本分析与用量统计、变更操作与备份管理、告警通知与自动 功能涵盖: ops, dashboard。
核心功能: 本技能提供自动化配置和灵活的参数设置、工作流程和效率等能力。
运维看板(专业版)
付费版进阶功能
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 运维看板(专业版)全功能实时运维监控 | 不支持 | 支持 |
| 运维看板(专业版)支持成本分析 | 不支持 | 支持 |
| 多渠道消息批量发送 | 不支持 | 支持 |
| 消息模板与变量注入 | 不支持 | 支持 |
| 送达状态实时回调 | 不支持 | 支持 |
功能能力
| 能力模块 | 专业版支持 | 说明 |
|---|---|---|
| 会话管理 | 全量 | 查看、终止、归档、批量清理 |
| 定时任务 | 全量 | 查看、执行、重试、禁用 |
| 成本分析 | 支持 | 用量统计、API费用、预算告警 |
| 健康监控 | 全量 | 网关健康、服务依赖、自动恢复 |
| 变更操作 | 支持 | 备份创建、模型切换、配置更新 |
| 告警通知 | 支持 | 阈值告警、邮件/Webhook通知 |
| 批量管理 | 支持 | 批量会话操作、检查点恢复 |
| 审计日志 | 支持 | 完整操作审计链、合规导出 |
| 安全扫描 | 全量 | 敏感数据深度扫描、配置审查 |
| 服务商审计 | 支持 | 调用AI服务商组织API获取用量 |
| 系统操作 | 支持 | 用户级systemctl重启控制 |
能力模块
会话管理
定时任务
应用场景
运维场景：成本监控与预算告警
追踪AI Agent的用量消耗和API费用，设置预算阈值，超支时自动告警：
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/cost/summary
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/cost/by-session
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"monthly_budget": 500, "alert_threshold": 0.8}' \
http://localhost:3000/api/cost/budget
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
"http://localhost:3000/api/cost/trend?period=monthly"
管理场景：批量会话清理
定期清理过期会话，释放系统资源：
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/sessions?status=all
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"action": "archive", "older_than_days": 7}' \
http://localhost:3000/api/sessions/batch
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"action": "terminate", "status": "error"}' \
http://localhost:3000/api/sessions/batch
故障恢复场景：定时任务重试
定时任务执行失败时，通过看板触发重试并检查结果：
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
"http://localhost:3000/api/cron?status=failed"
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"task": "daily-report"}' \
http://localhost:3000/api/cron/run-now
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/cron/history/daily-report
合规场景：审计日志导出
导出完整操作审计日志，用于合规审查：
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
"http://localhost:3000/api/audit/logs?start=2026-01-01&end=2026-01-31"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
"http://localhost:3000/api/audit/export?format=json" > audit-report.json
操作步骤
前置条件
- Node.js 18+ 已安装
- 运维看板服务已部署并运行
- 已设置
DASHBOARD_AUTH环境变量
环境配置
创建.env文件配置完整运行参数：
DASHBOARD_PORT=3000
DASHBOARD_HOST=localhost
DASHBOARD_AUTH=your_auth_here
DASHBOARD_CORS_ORIGINS=http://localhost:3000
OPS_DASHBOARD_LOAD_KEYS_ENV=0
OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=0
OPS_DASHBOARD_ENABLE_CONFIG_ENDPOINT=0
OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=0
OPS_DASHBOARD_ENABLE_MUTATING_OPS=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_FILEPATH_COPY=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_TMP=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_WORKSPACE=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_HOME=0
依赖说明
运行环境
- Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- 操作系统：Windows / macOS / Linux（系统级操作需Linux）
- Node.js：18.0及以上版本
- 运行时：运维看板服务需持续运行
第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Node.js | 运行时 | 必需 | 从Node.js官网下载安装 |
| Express | npm包 | 必需 | 通过npm install express安装 |
| curl | 命令行工具 | 必需 | 系统通常自带 |
| OpenAI API Key | API凭证 | 可选 | 服务商审计功能需要 |
| Anthropic API Key | API凭证 | 可选 | 服务商审计功能需要 |
| systemd | 系统服务 | 可选 | 系统重启功能需要（Linux） |
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
API Key 配置
- 运维看板Token：通过
DASHBOARD_AUTH环境变量配置 - 服务商API Key：存储在
keys.env文件中，需设置OPS_DASHBOARD_LOAD_KEYS_ENV=1加载 - 存储位置：所有密钥文件存储在项目根目录（已加入.gitignore）
- 禁止：在代码或配置文件中硬编码任何API Key或Token
- 安全建议：生产环境使用反向代理（如Nginx）添加额外的认证层
可用性分类
- 分类：MD+EXEC（纯Markdown指令，需要exec命令行执行能力）
- 说明：基于Markdown的AI Skill，通过自然语言指令驱动Agent执行运维看板全量API操作
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | ops-dashboard处理的内容输入 |
| strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal |
输出规范
{
"success": true,
"data": {
"overall_grade": "A",
"total_score": 92,
"max_score": 100,
"summary": "处理完成",
"details": [
{
"item": "代码风格",
"status": "pass",
"score": 95,
"comment": "符合规范"
},
{
"item": "安全合规",
"status": "warn",
"score": 80,
"comment": "符合规范"
}
],
"improvements": [
{
"priority": "high",
"suggestion": "建议优化",
"expected_gain": "+5分"
},
{
"priority": "medium",
"suggestion": "建议优化",
"expected_gain": "+3分"
}
]
},
"error": null
}
异常管理
| 症状 | 可能原因 | 解决方案 | 优先级 |
|---|---|---|---|
| API返回403 | 功能开关未启用 | 设置对应环境变量为1 | 高 |
| 成本数据为空 | 用量统计未上报 | 检查Agent配置，确保上报用量 | 高 |
| 变更操作无响应 | 操作队列积压 | 检查/api/audit/logs，等待执行 | 中 |
| 告警未触发 | 阈值设置不合理 | 检查告警规则和阈值配置 | 中 |
| 服务商审计失败 | API Key未配置 | 启用LOAD_KEYS_ENV并配置密钥 | 中 |
| 备份创建失败 | 磁盘空间不足 | 检查磁盘空间，清理旧备份 | 高 |
| 审计日志丢失 | 日志保留期过短 | 调整日志保留策略 | 低 |
| CORS请求被拒 | 来源不在白名单 | 添加来源到CORS_ORIGINS | 中 |
| 安全扫描超时 | 扫描范围过大 | 缩小扫描路径或分批扫描 | 低 |
| systemctl失败 | 权限不足 | 使用用户级服务，非root | 中 |
依赖说明(补充)
| 依赖项 | 类型 | 必需 | 说明 |
|---|---|---|---|
| LLM | 模型 | 是 | 需要LLM进行智能审查, 推荐GPT-4/智谱GLM-4/DeepSeek |
| API Key | 凭证 | 否 | 使用云端LLM时需要 |
| 国内替代方案: |
- OpenAI GPT → 智谱GLM-4 / 百度文心一言 / 通义千问 / DeepSeek
案例展示
安全防护体系
专业版提供四层安全防护，所有高敏感功能默认关闭，需通过环境变量显式启用：
DASHBOARD_AUTH=your_auth_here
DASHBOARD_CORS_ORIGINS=https://dashboard.example.com,https://ops.example.com
OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1 # 允许调用AI服务商API
OPS_DASHBOARD_ENABLE_CONFIG_ENDPOINT=1 # 暴露配置端点
OPS_DASHBOARD_ENABLE_MUTATING_OPS=1 # 允许变更操作
OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1 # 允许系统重启
OPS_DASHBOARD_ALLOW_ATTACHMENT_FILEPATH_COPY=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_TMP=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_WORKSPACE=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_HOME=1
成本分析与预算管理
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/cost/summary
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
"http://localhost:3000/api/cost/by-session?limit=50"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/cost/by-model
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{
"monthly_budget": 1000,
"alert_threshold": 0.8,
"alert_webhook": "https://hooks.example.com/alert"
}' \
http://localhost:3000/api/cost/budget
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
period=daily&days=30"
变更操作与备份
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"type": "full", "description": "变更前备份"}' \
http://localhost:3000/api/backup/create
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/backup/list
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"backup_id": "backup-001"}' \
http://localhost:3000/api/backup/restore
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"model": "qwen2.5:7b"}' \
http://localhost:3000/api/ops/update-model
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"key": "temperature", "value": "0.3"}' \
http://localhost:3000/api/ops/update-config
告警通知配置
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/alerts/rules
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{
"name": "成本超支告警",
"metric": "cost",
"threshold": 800,
"operator": ">",
"webhook": "https://hooks.example.com/alert",
"enabled": true
}' \
http://localhost:3000/api/alerts/rules
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/alerts/history
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"alert_id": "alert-001", "action": "acknowledge"}' \
http://localhost:3000/api/alerts/acknowledge
审计日志与合规
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/audit/logs
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
start=2026-01-01&end=2026-01-31"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
format=json" > audit.json
服务商审计集成
export OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/provider/openai/usage
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/provider/anthropic/usage
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/provider/comparison
系统级操作
export OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{"service": "agent-service"}' \
http://localhost:3000/api/ops/systemctl-restart
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/ops/system-status
敏感数据深度扫描
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/security/scan
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
-H "Content-Type: application/json" \
-d '{
"patterns": ["auth=", "API_CRED", "SENSITIVE", "PASSPHRASE", "COOKIE"],
"paths": ["./config", "./.env"]
}' \
http://localhost:3000/api/security/scan
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
http://localhost:3000/api/security/history
热门问题
Q1: 变更操作返回403禁止访问？
变更操作需启用OPS_DASHBOARD_ENABLE_MUTATING_OPS=1环境变量。该功能默认关闭以防误操作。启用后还需在请求中携带有效的认证凭证.
Q2: 成本数据为空或不准确？
成本追踪依赖于Agent会话的用量使用记录。确保Agent正确上报用量统计。服务商审计数据需启用OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1并配置服务商API Key.
Q3: 告警Webhook未收到通知？
检查Webhook URL是否可从服务端访问。测试网络连通性，确认Webhook服务正常响应。查看/api/alerts/history中告警记录的状态.
Q4: 服务商审计调用报错？
确保已设置OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1，且在keys.env文件中配置了服务商API Key。使用OPS_DASHBOARD_LOAD_KEYS_ENV=1加载密钥文件.
Q5: systemctl重启失败？
系统重启功能仅支持用户级服务（非root）。确保OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1已启用，且目标服务配置为用户级systemd服务.
Q6: 批量操作超时？
批量操作涉及大量会话时可能超时。建议分批执行，每批不超过100条。检查/api/audit/logs确认已完成的操作数量.
Q7: 审计日志占用磁盘过大？
配置日志保留策略，定期清理过期日志。通过/api/audit/export导出后归档，再清理服务端日志.
Q8: 备份恢复后配置不一致？
备份恢复会覆盖当前配置。建议在非高峰期执行恢复操作，并在恢复后验证关键配置项。恢复前先创建当前状态的备份.
Q9: 安全扫描误报如何处理？
安全扫描基于模式匹配，可能产生误报。将误报项添加到白名单配置中，后续扫描将跳过这些项.
Q10: 多人同时操作导致冲突？
专业版通过审计日志记录所有操作。建议团队制定操作规范，高峰期避免并发变更操作。关键操作使用检查点机制.
异常处理架构
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 请求重试；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |
技术创新
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 成本分析 | 2小时/月 | 15分钟/月 | 1小时45分钟/月 | 95% |
| 变更操作记录 | 1小时/周 | 10分钟/周 | 50分钟/周 | 98% |
| 告警通知处理 | 30分钟/次 | 5分钟/次 | 25分钟/次 | 100% |
| 批量会话管理 | 2小时/周 | 30分钟/周 | 1小时30分钟/周 | 100% |
| 审计日志审查 | 1小时/周 | 15分钟/周 | 45分钟/周 | 99% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 成本分析功能 | 实时、自动、可视化 | 逐项手动计算 | 需编写脚本，定期执行 | 需购买专业软件，配置复杂 |
| 变更操作管理 | 一键备份、模型切换、配置更新 | 手动备份、切换、更新 | 需编写脚本，操作复杂 | 需购买专业软件，配置复杂 |
| 告警通知 | 多渠道支持、模板化、变量注入 | 单一渠道、无模板、无变量 | 需编写脚本，定制化高 | 需购买专业软件，配置复杂 |
| 批量操作 | 一键执行、检查点恢复 | 手动逐个执行、无检查点 | 需编写脚本，操作复杂 | 需购买专业软件，配置复杂 |
| 审计日志 | 完整操作审计链、合规导出 | 手动记录、导出 | 需编写脚本，操作复杂 | 需购买专业软件，配置复杂 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 成本管理困难 | 运维成本难以追踪，预算控制困难 | 影响财务规划和资源分配 | 成本分析与预算告警 | 预算准确率提升至95% |
| 变更管理混乱 | 变更操作记录不完整，影响系统稳定性 | 影响系统正常运行和安全性 | 变更操作与备份管理 | 系统稳定性提升至99% |
| 告警处理不及时 | 告警信息处理不及时，可能导致故障扩大 | 影响系统可用性和业务连续性 | 告警通知与自动响应 | 故障响应时间缩短至5分钟/次 |
诊断与修复
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 成本分析数据错误 | 数据源错误、计算逻辑错误 | 检查数据源、验证计算逻辑 | 修正数据源或计算逻辑 |
| 变更操作记录缺失 | 备份失败、模型切换失败 | 检查备份日志、模型切换日志 | 重新执行备份或模型切换 |
| 告警通知失败 | 配置错误、服务不可用 | 检查配置文件、服务状态 | 修正配置或重启服务 |
| 批量会话操作失败 | 权限不足、网络问题 | 检查权限设置、网络连接 | 修正权限或解决网络问题 |
| 审计日志无法导出 | 权限不足、文件系统错误 | 检查权限设置、文件系统状态 | 修正权限或修复文件系统 |
安全责任声明
- [与「运维看板(专业版)」相关的安全注意事项]
- 确保API凭证安全，避免泄露。
- 定期更新系统，修复已知安全漏洞。
- 对敏感数据进行加密存储和传输。
- 限制访问权限，确保只有授权用户可以访问系统。
- 实施审计日志记录，以便于追踪和调查安全事件。
功能总览
- 自动化执行: 全功能实时运维监控看板，支持成本分析、变更操作、告警通知与审计日志。运维看板专业版是面向团队和企业的完整运维监控方案，在
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
用户疑问解答
Q1: 运维看板(专业版)支持哪些输入格式？
A1: 全功能实时运维监控看板，支持成本分析、变更操作、告警通知与审计日志。运维看板专业版是面向团队和企业的完整运维监控方案，在免费版基础上解锁成本分析与用量统计、变更。支持文本指令和结构化参数输入，具体格式参考使用流程章节。
Q2: 需要配置API Key吗？
A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。
Q3: 命令行执行失败怎么办？
A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。
核心功能特点
运维看板专业版是面向团队和企业的完整运维监控方案，在
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
实操说明
- 配置API凭证: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
核心属性
运维看板专业版是面向团队和企业的完整运维监控方案，在
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0