AI 自动化 2026年4月25日

MacLogin 云端 Mac 上的 OpenClaw 工作区磁盘垃圾回收:2026 年 4 月修剪手册,让网关在线且不删队列

MacLogin AI 自动化团队 2026年4月25日 约 17 分钟阅读

当租用 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 “存储空间几乎已满” 弹窗出现在屏幕共享会话中,而工程师仍坚称“我们只跑文本智能体”。
告警阈值: 任一租约利用率超过 85% 或可用空间低于 15 GB——以先到者为准——即应 paging,因为 APFS 写时复制快照可能吃掉隐藏余量。

若你把阈值设得过松,会在一次插件发布会后同时触发数十台 mini 的磁盘告警;若设得过紧,又会在正常构建波峰期制造噪音。建议把阈值与队列深度、并发沙箱数量一起画在同一张折线图上做季度回顾。

热点路径清单:多租户云端 Mac 上什么长得最快

并非每一兆字节都属于 OpenClaw,但网关进程与开发者杂项共址。周卫生检查时使用下表;按组织自定义插件路径扩展行。

路径模式典型增长驱动可安全修剪误删风险备注
~/.openclaw/tmpWebhook 重放缓冲有工单后可超过 72 小时轮转
~/.npm 缓存插件安装下次安装更久
~/Library/Logs 统一日志镜像冗长网关周有上限可与 SOC2 留存协调
~/.openclaw/state 队列卡住的任务无备份不可先排空队列

某些团队会把大型语言模型权重放在家目录旁侧目录;这些路径不会出现在 OpenClaw 默认清单里,但会挤压同一 APFS 容器。请在内部清单中加一行“模型权重路径”,并在定价讨论里把权重盘与网关盘拆租。

二元修剪矩阵(事故压力下快速回答)

问题若答是若答否
doctor JSON 导出已附在工单?可继续安全删除 tmp停止——先跑 doctor
过去 30 分钟内已做 tarball 备份?允许对 soul-memory 归档做破坏性轮换交接指南 先备份
是否有工程师正在屏幕共享?推迟大删除继续 IO 轻量 passes
警告: 切勿在网关 LaunchAgent 中途重载时运行递归删除——交错写入可能留下半刷新的 JSON5,直到下一次干净重启前出现幽灵工具注册。

矩阵刻意做成二元,是为了在凌晨三点减少决策树深度:先回答备份与 doctor,再回答人机是否共屏,最后才谈删除范围。把“我大概备份了”改成工单里的哈希附件,能显著降低回滚争议。

八步手册(2026 年 4 月修订)

  1. 冻结 会生成新沙箱的出站实验,直至修剪完成。
  2. 捕获 df -h 与 inode 统计写入事件工单。
  3. 导出 openclaw doctor --json(或组织等价命令)再对磁盘做任何变更。
  4. 归档 ~/.openclaw,按备份文章使用带哈希的 tarball 命名。
  5. 修剪 tmp、轮转日志与旧插件构建产物,遵循上表。
  6. 抽空 npm 缓存,若本就计划做对等依赖重建。
  7. 重启 网关:仅在确认至少 15 GB 空闲后执行 launchctl kickstart -k
  8. 再导出 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 的磁盘操作,本质上是一次未批准的变更。

给 OpenClaw 在 Apple Silicon 上留足呼吸空间

在香港、日本、韩国、新加坡与美国部署 MacLogin 云端 Mac,为智能体预留磁盘余量。