OpenClaw启动失败主因是环境配置错误，需先确认Node.js≥22.0.0、再检查PowerShell执行策略、计划任务工作目录、.env格式及权限设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
先确认Node.js版本是否达标
OpenClaw v2026.3+强制要求 Node.js ≥22.0.0 且
- 运行 node -v 查看当前版本；若不是 v22.x（如 v22.14.2），就得切换
- Windows 用户建议用官方 .msi 安装包（nodejs.org/dist/v22.14.2/），安装时勾选 “Add to PATH”
- Mac/Linux 用户可用 nvm install 22.14.2 && nvm use 22.14.2
- 验证是否生效：执行 which node 或 where node，路径应指向 v22 安装目录
检查 .env 和配置文件格式
新版 OpenClaw 启动前会校验环境变量和配置合法性，一处格式错误就会直接中止。
-
OPENCLAW_SECRET_KEY 必须存在，且不能是简单字符串（如“123456”）；推荐用
openssl rand -hex 32生成 -
.env 文件里等号两侧不能有空格，例如
LLM_PROVIDER=deepseek✅，LLM_PROVIDER = deepseek❌ - 修改
~/.openclaw/openclaw.json后，务必用 jsonlint.com 校验语法；常见错误包括末尾多逗号、键名没加引号、布尔值加了引号 - 确保
gateway.mode已设为"local"或"lan"，否则网关无法初始化
排查端口与系统策略限制
默认端口 18789 被占、PowerShell 策略拦截、计划任务工作目录错误——这三类问题在 Windows 上高频出现，且症状都是“命令执行无反应”或“启动后秒退”。
- 查端口占用：
netstat -ano | findstr :18789（Windows）或lsof -i :18789（Mac/Linux）；找到 PID 后用taskkill /F /PID XXX或kill -9 XXX释放 - Windows 用户需以管理员身份运行 PowerShell，执行：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned - 若用任务计划开机自启，必须手动设置“起始于”目录为
C:\Users\YourName\.openclaw，否则 gateway.cmd 在 System32 下找不到配置文件
用内置工具快速定位问题
别手动翻日志猜原因，OpenClaw 自带诊断链路，效率高、信息准。
- 第一步：
openclaw status——看整体服务状态 - 第二步：
openclaw gateway status——重点看Runtime: running和RPC probe: ok - 第三步：
openclaw logs --follow——实时观察启动过程中的第一行报错 - 终极手段：
openclaw doctor自动扫描，再加--fix尝试一键修复
