排查

部署故障排查

用最常见的修复方法快速脱困。

高频错误

端口已被占用

服务无法启动或启动即退出。

其他服务占用了相同端口。

停止冲突服务或修改 OpenClaw 端口。

返回安装页

权限不足

命令执行失败并提示权限错误。

文件归属错误或权限不足。

修复权限或使用所需权限运行。

返回安装页

Node 版本不匹配

安装脚本失败或运行崩溃。

安装了不支持的 Node.js 版本。

使用官方文档指定的版本。

返回安装页

端点不可达

其他机器访问健康检查失败。

防火墙/安全组/路由拦截。

开放必要端口并检查路由。

返回安装页

重启后服务停止

重启后 OpenClaw 不再运行。

未配置进程管理或系统服务。

使用进程管理器或系统服务保持运行。

返回安装页

修复模式

先查权限

多数失败来自权限不足或文件归属错误。

校验端口

确认所需端口已开放且未被占用。

Node 版本一致

使用官方推荐的 Node.js 版本。

OpenClaw 故障排除 – 常见问题与修复 | openclawskill