（3340期）Openclaw Gateway Fd Fix – 一键修复 Gateway 文件描述符耗尽崩溃

一键修复 Gateway 文件描述符耗尽崩溃 一键修复 OpenClaw Gateway 因文件描述符耗尽导致的崩溃/挂起问题，自动清理大目录并提升系统资源限制。 使用说明 核心用法 本技能提供自动化脚本和手动指南，解决 OpenClaw Gateway 因文件描述符（FD）耗尽引发的典型故障。用户只需运行 bash fix.sh 即可完成全流程修复：检测工作区文件数量、清理 .venv 和 node_modules 等依赖目录、备份并修改 LaunchAgent 配置将文件描述符上限提升至 524,288、重启服务并验证健康状态。手动修复方案则提供逐步命令和 XML 配置片段，适合需要精细控制的用户。 显著优点 一站式自动化：单命令完成检测、清理、配置、重启全流程，降低运维门槛 精准定位根因：直击 macOS 默认 FD 限制（256）与 Gateway 全目录监控机制的冲突 永久性防护：明确列出禁止放入工作区的目录类型（虚拟环境、数据集、模型权重等），预防复发 安全回滚机制：自动备份原始 LaunchAgent plist，便于异常时恢复 潜在局限 平台限定：仅针对 macOS LaunchAgent 设计，Linux/Windows 用户需手动适配 破坏性清理：自动删除 .venv/node_modules 可能误伤未纳入版本控制的本地依赖，需用户确认工作区内容 硬编码阈值：524,288 的 FD 上限对极端场景（百万级小文件）仍可能不足 无日志轮转处理：未涉及 Gateway 日志本身膨胀导致的磁盘问题 适合人群 OpenClaw Gateway 频繁出现 spawn EBADF、RPC probe failed、EMFILE 错误的终端用户 在 ~/.openclaw/workspace/ 内误放虚拟环境或 node_modules 的开发人员 需要快速恢复 Gateway 服务、不愿深究 FD 机制的技术运维 常规风险 服务中断：重启 Gateway 期间相关 RPC 调用将失败，需规划维护窗口 配置覆盖：若用户已自定义 LaunchAgent 资源限制，脚本可能覆盖为固定值 路径硬编码：依赖 ~/Library/LaunchAgents/ai.openclaw.gateway.plist 标准路径，非标准安装可能失效 权限需求：修改系统级资源限制可能需要用户密码或管理员权限交互 原始说明 Fix OpenClaw Gateway "spawn EBADF" / "RPC probe failed" / "EMFILE too many open files" errors caused by file descriptor exhaustion from too many files in wor...