Windows源码部署OpenClaw
环境准备
部署前的第一步,是配置好必需的开发与运行环境。以下是经过验证的版本要求,以确保后续编译与启动过程顺利无阻。
操作系统:Windows 10 或 Windows 11(本篇指南基于 Windows 11 环境操作)
Node.js:版本 v22 或更高(推荐使用 nvm-windows 进行多版本隔离与管理)
包管理器:pnpm(此为项目强制要求,可通过 npm install -g pnpm 命令全局安装)
Python:3.11及以上(主要供部分可选的 Skills 功能调用,建议在虚拟环境 venv 中安装)
Git:用于获取项目源代码仓库
源码编译安装
获取源码
通过 Git 命令行工具,克隆项目的主仓库到本地:
git clone https://github.com/openclaw/openclaw.git
编译与启动
请使用管理员权限打开 CMD 命令提示符,切换至项目根目录后,按顺序执行下列命令:
cd openclaw
pnpm install
pnpm ui:build # 首次执行将自动构建UI依赖
pnpm build
pnpm openclaw onboard --install-daemon
# 启动开发监控模式(源码或配置变动后将自动热重载)
pnpm gateway:watch
若安装流程中出现类似“Ignored build scripts: core-js”的警告,无需中断,执行以下命令核准构建脚本:
pnpm approve-builds
# 在随后弹出的交互选项中,选中 core-js 并确认通过
若遇到报错“Error: Missing A2UI bundle assets. Run “pnpm canvas:a2ui:bundle” and retry.”,表明需要手动完成A2UI资源包的构建。请依次执行:
# 步骤一:安装必需的rolldown打包工具
pnpm add rolldown --save-dev -w
# 步骤二:编译 A2UI Renderer 模块
pnpm exec tsc -p vendor/a2ui/renderers/lit/tsconfig.json
# 步骤三:运行rolldown进行资源打包(核心步骤)
pnpm exec rolldown -c apps/shared/OpenClawKit/Tools/CanvasA2UI/rolldown.config.mjs
当 pnpm gateway:watch 命令成功运行且无报错时,后端网关服务即已正常启动。
首次访问与认证
启动后,在浏览器中访问 http://127.0.0.1:18789/openclaw/canvas/ ,页面将提示输入认证密钥。
密钥存储于本地配置文件中,路径为 C:\Users\[你的用户名]\.openclaw\openclaw.json ,文件内容结构示例如下:
安装自定义 Skills
为扩展OpenClaw的功能,可以安装社区开发的第三方Skills。请首先确保目标目录存在:C:\Users\[你的用户名]\.openclaw\workspace\skills。
以集成“百度搜索”技能为例:访问 https://clawhub.ai/ide-rea/baidu-search 下载技能压缩包。
下载后,将压缩包内所有文件解压至上述的skills目录中。
效果验证
完成Skill安装后,即可在OpenClaw界面中测试其功能。例如,尝试输入查询词“最新新闻”,系统应能成功调用已集成的百度搜索技能并返回相应结果。
至此,您已完成在Windows系统上从源代码编译、部署到功能验证的OpenClaw全流程。如需深入定制或故障排查,建议查阅项目的官方技术文档。


