OpenClaw 网关服务安装与启动失败问题排查（Windows 环境）
最近在 Windows 上折腾 OpenClaw 网关服务，遇到了安装失败、重启报错、乱码等一系列问题，花了不少时间才理清楚。这里把排查过程和解决方案记录下来，希望能帮到遇到类似问题的同学。
一、背景
OpenClaw 是一个功能强大的 AI 智能体网关，支持钩子（Hooks）、Web UI 控制、Workspace 备份等功能。我按照官方文档在 Windows Server / Win11 上安装时，卡在了Gateway service install failed这一步，而且后续的restart、start命令也都报错，一度让人头大。
二、问题现象
主要现象如下：
1.首次安装失败
Gateway service install failed. Health check failed: gateway closed (1000)2.执行openclaw gateway restart报错
Gateway restart failed: TypeError [ERR_UNKNOWN_SIGNAL]: Unknown signal: SIGUSR13.执行openclaw gateway install/start失败
Gateway install failed: Error: schtasks create failed: Gateway start failed: Error: schtasks run failed:4.PowerShell 中文乱码
提示信息中的引号、特殊字符显示为乱码，影响了错误信息的阅读。
三、排查过程
1. 确认网关进程状态
执行端口监听查看命令：
netstat -ano | findstr :18789输出示例：
解读：
LISTENING表示网关正在监听 18789 端口ESTABLISHED表示已有客户端连接（浏览器、API 调用等）这说明网关实际上是运行着的，只是服务未注册为 Windows 计划任务
2. 分析各命令报错原因
| 命令 | 报错 | 原因 |
|---|---|---|
openclaw gateway restart | ERR_UNKNOWN_SIGNAL: SIGUSR1 | SIGUSR1是 Linux 信号，Windows 不支持，restart命令兼容性问题 |
openclaw gateway install | schtasks create failed | 计划任务创建失败，可能与权限或系统策略有关 |
openclaw gateway start | schtasks run failed | 服务未安装，自然无法启动 |
3. 乱码问题
PowerShell 默认编码为 GBK，而 OpenClaw 输出 UTF-8，导致中文字符显示异常。
解决方法：
chcp 65001切换为 UTF-8 编码后再执行命令，即可正常显示中文。
四、解决方案
✅ 方案一：前台运行（推荐临时使用）
不需要安装为系统服务，直接在前台启动网关，适合测试或临时使用：
openclaw gateway或者：
openclaw gateway start --foreground启动成功后，浏览器访问 Dashboard：
http://127.0.0.1:18789/#token=<你的token>退出前台运行时，按Ctrl + C即可。
✅ 方案二：分离操作替代 restart
在 Windows 下，不要直接使用restart，改用stop+start：
openclaw gateway stop openclaw gateway start✅ 方案三：手动创建计划任务（如仍需服务化）
如果install命令持续失败，可以尝试手动创建计划任务：
schtasks /Create /TN "OpenClaw Gateway" /TR "node C:\Users\Administrator\.openclaw\gateway.js" /SC ONLOGON /RL HIGHEST /F⚠️ 注意：路径需根据你的实际安装位置调整。
✅ 方案四：解决乱码（永久生效）
修改 PowerShell 配置文件$PROFILE，添加以下内容：
$OutputEncoding = [System.Text.Encoding]::UTF8 chcp 65001 > $null保存后重启 PowerShell 即可。
五、验证网关是否运行
方法一：端口检查
netstat -ano | findstr :18789看到LISTENING即表示正常运行。
方法二：状态命令
openclaw gateway status方法三：浏览器访问
打开http://127.0.0.1:18789/，能看到控制台界面即成功。
六、总结
| 问题 | 根因 | 解决方案 |
|---|---|---|
restart报错 SIGUSR1 | Windows 不支持 Linux 信号 | 改用stop+start |
install/start失败 | 计划任务创建被拒绝 | 使用前台运行openclaw gateway |
| 网关无法启动 | 服务未安装 / 进程被杀 | 前台运行或手动创建计划任务 |
| 控制台乱码 | 编码不匹配 | 执行chcp 65001 |
核心结论：
网关本身是能正常运行的，问题出在Windows 服务注册和命令兼容性上
如果只是为了使用功能，前台运行是最省心的方式
如果必须服务化，建议手动创建计划任务，或切换到 Linux / WSL 环境
希望这篇文章能帮你少踩一些坑！如果有其他问题，欢迎在评论区交流讨论。
📎 相关文档：
OpenClaw 官方文档
Gateway 健康检查
Gateway 故障排查