Bot 状态 API

一个可配置的 HTTP 服务，以 JSON 格式暴露你的 OpenClaw 机器人的运行状态。专为仪表盘集成、监控和透明度而设计。

提供内容

• - Bot 核心： 在线状态、模型、上下文使用情况、运行时间、心跳计时
• 服务： 对任意 HTTP 端点、CLI 工具或文件路径的健康检查
• 邮件： 来自任意邮件提供商（himalaya、gog 等）的未读邮件数
• 定时任务： 直接从 OpenClaw 的 cron/jobs.json 读取
• Docker： 通过 Portainer API 获取容器健康状态
• 开发服务器： 通过进程 grep 自动检测运行中的开发服务器
• 技能： 列出已安装和可用的 OpenClaw 技能
• 系统： 来自 /proc 的 CPU、内存、磁盘指标

设置

1. 复制服务文件

将 server.js、collectors/ 和 package.json 复制到你想要的位置。

2. 创建 config.json

将 config.example.json 复制为 config.json 并进行自定义：

json
{
port: 3200,
name: MyBot,
workspace: /path/to/.openclaw/workspace,
openclawHome: /path/to/.openclaw,
cache: { ttlMs: 10000 },
model: claude-sonnet-4-20250514,
skillDirs: [/path/to/openclaw/skills],
services: [
{ name: myservice, type: http, url: http://..., healthPath: /health }
]
}

服务检查类型

3. 运行

bash
node server.js

4. 持久化（systemd 用户服务）

ini

~/.config/systemd/user/bot-status.service

[Service]
Type=simple
WorkingDirectory=/path/to/bot-status
ExecStart=/usr/bin/node server.js
Restart=always
RestartSec=5
Environment=PORT=3200
Environment=HOME=/home/youruser
Environment=PATH=/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=default.target

bash
systemctl --user daemon-reload
systemctl --user enable --now bot-status
loginctl enable-linger $USER # 退出登录后保持运行

5. 来自 OpenClaw 的上下文/运行状态

机器人应定期将运行状态写入其工作空间中的 heartbeat-state.json：

json
{
vitals: {
contextPercent: 62,
contextUsed: 124000,
contextMax: 200000,
model: claude-opus-4-5,
updatedAt: 1770304500000
}
}

将此添加到你的 HEARTBEAT.md 中，以便机器人在每个心跳周期更新它。

端点

架构

• - 零依赖 — 仅使用 Node.js 内置模块（http、fs、child_process）
• 非阻塞 — 所有 shell 命令使用异步 exec，绝不使用 execSync
• 后台刷新 — 缓存按间隔刷新，请求始终从缓存即时响应（约 10ms）
• 配置驱动 — 所有内容在 config.json 中，无硬编码值