Bot状态API服务

技能简介

Bot Status API 是一个可配置的HTTP服务，将OpenClaw机器人的运行状态以JSON格式暴露出来，方便接入监控面板或自建状态页面。

业务背景

Bot状态API服务为运维团队提供轻量化的机器人健康监控能力。无需复杂部署，即可实时掌握OpenClaw机器人的在线状态、模型版本、资源消耗及运行时长，同时自动采集系统指标并检测关键依赖服务的可用性，帮助团队快速定位故障、预防服务中断，保障业务连续性。

落地案例：某团队将Bot状态API接入内部运维看板：配置文件中定义了核心业务接口的HTTP检测和关键日志文件的存在性检查，服务启动后暴露/status端点统一返回机器人状态、技能清单及CPU/内存指标。运维人员通过反向代理限定内网访问，每日巡检时一目了然掌握全链路健康度，及时发现模型版本异常或磁盘空间不足等潜在风险。

能做什么

• 展示机器人核心状态：在线情况、模型版本、上下文用量、运行时长
• 检测任意HTTP端点、CLI命令或文件路径的健康状况
• 读取未读邮件数量（支持himalaya、gog等）
• 列出已安装的OpenClaw技能清单
• 采集CPU、内存、磁盘等系统指标
• 自动识别本地运行的开发服务器进程

使用说明

安装步骤：

1. 复制 server.js、collectors/ 目录及 package.json 到目标位置
2. 复制 config.example.json 为 config.json，填写端口、工作区路径、服务列表等配置
3. 执行 node server.js 启动服务
4. 可选：配置systemd用户服务实现开机自启与后台驻留

配置示例：在 config.json 中定义 services 数组，支持http/command/file-exists三种检测类型。

持久化运行：

systemctl --user daemon-reload
systemctl --user enable --now bot-status
loginctl enable-linger $USER

输入与输出

见下方输入与输出表格。

风险提示

• 配置文件包含文件系统路径信息，注意权限控制
• HTTP端点检测可能暴露内部服务地址
• 建议通过反向代理添加访问认证，避免直接暴露公网
• 缓存机制下数据存在秒级延迟，不适用于实时告警场景

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/suspect80/bot-status-api/SKILL.md
来源类型：GitHub仓库