MacLogin 云端 Mac 上的 OpenClaw 工作区磁盘垃圾回收:2026 年 4 月修剪手册,让网关在线且不删队列
当租用 Apple Silicon mini 上的 OpenClaw 网关开始超时,团队往往在真凶是 APFS 卷已满很久之后,还在指责“模型 API”。 2026 年 4 月实践:把磁盘当作队列依赖——先快照利用率,把目录分为安全修剪与高风险删除两类,用清单驱动修剪,并且仅在 openclaw doctor 显示绿色余量后再重启 launchd 任务。本手册列出热点路径、发布二元决策矩阵、编排八条操作步骤、把日志轮转与统一日志上限挂钩、在破坏性删除前强制状态备份,并以港日韩新美机队 FAQ 收尾。
请与 状态目录备份交接、doctor 诊断手册、以及激进清理缓存后的 npm 对等依赖重建 对照阅读。公开入口:帮助 与 定价。
在多团队共享的 MacLogin 租约上,磁盘压力常与“人类调试 + CI 插件 + 录屏排障”叠加。若不在周例会上公开热点路径表,每个人都会假设“别人会清缓存”,直到网关因无法写临时文件而拒绝 webhook。把磁盘当作一等指标后,你会更快发现:许多超时并不是模型慢,而是 fsync 在满盘上排队。
本手册假设读者已能登录租约并具备 sudo 或等价运维权限;若你在完全托管环境,请把本文当作与平台团队的共同语言,而不是私自递归删除的许可证。任何删除前,请确认工单里已有 doctor JSON 与备份哈希。
在 OpenClaw 尖叫之前,磁盘会先尖叫的症状
磁盘压力常伪装成“自动化不稳定”。留意:
- 网关健康检查 在本地成功,但 webhook 回执成批到达——常见是日志 fsync 卡顿。
- Node 包安装 原本两分钟突然超过十分钟,尤其在 OpenClaw 插件升级把 tarball 解到工作区暂存之后。
- macOS “存储空间几乎已满” 弹窗出现在屏幕共享会话中,而工程师仍坚称“我们只跑文本智能体”。
若你把阈值设得过松,会在一次插件发布会后同时触发数十台 mini 的磁盘告警;若设得过紧,又会在正常构建波峰期制造噪音。建议把阈值与队列深度、并发沙箱数量一起画在同一张折线图上做季度回顾。
热点路径清单:多租户云端 Mac 上什么长得最快
并非每一兆字节都属于 OpenClaw,但网关进程与开发者杂项共址。周卫生检查时使用下表;按组织自定义插件路径扩展行。
| 路径模式 | 典型增长驱动 | 可安全修剪 | 误删风险 | 备注 |
|---|---|---|---|---|
~/.openclaw/tmp | Webhook 重放缓冲 | 有工单后可 | 低 | 超过 72 小时轮转 |
~/.npm 缓存 | 插件安装 | 可 | 中 | 下次安装更久 |
~/Library/Logs 统一日志镜像 | 冗长网关周 | 有上限可 | 低 | 与 SOC2 留存协调 |
~/.openclaw/state 队列 | 卡住的任务 | 无备份不可 | 高 | 先排空队列 |
某些团队会把大型语言模型权重放在家目录旁侧目录;这些路径不会出现在 OpenClaw 默认清单里,但会挤压同一 APFS 容器。请在内部清单中加一行“模型权重路径”,并在定价讨论里把权重盘与网关盘拆租。
二元修剪矩阵(事故压力下快速回答)
| 问题 | 若答是 | 若答否 |
|---|---|---|
| doctor JSON 导出已附在工单? | 可继续安全删除 tmp | 停止——先跑 doctor |
| 过去 30 分钟内已做 tarball 备份? | 允许对 soul-memory 归档做破坏性轮换 | 按 交接指南 先备份 |
| 是否有工程师正在屏幕共享? | 推迟大删除 | 继续 IO 轻量 passes |
矩阵刻意做成二元,是为了在凌晨三点减少决策树深度:先回答备份与 doctor,再回答人机是否共屏,最后才谈删除范围。把“我大概备份了”改成工单里的哈希附件,能显著降低回滚争议。
八步手册(2026 年 4 月修订)
- 冻结 会生成新沙箱的出站实验,直至修剪完成。
- 捕获
df -h与 inode 统计写入事件工单。 - 导出
openclaw doctor --json(或组织等价命令)再对磁盘做任何变更。 - 归档
~/.openclaw,按备份文章使用带哈希的 tarball 命名。 - 修剪 tmp、轮转日志与旧插件构建产物,遵循上表。
- 抽空 npm 缓存,若本就计划做对等依赖重建。
- 重启 网关:仅在确认至少 15 GB 空闲后执行
launchctl kickstart -k。 - 再导出 doctor JSON,与第三步 diff;将 diff 附在关单评论。
第八步的 diff 是审计最爱看的附件:它证明你不是“凭感觉删文件”,而是用同一探针在前后对照。若 diff 显示插件版本漂移,请另开缺陷单跟踪,而不是混在磁盘事件里。
网关日志、统一日志与为何“删控制台”很敷衍
macOS 统一日志在排障后若仍保持 debug 级别,可能吞掉数 GB。请在网关层把结构化 JSON 行路由到按日轮转、保留 七 份冷拷贝的受限文件,除非合规要求更久。离线上传前先压缩——对人类仍在屏幕共享旁调试的场景,带宽同样宝贵。
若你把日志 ship 到 SIEM,请确认字段脱敏与采样策略不会反向撑爆租约磁盘;见过团队在本地留全量、在云端再做采样,结果双份付费。
破坏性操作前先备份状态(不可协商)
OpenClaw 的价值在于连续性:排队 webhook、半完成的工具审批、soul-memory 指针。未读符号链接就删“只是缓存”,搞砸的实验室比任何 CVE 讨论都多。请字面遵循 状态目录备份交接——给归档算哈希,尽量存到租约外,并记录谁持有加密密钥。
备份文件名里务必含租约 ID 与时间戳,避免不同区域的同名 tarball 在对象存储里互相覆盖。恢复演练应每季度做一次,否则真出事时你会发现密钥在已离职员工的个人密码库里。
区域机队现实:香港、东京、首尔、新加坡与美国
磁盘压力并不均匀。新加坡与香港租约常承载跨境 CI 突发,npm 缓存比单区域美国团队预期填得更快。日本企业常要求更长日志留存——请按国家而非泛化“云规则”制定轮转。韩国游戏相邻客户可能把大资源包放在 OpenClaw 旁;用独立配额隔离。美国客户若把 Ollama 权重与 OpenClaw 混放,有二级卷时应把权重挂到副卷。
当三个以上并发网关实验并存导致 footprint 爆炸,请用 定价 拆租约而不是无限修剪——硬件比 pager 疲劳便宜。
跨国团队还要考虑数据驻留:把日志 tarball 上传到境外桶前,先过法务白名单,否则磁盘问题会升级成合规事件。
常见问题
MacLogin 会自动修剪我的工作区吗? 文件生命周期由客户负责;我们提供容量——参见 帮助 中的监控挂钩建议。
是否应禁用插件省磁盘? 先度量;插件本体可能比其缓存更小。
Docker 呢? 若共址容器,请单独 prune 镜像;本文聚焦 OpenClaw 原生路径。
能否用定时任务自动删 tmp? 可以,但必须把 doctor 与队列排空检查写进同一脚本 guard,否则可能在 webhook 重放中途删缓冲。
为何 Mac mini M4 统一内存在磁盘抖动时仍利于 OpenClaw
当 APFS 在大工作区复制期间执行写时复制,M4 的统一内存带宽让网关在 tarball 流式传输时仍保持响应。这对首尔与东京团队同时导出 doctor 尤其重要。向 MacLogin 增租 mini,把“实验”与“生产”网关隔离,可降低破坏性修剪频率并缩短事件窗口。
把硬件扩容与运维纪律配对:每季度先在从 定价 模板克隆的非生产租约上演练本手册,再推广 survived 的自动化。
若你在读到这里仍觉得“删一点日志就好”,请回到矩阵第一行:没有 doctor JSON 的磁盘操作,本质上是一次未批准的变更。