最近在 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: SIGUSR1

3.执行 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 故障排查

---