Windows 养龙虾真会卡：OpenClaw 合并了我们的修复，Hermes 维护者也回应了

本文是视频版的文字展开。视频里讲得快，这里把证据链、问题边界和可复用经验讲清楚。

如果你在 Windows 上跑过 OpenClaw、Hermes 这类 AI Agent，大概率遇到过这种场景：任务做一半卡住，刚才还在输出，下一秒就不理你；或者 gateway 看起来还开着，实际已经没人接任务了；再或者没升级前好好的，一升级就启动不了。

这些问题最烦的地方，不是报错本身，而是它们经常“不像一个清楚的报错”。终端窗口还在，进程可能还在，日志也不一定第一时间告诉你哪里坏了。于是很多人只能本地绕过去：重启、降级、换终端、换机器。

我们这段时间做了一件更慢但更有用的事：把这些 Windows 上的真实问题整理成可复现的证据、可审查的补丁和明确的维护者沟通记录，提交到 OpenClaw 和 Hermes 这些官方项目里。

其中一部分已经被 OpenClaw 合并；另一部分虽然没有直接合并，但得到了 Hermes 维护者的明确回应，进入了后续 Windows 支持规划的讨论范围。

先说 OpenClaw：不是大改，而是修一个很真实的 Windows 文件锁问题

这次最明确的结果，是 OpenClaw PR #76024：

https://github.com/openclaw/openclaw/pull/76024

它修的不是一个炫酷功能，而是一个很 Windows 的小坑：memory index 重建时，底层会做 SQLite 文件替换。如果这个瞬间文件被系统、杀毒软件、索引器或其他短暂句柄占用，fs.rename 就可能遇到 EBUSY、EPERM 或 EACCES。

用户看到的现象可能只是“memory 搜不到”“任务卡住”“重建失败”。但真正的问题在底层：一次短暂文件锁，打断了整个 index swap。

我们的修复思路也很克制：不重写 memory 系统，不扩大行为范围，只给这个 atomic index swap 加一个有边界的 retry。简单说，就是不要因为一次瞬时文件占用，就把整个流程判死。

这个 PR 后来被 OpenClaw 官方项目合并了。对 Windows 用户来说，这类小修复不显眼，但很重要。Agent 稳不稳定，很多时候就卡在这些边角问题上。

参与别人的 PR，也是一种贡献

另一个例子是 OpenClaw PR #59137：

https://github.com/openclaw/openclaw/pull/59137

这不是我们发起的 PR。主线方向已经有人做了，我们参与的是 follow-up：补齐失败路径里的临时数据库关闭和清理顺序。

这种贡献不适合吹成“我们做了一个大功能”。但它很有工程价值。因为很多稳定性问题不是主逻辑错了，而是失败路径、清理顺序、回滚状态这些细节没有收好。

在 Windows 上尤其明显：你以为文件可以删了，但系统可能还攥着句柄不放。清理前先确认数据库连接真的关掉，是小事，也是稳定性的基本功。

再说 Hermes：没有合并，但维护者回应更有信息量

Hermes 这边，我们提交的是 PR #15846：

https://github.com/NousResearch/hermes-agent/pull/15846

它关注的是 Windows gateway 的后台稳定运行：不要长期依赖一个前台 PowerShell 或 CMD 窗口，让 gateway 尽可能通过 Scheduled Task 静默启动，并提供状态检查、日志和基础恢复。

这个 PR 没有直接合并。这里要说清楚：没有合并不等于没价值，也不等于“官方采纳了完整方案”。

维护者的回应大意是：他们正在关闭一批零散的 native Windows PR，因为 Windows 支持需要统一设计，而不是一块一块地合并；这个 PR 已经被记录到内部 Windows support plan，后续整合方案会参考这些工作，并给贡献者 credit。

这对我们反而是一个很好的信号：问题不是被忽略，而是进入了更大范围的设计讨论。

真正的经验：不要把稳定性寄托在一个亮着的终端窗口上

很多人在 Windows 上跑 Agent，会把一个终端窗口一直开着。看起来直观，其实并不稳。

窗口可能被误关，进程可能异常退出，WebSocket 可能断开，gateway 也可能已经死了但窗口还在。最危险的是：你以为它活着，任务却已经没人接了。

更稳的方式应该是：

• 后台启动，而不是长期依赖前台窗口。
• 有状态检查，知道 gateway 到底还活没活。
• 有日志，出问题能回头看。
• 有基础恢复能力，不要每次都靠人手动重启。
• 升级前先看 issue 和 PR，别无脑追最新版本。

为什么这件事值得做

开源贡献不只是发一个 PR。对 AI Agent 这类工具来说，真正难的是把“我本地遇到的问题”变成别人能判断、能复现、能维护的材料。

这需要截图、日志、失败路径、测试结果，也需要跟维护者沟通清楚边界：哪些已经修了，哪些只是建议，哪些进入了后续计划。

我们后面会继续围绕 Windows Agent 稳定性做这件事。重点会放在几个方向：

• gateway 生命周期
• 后台静默启动
• Windows 文件锁和 SQLite 稳定性
• 代理和环境变量继承
• 进程状态检查、日志和恢复
• 可复现证据和回归测试

如果你也在 Windows 上养龙虾、养马，遇到过任务卡死、窗口还在但 agent 不回、升级后 gateway 掉线这类问题，欢迎留言。越具体的问题，越有机会整理成真正能推进项目变好的证据。

这条线会继续沉淀到 OpenClaw / Hermes 上游贡献专题 里，后续新的 PR、issue、维护者回复和验证截图都会集中更新。