Windows

在 Windows 上安装 OpenClaw(推荐 WSL2)

按步骤在 Windows 上稳定运行 OpenClaw。

这个方案适合你吗?

适合

  • 你按需手动运行 OpenClaw
  • 你愿意按指南操作

不推荐

  • 你需要 24/7 运行
  • 你不想改系统设置

开始前准备

  • Windows 10/11
  • 已启用 WSL2
  • 支持的 Node.js 版本
  • 可用的网络连接

安装步骤

为确保正确性并避免过期命令,我们引导你走官方安装路径,并标注真正关键的点。

步骤 1 - 进入官方安装指南

OpenClaw 的安装命令会随版本变化。为避免复制过期命令,我们直接链接到该平台的官方安装指南。

这样能确保你始终使用最新且受支持的安装命令。

步骤 2 - 平台注意事项(运行命令前必读)

运行官方命令前,请先看这些平台注意事项,避免常见配置问题。

  • Windows 上强烈建议使用 WSL2 以保证稳定性
  • 确认所需端口未被占用
  • 使用官方文档指定的 Node.js 版本

步骤 3 - 验证安装结果

完成官方步骤后,确认 OpenClaw 已正确运行。

应看到:启动或 listening 相关信息,且无立即报错。

应可访问:本地 UI、健康检查接口或 CLI 返回正常结果。

若不正常,请看:故障排查指南

本指南刻意链接官方安装说明,以保证准确性。平台注意事项与验证步骤经过整理与验证,可提高成功率。

验证安装

服务状态

OpenClaw 应显示为 running 或 listening。

本地访问

本地 UI 或健康检查接口可正常访问。

首个任务

一个简单工作流可顺利跑完且无权限错误。

Windows 常见问题

端口冲突

OpenClaw 无法绑定端口或启动即退出。

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

查看故障排查

权限错误

命令执行失败并提示权限不足。

检查 WSL2 权限与文件归属设置。

查看故障排查

Node 版本不匹配

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

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

查看故障排查

接下来做什么?

在 Windows 上安装 OpenClaw – 本地部署指南 | openclawskill