机器人状态API

技能简介

Bot Status API 是一个可配置的 HTTP 服务，将 OpenClaw 机器人的运行状态以 JSON 格式对外暴露。它整合机器人核心状态、外部服务健康检查、邮件计数、定时任务、Docker 容器、开发服务器进程及系统资源等多维数据，方便接入监控面板或自建状态页面。

能做什么

• 展示机器人在线状态、模型版本、上下文占用率与运行时长
• 对任意 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/systemd/user/bot-status.service 写入单元文件，执行：

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

5. 心跳数据对接：在 HEARTBEAT.md 中配置机器人定期向 heartbeat-state.json 写入上下文使用率等生命体征。

输入与输出

见下方输入与输出表格。

风险提示

• 配置文件含敏感路径与 API 密钥，需限制文件权限（建议 600）
• 默认缓存 10 秒，高频请求不会穿透但数据存在延迟
• shell 命令类型检查若配置不当可能泄露系统信息
• systemd 用户服务随用户会话销毁，需启用 linger 才能后台常驻

来源信息

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