一、安装概览
本文档详细记录了在 Windows 10 环境下安装 OpenClaw v2026.2.2 的完整流程，采用源码编译方式并与 Ollama 本地模型集成。整个安装过程分为八个阶段，总耗时约 6-8 分钟。
核心安装路径 ：D:\Ai\Documents\openclaw
二、详细步骤说明
第一阶段：环境检查
步骤 1：检查 Node.js 版本
命令：
<BASH>
node --version
输出结果：
<TEXT>
v22.18.0
说明：
- Node.js v22.18.0 已预先安装
- OpenClaw 要求 Node.js 版本 ≥ 18.0.0
- 当前版本完全满足要求，可继续下一步
状态：✅ 通过
第二阶段：网络问题排查
问题发现：GitHub 连接超时
尝试命令：
<BASH>
git clone https://github.com/pjasicek/OpenClaw.git openclaw
错误输出：
<TEXT>
fatal: unable to access: Failed to connect to github.com port 443
原因分析：
- 国内网络环境限制 GitHub 访问
- 可能存在防火墙或网络代理配置问题
- 443 端口（HTTPS）连接被阻断
步骤 2：移除 Git 代理配置
命令：
<BASH>
git config --global --unset http.proxy
git config --global --unset https.proxy
说明：
- 清除可能存在的过时代理配置
- 避免代理设置导致的连接问题
- 为使用国内镜像源做好准备
状态：✅ 代理配置已清理
第三阶段：源码获取（关键步骤）
步骤 3：从 Gitee 国内镜像克隆
命令序列：
<BASH>
切换到目标目录
cd D:\Ai\Documents
从 Gitee 镜像克隆
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git openclaw
输出结果：
<TEXT>
Cloning into openclaw...
Updating files: 100% (4935/4935), done.
说明：
- 使用 Gitee 镜像源解决 GitHub 访问问题
- 克隆成功，共获取 4935 个文件
- 项目完整下载到
D:\Ai\Documents\openclaw
状态：✅ 源码获取成功
第四阶段：包管理器配置
步骤 4：全局安装 pnpm
命令：
<BASH>
npm install -g pnpm
输出结果：
<TEXT>
added 1 package in 11s
说明：
- pnpm 是 OpenClaw 指定的包管理器
- 使用
-g参数全局安装 - 安装耗时 11 秒，网络环境良好
步骤 5：配置 pnpm 国内镜像源
命令：
<BASH>
pnpm config set registry https://registry.npmmirror.com
说明：
- 使用淘宝 npm 镜像加速依赖下载
- 显著提升依赖安装速度
- 避免官方 registry 访问受限问题
状态：✅ pnpm 环境配置完成
第五阶段：项目依赖安装
步骤 6：安装项目依赖
命令序列：
<BASH>
进入项目目录
cd D:\Ai\Documents\openclaw
安装依赖
pnpm install
输出结果：
<TEXT>
Packages: +968
Done in 185s
说明：
- 成功安装 968 个依赖包
- 耗时约 3 分钟（185 秒）
- 依赖包含：前端框架、后端服务、构建工具等
状态：✅ 依赖安装完成
第六阶段：构建与验证
步骤 7：运行开发模式构建
命令：
<BASH>
pnpm dev
输出结果：
<TEXT>
Build success in 12580ms
说明：
- TypeScript 代码编译成功
- 构建耗时约 12.6 秒
- 无编译错误或警告
步骤 8：验证安装版本
命令：
<BASH>
node openclaw.mjs --version
输出结果：
<TEXT>
2026.2.2
说明：
- 确认 OpenClaw 版本为 2026.2.2
- 与预期版本一致
- 核心功能模块加载正常
状态：✅ 构建验证成功
第七阶段：快捷方式创建
步骤 9：创建桌面和开始菜单快捷方式
命令：
<POWERSHELL>
powershell -ExecutionPolicy Bypass -File create_shortcuts_simple.ps1
输出结果：
<TEXT>
Desktop shortcut created
Start Menu shortcut created
说明：
- 执行项目自带的 PowerShell 脚本
- 自动创建桌面快捷方式
- 自动添加到开始菜单
- 避免手动修改 PATH 环境变量的权限问题
状态：✅ 快捷方式创建成功
第八阶段：Ollama 本地模型配置
步骤 10：检查已安装的 Ollama 模型
命令：
<BASH>
ollama list
输出结果：
<TEXT>
qwen3:4b (2.5 GB)
gpt-oss:20b (13 GB)
说明：
- Ollama 已预先安装并配置完成
- 已有两个可用模型：
- qwen3:4b：轻量级中文模型 2.5 GB
- gpt-oss:20b：大型多语言模型 13 GB
步骤 11：设置 OpenClaw 默认模型
命令：
<BASH>
node openclaw.mjs models set ollama/qwen3:4b
输出结果：
<TEXT>
Default model: ollama/qwen3:4b
说明：
- 选择性价比高的轻量模型作为默认
- qwen3:4b 模型适合日常使用
- 资源占用相对较低（2.5 GB）
步骤 12：验证模型配置状态
命令：
<BASH>
node openclaw.mjs models status
输出结果：
<TEXT>
Default: ollama/qwen3:4b
说明：
- 确认默认模型已正确设置
- OpenClaw 与 Ollama 集成完成
- 可直接调用本地 AI 能力
状态：✅ Ollama 配置完成
三、问题与解决方案汇总
| 序号 | 问题 | 根本原因 | 解决方案 | 效果 |
|---|---|---|---|---|
| 1 | GitHub 连接超时 | 网络防火墙限制访问 443 端口 | 改用 Gitee 国内镜像源 | ✅ 完全解决 |
| 2 | Git 代理配置冲突 | 历史代理配置失效 | 执行 git config --global --unset 清理 |
✅ 配置正常 |
| 3 | npm 全局安装权限不足 | 非管理员权限 | 使用本地项目目录安装 | ✅ 绕过限制 |
| 4 | PATH 环境变量修改失败 | 需要管理员权限 | 使用 PowerShell 脚本创建快捷方式 | ✅ 功能正常 |
四、完整命令清单
<BATCH>
:: ==================== 环境检查 ====================
node --version
:: ==================== 网络问题处理 ====================
git config --global --unset http.proxy
git config --global --unset https.proxy
:: ==================== 源码获取 ====================
cd D:\Ai\Documents
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git openclaw
:: ==================== 包管理器配置 ====================
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com
:: ==================== 安装依赖 ====================
cd D:\Ai\Documents\openclaw
pnpm install
:: ==================== 构建验证 ====================
pnpm dev
node openclaw.mjs --version
:: ==================== 快捷方式创建 ====================
powershell -ExecutionPolicy Bypass -File create_shortcuts_simple.ps1
:: ==================== Ollama 模型配置 ====================
ollama list
node openclaw.mjs models set ollama/qwen3:4b
node openclaw.mjs models status
五、安装后验证清单
- Node.js 版本 ≥ 18.0.0
- 源码完整下载（4935 个文件）
- pnpm 全局安装并配置镜像
- 968 个依赖包安装成功
- TypeScript 编译通过
- 版本验证通过（2026.2.2）
- 桌面快捷方式已创建
- Ollama 模型已集成
- 默认模型设置为 qwen3:4b
六、后续使用建议
启动 OpenClaw
双击桌面快捷方式，或在命令行执行：
<BASH>
cd D:\Ai\Documents\openclaw
pnpm dev
切换模型
如需切换到大模型：
<BASH>
node openclaw.mjs models set ollama/gpt-oss:20b
node openclaw.mjs models status
更新项目
<BASH>
cd D:\Ai\Documents\openclaw
git pull
pnpm install
pnpm dev
安装完成时间 ：2026年2月24日
总体状态 ：✅ 安装成功，OpenClaw 已就绪！
咨询信息较多，欢迎留言~