2026 OpenClaw 观测实战:
租用 Mac Mini 上日志轮转、磁盘水位阈值与异常 Webhook 告警配置步骤
2026年3月25日
RunMini 技术团队
阅读时间:约 8 分钟
长期跑 OpenClaw与批处理在租用 Mac Mini上易因日志轮转与磁盘水位失控中断。本文含风险清单、轮转参数、阈值清理、Webhook 模板与FAQ。延展批处理磁盘、健康 Webhook;免登录购买。📊💾
痛点拆解
- 静默写满:stdout 与 OpenClaw 任务日志无上限,Mac Mini租盘不大时数天可打满。
- 阈值过晚:只在百分之零报错时才发现,批处理与快照已失败。
- 告警假阴性:Webhook在用户会话或网络策略下发不出,无人知晓异常。
① 风险清单
- 进程占用 inode,删文件空间不释放。
- 轮转过慢,高峰一日撑满剩余空间。
- Webhook 鉴权或网络策略导致告警不到达。
轮转方案对照(决策矩阵)
| 方案 | 适用 | 优点 | 注意 |
|---|---|---|---|
| newsyslog | 固定路径系统日志 | 系统周期执行 | 路径权限须对齐 |
| pm2-logrotate | Node 周边进程 | 按大小份数直观 | 模块与内存开销 |
| launchd 脚本 | 自定义业务目录 | 同用户上下文 | 自管截断信号 |
② 轮转策略参数
newsyslog:单文件五十至二百兆、保留七至三十份、按日或按大小先触发;路径对齐 OpenClaw 写入目录与权限。
pm2-logrotate:max_size 五十兆、retain 十四、compress 开。
launchd:定时跑脚本,超阈复制轮转或文档允许的 USR 信号。
③ 水位阈值与清理步骤
空闲阶梯:约百分之十五告警;约百分之十删最旧压缩日志与缓存;约百分之五暂停重写入并人工确认。
df -h与快照占用核对。- 轮转目录旧
.gz保留最近 N 份。 - 清理后再测空闲,未回升则升级 Webhook。
④ Webhook 告警模板
异常时 POST 固定字段 JSON 便于路由。
{
"source": "openclaw-macmini",
"severity": "warn",
"metric": "disk_free_percent",
"value": 12,
"threshold": 15,
"host": "rental-node-1",
"message": "磁盘空闲低于预警线"
}
同用户 curl 测 HTTP 码与 TLS。
落地步骤(≥5 步)
- 标定 OpenClaw 与批处理日志路径与父目录权限。
- 择矩阵方案配轮转并 reload 或装模块。
- 磁盘探针每五分钟写百分比,挂 launchd 或 cron。
- 接 Webhook 阶梯阈值,先 dry-run 再外发。
- 压测验证滚档曲线并写入运维手册。
可引用阈值建议
- 单日志五十至二百兆;保留七至三十份。
- 空闲百分之十五预警、百分之十清理、百分之五停写。
- 探针五分钟;清理前二次确认 df。
⑤ 排错 FAQ
轮转后空间不涨?
进程仍打开已删 inode,应使用支持 reopen 的轮转方式或对进程友好截断。
Webhook 偶发失败?
检查 TLS 证书、系统代理、对方限流;脚本内加重试与指数退避并落本地告警文件。
plist 与任务不同用户?
显式 UserName 与 WorkingDirectory,与 OpenClaw 启动上下文一致。