Windows下载OpenClaw源码，启动和安装攻略

关注前端小讴，原创技术文章

官方文档 →

安装向导

• 1.安装node，推荐版本24，最低版本22.16+，推荐使用nvm控制node版本

• 2.安装pnpm
  npm install -g pnpm

• 3.克隆并构建

  • git clone https://github.com/openclaw/openclaw.git
  • cd openclaw
  • pnpm install
  • pnpm ui:build
  • pnpm build

• 4.链接cli，让openclaw命令全局可用
  pnpm link --global

验证：命令行输入openclaw，有相关提示

报错及解决方法

• 用管理员打开命令行/powershell

• pnpm install报错Error error code 3221225477

  • 降级node到22版本
  • 安装C++构建工具
    • 下载Visual Studio Build Tools 2022
  • 运行安装器，工作负载列表中只勾选“使用 C++ 的桌面开发”
  • 完成后需重启电脑，重新install即可（建议删掉node_modules和pnpm-lock.yaml并执行pnpm store prune）

  参考方案 →

• pnpm build报错scripts/bundle-a2ui.sh: line 31: node: command not found

  • 创建scripts/bundle-a2ui.mjs

    // scripts/bundle-a2ui.mjs// OpenClaw A2UI Bundle Placeholder Generator// For public repository users who do not have access to private A2UI source code.// This script creates a minimal valid ES module to satisfy TypeScript compilation.importfsfrom"node:fs";importpathfrom"node:path";import{createHash}from"node:crypto";import{fileURLToPath}from"node:url";// ── Resolve project root directory correctly on Windows and Unix ──const__filename=fileURLToPath(import.meta.url);const__dirname=path.dirname(__filename);constROOT_DIR=path.resolve(__dirname,"..");// openclaw/ root// ── Define output paths ──constOUTPUT_DIR=path.join(ROOT_DIR,"src","canvas-host","a2ui");constOUTPUT_FILE=path.join(OUTPUT_DIR,"a2ui.bundle.js");constHASH_FILE=path.join(OUTPUT_DIR,".bundle.hash");// ── Ensure output directory exists ──fs.mkdirSync(OUTPUT_DIR,{recursive:true});// ── Generate placeholder content (valid ES module) ──constplaceholderContent=`// Auto-generated placeholder for A2UI // Source code is not available in the public OpenClaw repository. // This file exists only to satisfy build dependencies. export const A2UI = { version: '0.0.0-placeholder', render: () => { throw new Error('A2UI runtime is not available in this build.'); } };`.trim()+"\n";// ── Write the bundle file ──fs.writeFileSync(OUTPUT_FILE,placeholderContent);// ── Compute and write hash to prevent unnecessary rebuilds ──consthash=createHash("sha256").update(placeholderContent).digest("hex");fs.writeFileSync(HASH_FILE,hash);// ── Success message ──console.log("✅ A2UI placeholder bundle created successfully.");console.log(`Bundle:${OUTPUT_FILE}`);console.log(`Hash:${HASH_FILE}`);

  • 在package.json中替换脚本

    {"scripts":{//..."canvas:a2ui:bundle":"node --import tsx scripts/bundle-a2ui.mjs"}}

  参考方案 →

新手向导

openclaw onboard --install-daemon

• I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?（风险告知）

  • Yes

• Setup mode（选择配置模式）

  • QuickStart

• Model/auth provider（选择执行模型）

  • Skip for now（暂时跳过）

• Filter models by provider（选择供应商）

  • All providers

• Default model（默认模型）

  • Keep current

验证：全部显示✅即表示配置成功。

启动向导

• 1.运行诊断命令
  pnpm openclaw doctor

  • 依次提示“是否创建token”、“是否创建.openclaw文件夹”等，均选择Yes
  • 完成后，会在C:\Users\${userName}\里创建.openclaw文件夹

• 2.配置本地网关
  openclaw config set gateway.mode local

• 3.启动本地网关
  openclaw gateway

• 4.在浏览器打开（默认http://127.0.0.1:18789）

验证：可在浏览器打开初始化连接界面

相关配置

• 配置文件位置：C:\Users\${userName}\openclaw.json
• 如已一键安装过OpenClaw，建议备份整个.openclaw文件夹，并选择性覆盖

token

• 初始化界面输入token并连接，然后在控制-概览里配置网关令牌

模型

// openclaw.json{// ...,"models":{"providers":{"DeepSeek":{"baseUrl":"xxx",// 替换即可"apiKey":"xxx",// 替换即可"api":"openai-completions","models":[{"id":"xx",// 替换即可"name":"DeepSeek-V3.2 (非思考模式)","reasoning":false,"input":["text"],"cost":{"input":0,"output":0,"cacheRead":0,"cacheWrite":0},"contextWindow":128000,"maxTokens":8192}]}}}}