Windows11安装本地openclaw

2026-05-05阅读 0热度 0

OpenClaw

Windows 源码安装指南

开工之前，先确认一下你的“装备”版本：node 版本需要是 24.13.0，而 pnpm 版本则建议是 10.30.3。版本对上了，后面的事儿就顺了。

下载源码

第一步，自然是把源代码拉取到本地：

git clone https://github.com/openclaw/openclaw.git

安装依赖

进入刚克隆下来的项目目录，然后执行依赖安装命令：

pnpm install

执行编译

依赖装好后，需要执行两步编译命令，这是构建的基础：

pnpm exec tsc -p vendor/a2ui/renderers/lit/tsconfig.json
pnpm exec rolldown -c apps/shared/OpenClawKit/Tools/CanvasA2UI/rolldown.config.mjs

构建项目

编译无误后，就可以进行完整的项目构建了：

pnpm build

初始化配置

构建成功，接下来进行初始化配置。初次运行如果对某些选项不确定，完全可以选择“跳过” (skip for now)，后续再调整也不迟。

pnpm openclaw onboard

启动服务

配置完成后，万事俱备，启动网关服务：

pnpm openclaw gateway

服务启动后，就可以在浏览器中访问相应的本地地址了。

常见问题解决方案

按照经验，安装过程中最容易卡壳的地方，通常出现在第三步编译或第四步构建环节。下面整理了几个实测中碰到过的典型问题及其解法。如果你遇到其他“拦路虎”，除了参考这里的方案，也别忘了去项目的官方Git仓库里翻翻Issue，或者直接请教AI助手，很多时候都能找到线索。

问题1：rolldown 命令未找到

报错信息: Command “rolldown” not found

解决方案：这说明 rolldown 这个打包工具没有作为项目依赖被安装。你需要先在全局或工作区范围内安装它，然后再执行命令。

pnpm add -D -w rolldown
pnpm exec rolldown -c apps/shared/OpenClawKit/Tools/CanvasA2UI/rolldown.config.mjs

问题2：WSL 更新失败

报错现象: wsl.exe –update 请求提权，并提示证书作者无效或不正确。这一步正常执行后，会在你的Windows主机上安装WSL虚拟机环境。

解决方案：这个问题往往和系统根证书有关。可以尝试手动更新证书，如果依然失败，则重新安装一个WSL分发版。

# 尝试更新证书
certutil -generateSSTFromWU roots.sst
certutil -addstore -f ROOT roots.sst

# 如果报错提示“没有已安装的分发”，则执行以下命令安装一个Linux分发版（例如Ubuntu-22.04）
wsl --install
wsl --list --online
wsl --install -d Ubuntu-22.04

问题3：A2UI 打包失败

报错信息:

scripts/bundle-a2ui.sh: line 35: node: command not found
A2UI bundling failed. Re-run with: pnpm canvas:a2ui:bundle
If this persists, verify pnpm deps and try again.
 ELIFECYCLE  Command failed.

解决方案：这个错误通常意味着在Shell脚本环境中未能正确识别 node 命令。一个直接的解决方法是尝试手动运行这个打包脚本。

./scripts/bundle-a2ui.sh