仪表板技能

为你的 Clawdbot 智能体构建并运行一个看板风格的任务管理仪表板。

概述

此技能创建一个本地 Web 仪表板，让你能够：
- 在看板中管理任务（待办 → 进行中 → 已完成 → 已归档）
- 实时监控智能体状态（在线/思考中/就绪）
- 为智能体留下便签，供其在心跳检查时查看
- 查看操作日志和快速访问交付成果

快速开始

运行安装脚本以安装并启动仪表板：

bash /path/to/skills/dashboard/setup.sh

或者让你的智能体运行它：

设置并启动我的 Clawdbot 仪表板

手动设置

1. 安装依赖项

# Ubuntu/Debian
apt-get install -y python3-flask python3-flask-cors

# 或使用 pip
pip3 install flask flask-cors

2. 创建仪表板目录

mkdir -p ~/clawd-dashboard/{templates,static/css,static/js,data}

3. 复制文件

从技能的 src/ 目录复制以下文件：
- app.py → ~/clawd-dashboard/
- templates/index.html → ~/clawd-dashboard/templates/
- static/css/style.css → ~/clawd-dashboard/static/css/
- static/js/dashboard.js → ~/clawd-dashboard/static/js/

4. 启动仪表板

cd ~/clawd-dashboard
python3 app.py

仪表板运行在 http://localhost:5050

配置

环境变量

自定义

编辑 app.py 以进行自定义：
- 交付成果：修改 get_deliverables() 函数以添加你自己的文件夹快捷方式
- 智能体 ID：如果你的智能体不叫 "clawd"，请更改 get_agent_status() 中的会话键模式

功能特性

看板

• 拖放任务在各列间移动
• 颜色编码的列（红色=待办，黄色=进行中，绿色=已完成，灰色=已归档）
• 点击编辑任意任务
• 任务持久化保存在 data/tasks.json

智能体状态

• 每 10 秒轮询一次 clawdbot status --json
• 显示：在线/离线、思考中/就绪状态
• 显示模型名称和令牌使用情况

便签区

• 为你的智能体添加指令
• 智能体可以在心跳检查时读取这些便签
• 保存到 data/notes.json

操作日志

• 跟踪任务的创建/移动/删除
• 所有操作都带有时间戳
• 最近 100 条记录存储在 data/action_log.json

作为服务运行

要在注销后保持仪表板运行：

# 使用 systemd（推荐）
cat > /etc/systemd/system/clawd-dashboard.service << 'EOF'
[Unit]
Description=Clawd 仪表板
After=network.target

[Service]
Type=simple
WorkingDirectory=/root/clawd-dashboard
ExecStart=/usr/bin/python3 app.py
Restart=always
Environment=CLAWD_WORKSPACE=/root/clawd

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable clawd-dashboard
systemctl start clawd-dashboard

安全须知

• 仪表板默认没有身份验证
• 仅在受信任的网络（本地主机、Tailscale、VPN）上运行
• 切勿在未添加身份验证的情况下将其暴露在公共互联网上

故障排除

"状态显示离线"

• 检查命令行中 clawdbot status --json 是否正常工作
• 确认智能体 ID 模式与你的设置匹配

"任务未保存"

• 检查 data/ 目录是否存在且可写
• 查看终端或 /tmp/dashboard.log 中的错误信息

"端口已被占用"

• 更改端口：运行 python3 app.py 然后编辑 app.run() 行
• 或者终止现有进程：pkill -f "python3 app.py"

文件参考

clawd-dashboard/
├── app.py                 # Flask 后端（API + 路由）
├── data/
│   ├── tasks.json         # 看板任务
│   ├── notes.json         # 给智能体的便签
│   └── action_log.json    # 活动历史
├── static/
│   ├── css/
│   │   └── style.css      # 深色主题样式
│   └── js/
│       └── dashboard.js   # 前端逻辑
└── templates/
    └── index.html         # 主页面模板

致谢

灵感来源于 Nate Herk 的 Clawdbot 视频中的 "Klaus Dashboard"。