OpenClaw 提示“没有启动文件”或无法启动修复(gateway.cmd)

OpenClaw 提示“没有启动文件”或无法启动，通常是因为网关服务（Gateway）未运行、配置文件缺失或系统服务注册失败。

根据搜索结果和常见部署经验，请按照以下步骤排查和解决：

1. 核心原因：Gateway 服务未启动

OpenClaw 的核心功能依赖于 gateway 服务。如果该服务没有运行，你会感觉像“没有启动文件”一样无法使用。

• 手动启动测试：
  在终端（Windows 下用 PowerShell 管理员模式，Linux/Mac 用 sudo）尝试手动启动网关，查看具体报错：

  openclaw gateway --verbose

  或者尝试启动服务：

  openclaw gateway start

• 检查服务状态：
  运行以下命令查看当前状态：

  openclaw status

  如果显示 gateway 未运行，请执行下一步修复。

2. 缺失配置文件 (Missing Config)

如果提示 Missing config 或类似错误，说明尚未初始化配置。

• 执行初始化向导：

  openclaw setup

  按照提示完成配置（如选择模型、设置 API Key 等）。

• 临时绕过（仅测试用）：
  如果是开发环境，可以尝试设置本地模式（不推荐生产环境）：

  openclaw config set gateway.mode local

3. 系统服务注册问题 (Windows/Linux)

OpenClaw 通常需要将自身注册为系统服务以实现开机自启和后台运行。如果注册失败，重启后就会找不到“启动文件”。

• 自动修复服务注册：
  使用的诊断修复命令：

  openclaw doctor --fix

  这条命令会尝试重新安装 Gateway 服务并修复权限问题。

• Windows 特有权限问题：

  • 确保你是以管理员身份运行 PowerShell 或 CMD。
  • 如果之前安装过但失败了，可能需要手动删除旧的服务注册信息再重新运行 openclaw doctor --fix。
  • 检查 PowerShell 执行策略：

    Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

4. 端口被占用

如果服务启动了但立即退出，可能是默认端口（通常是 18789）被占用。

• 检查端口：

  # Windows
  netstat -ano | findstr 18789
  # Linux/Mac
  lsof -i :18789

  如果有进程占用，杀掉该进程或修改 OpenClaw 的配置端口。

5. 重新安装（最后手段）

如果上述方法都无效，可能是核心文件损坏或路径错误。

1. 卸载：

   npm uninstall -g openclaw

   (如果是通过其他包管理器安装的，请使用对应的卸载命令)

2. 清理残留配置（可选，注意备份）：
   删除用户目录下的 .openclaw 文件夹（位置通常在 C:\Users\你的用户名\.openclaw 或 ~/.openclaw）。
3. 重新安装：

   npm install -g openclaw

4. 重新初始化：

   openclaw setup
   openclaw doctor --fix

总结建议的操作顺序：
openclaw status (看状态) -> openclaw doctor --fix (自动修复) -> openclaw gateway --verbose (手动启动看报错) -> openclaw setup (补全配置)。

楼主的分享解决了我的燃眉之急。