Agent Skills
返回列表
OpenClaw 网关故障诊断与修复

OpenClaw 网关故障诊断与修复

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_711d6c08/openclaw-gateway-fixer。

技能介绍

问题

OpenClaw 网关在 Windows 上可能无法正常启动：http://127.0.0.1:18789 连接被拒、超时，或提示 gateway token 异常。gateway.cmd 存在但双击无反应时，常见原因是中文用户名在 UTF-8/GBK 转换中变成乱码，例如 吴清能 被写成 鍚存竻鑳絓，导致 TMPDIR、node.exe 或工作区路径失效。

工作方式

该技能按诊断链路处理故障：

  • 检查进程与端口：确认 18789 是否处于 LISTENING，排除其他进程占用。
  • 检查 gateway.cmd：读取 C:\Users\...\.openclaw\gateway.cmd，判断中文路径、反斜杠和 node.js 路径是否正确。
  • 检查 openclaw.json：查看 agents.defaults.workspace 与 gateway.auth.token 是否可正常解析。
  • 执行修复：备份后用 scripts/fix-gateway-cmd.ps1 重写为正确编码；必要时直接启动网关、生成静默启动脚本，或创建 Windows 计划任务实现登录延迟自启和失败重试。

适用边界

它主要解决 Windows 中文用户名编码、端口冲突和 gateway.cmd 启动失败问题，不覆盖网关功能本身的逻辑错误。OpenClaw 升级后可能重新生成 gateway.cmd，需要重新应用修复。

使用场景

  • 排查 OpenClaw 网页端连接拒绝或超时，定位网关进程未监听 18789 端口的问题。
  • 修复 gateway.cmd 中中文用户名乱码导致双击静默失败的问题。
  • 在 18789 端口被占用时调整配置或释放端口，让网关恢复访问。
  • OpenClaw 更新后网关脚本重新生成失效，重新备份并修复编码。

适合人员

  • 维护 Windows 办公终端的 IT 运维：快速恢复同事的 OpenClaw 网关。
  • 使用 OpenClaw 中文界面的本地运维：解决网关令牌页无法打开问题。
  • 部署内部 Agent 工具的工程师：排查端口占用和启动脚本失败。
  • 升级后系统失修的 Windows 用户：重新配置自动启动。