Beginner 项目实战
OpenClaw Windows Silence Run
面向 Windows 原生 OpenClaw Gateway 的静默启动与升级后修复工具,解决升级后黑框残留、Gateway Ready/unknown、18789 未监听等问题。
技术栈与实现方向
PowerShellBatchWindows Scheduled TaskOpenClaw
OpenClaw Windows Silence Run 是一个很小的 Windows 工具项目,目标不是替代 OpenClaw,而是把 Windows 原生运行时里最容易打断工作流的几个问题收住:
- Gateway 启动时弹出可见
cmd黑框; - OpenClaw 升级后残留
findstr /R /C:":18789 .*LISTENING"端口检测窗口; openclaw gateway status显示Ready/unknown,但18789没有进程监听;- 需要快速看到 Gateway 日志、PID、任务状态和端口监听情况。
它解决什么问题
Windows 上的 OpenClaw Gateway 通常通过计划任务启动。计划任务如果直接执行 ~\.openclaw\gateway.cmd,就可能出现可见命令行窗口。升级流程里如果端口释放检测卡住,也可能留下一个 findstr ... :18789 ... LISTENING 的黑框。
这个项目做的是一个很窄的事情:在计划任务层使用 wscript.exe 隐藏启动 OpenClaw 生成的 gateway.cmd,同时提供 status、logs、cleanup、post-update 这些便于排查和恢复的命令。
推荐使用方式
首次使用:
.\openclaw-gateway install
.\openclaw-gateway restart
.\openclaw-gateway status
每次升级 OpenClaw 后:
.\openclaw-gateway post-update
如果你只是想确认当前 Gateway 状态:
.\openclaw-gateway status
相关入口
- GitHub 仓库:https://github.com/kunpeng-ai-lab/windows-ai-gateway-silence-run
- 使用指南:/blog/openclaw-windows-silent-gateway-after-update/
- 问题复盘:/blog/openclaw-windows-gateway-findstr-ready-none-found-troubleshooting/
- 论坛技术帖:https://forum.kunpeng-ai.com/threads/windows-openclaw-gateway-findstr