机器人状态

技能简介

Bot Status API 是一个可配置的 HTTP 服务，将 OpenClaw 机器人的运行状态以 JSON 格式对外暴露。

业务背景

运维团队需要实时掌握机器人运行健康度，但传统日志排查效率低。本API将分散的状态数据——在线情况、模型版本、资源占用、外部服务连通性——统一打包为标准化JSON，直接对接现有监控体系或自建看板，大幅降低故障定位时间，让非技术同事也能一眼看清系统全貌。

落地案例：某客服机器人团队每日晨会需人工登录服务器检查状态。接入本API后，他们在Grafana配置一个面板：左侧显示机器人是否在线及当前模型版本，中间用进度条展示上下文占用率，右侧列出邮件队列未读数与定时任务执行结果。运维人员刷新页面即可获取全部信息，无需再SSH到机器执行命令。

能做什么

• 展示机器人在线状态、模型版本、上下文占用率与运行时长
• 对任意 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 仓库

常见问题

Q1：机器人状态API 适合哪些场景？
A：适合需要「Bot Status API 是一个可配置的 HTTP 服务，将 Ope」的场景，尤其是希望快速验证并落地的团队与个人。

Q2：第一次使用应该先做什么？
A：先明确目标任务，再按照页面中的“能做什么”和“使用说明”完成最小可行流程。

Q3：如何判断是否值得长期使用？
A：建议连续使用 1-2 周，对比效率、稳定性和协作成本，再决定是否纳入长期工具栈。

替代方案

• 版本发布管理
• 智能自动更新器
• Pulse应用生成

相关推荐

• Perry隔离工作区
• Docker基础
• Bot状态API服务
• 数据库操作优化