📊 OpenClaw 仪表盘截图技能#

创建时间： 2026-03-28 最后更新： 2026-03-28 技能位置： ~/.openclaw/workspace/skills/dashboard-screenshot/SKILL.md

---

🎯 触发词#

• "查看仪表盘"
• "仪表盘状态"
• "OpenClaw 仪表盘"
• "机器人状态"
• "dashboard"
• "截图仪表盘"
• "检查仪表盘并发送截图"

---

🔧 工作流程#

步骤 1：检查服务是否运行#

bash

curl -s -o /dev/null -w "%{http_code}" http://localhost:3000 2>/dev/null

说明：

• 检查端口 3000 是否响应
• 返回 200 → 服务已运行，跳至步骤 3
• 返回其他或未响应 → 继续步骤 2

---

步骤 2：启动仪表盘服务（如未运行）#

bash

cd ~/.openclaw/OpenClaw-bot-review && npm run dev

说明：

• 后台运行服务
• 等待 8 秒确保服务完全启动

工具调用：

json

{
  "exec": {
    "command": "cd ~/.openclaw/OpenClaw-bot-review && npm run dev",
    "background": true,
    "yieldMs": 8000
  }
}

---

步骤 3：打开浏览器#

工具调用：

json

{
  "action": "open",
  "url": "http://localhost:3000"
}

说明：

• 打开仪表盘页面
• 获取 targetId 用于后续操作

---

步骤 4：等待页面加载#

工具调用：

json

{
  "action": "snapshot",
  "targetId": "<targetId>",
  "timeoutMs": 5000
}

说明：

• 检查页面是否加载完成
• 确认显示机器人卡片、统计信息等

---

步骤 5：截取完整页面#

工具调用：

json

{
  "action": "screenshot",
  "targetId": "<targetId>",
  "fullPage": true,
  "type": "png"
}

说明：

• 截取完整滚动页面
• 截图自动保存到 ~/.openclaw/media/browser/<uuid>.png

---

步骤 6：发送截图给用户#

说明：

• 通过 QQbot 发送截图
• 附带关键状态说明（机器人状态、Token 用量、定时任务等）

---

📁 关键路径#

项目路径技能文档~/.openclaw/workspace/skills/dashboard-screenshot/SKILL.md项目目录~/.openclaw/OpenClaw-bot-review/package.json~/.openclaw/OpenClaw-bot-review/package.json截图保存~/.openclaw/media/browser/<uuid>.png

---

⚠️ 注意事项#

1. 服务自启动 - 如果端口 3000 未响应，自动执行 npm run dev
2. 等待时间 - 启动后等待 8 秒确保服务完全就绪
3. 页面加载 - 使用 snapshot 确认页面加载完成再截图
4. 完整页面 - 使用 fullPage: true 截取全部内容
5. 后台运行 - npm dev 进程后台运行，不阻塞后续操作
6. 浏览器状态 - 如果浏览器未打开或卡死，先重启浏览器
7. 错误处理 - 如果任何步骤失败，给出明确错误提示

---

✅ 成功标准#

• 端口检查通过或成功启动服务
• 浏览器成功打开且无错误
• 页面加载完成（snapshot 确认）
• 截图成功保存（返回 image data）
• 消息发送成功（无 error）
• 状态说明清晰完整

---

🐛 已知问题#

1. 网络问题 - 如果 clawhub 无法访问，无法通过 CLI 安装
2. 浏览器超时 - 如果页面加载缓慢，可能需要调整 timeoutMs
3. 端口占用 - 如果 3000 端口被占用，需要先清理

---

📊 响应模板#

text

📸 **OpenClaw 仪表盘截图完成！**

## 📊 仪表盘关键信息

**🤖 机器人状态：**
- **呆黄 (main)** - {状态}
  - 模型：{模型名称} ✅
  - 平台：{平台列表}
  - 会话数：{数量} | 消息数：{数量} | Token: {用量}
  - 最近活跃：{时间} | 平均响应：{时间}

- **小黄 (xiaohuang)** - {状态}
  - 模型：{模型名称} {状态}
  - 平台：{平台列表}
  - 会话数：{数量} | 消息数：{数量} | Token: {用量}
  - 最近活跃：{时间} | 平均响应：{时间}

**⏰ 定时任务：**
- {任务列表摘要}

**📈 全局统计：**
- 总 Input Token：{数量}
- 总 Output Token：{数量}
- 总消息数：{数量}

**🦞 Gateway：** {状态}
- 更新于：{时间}

---
Dashboard 已成功启动在 `http://localhost:3000`！🫡

---

此技能由呆黄创建并维护 最后更新：2026-03-28