一、安装Node.js
Node.js是什么
Node.js是一个JavaScript运行时环境，OpenClaw基于Node.js开发，因此需要先安装Node.js。
下载和安装
-
访问官网下载
打开 nodejs.org，下载LTS版本（推荐22.x）
-
运行安装程序
双击下载的.msi文件，按提示完成安装，保持默认设置即可
验证安装
cmd
node --version
npm --version正常应显示版本号，如 v22.12.0
二、安装Git
Git是什么
Git是版本控制工具，某些OpenClaw功能需要Git支持。
下载和安装
-
访问官网下载
打开 git-scm.com 下载Windows版本
-
运行安装程序
按提示安装，保持默认选项即可
验证安装
cmd
git --version三、安装OpenClaw
1. 转换国内镜像
为了加快下载速度，建议切换到国内npm镜像源：
cmd
npm config set registry https://registry.npmmirror.com2. 安装OpenClaw
cmd
npm install -g openclaw@latest3. 安装验证
cmd
openclaw --version💡 注意事项
- Visual Studio Build Tools：如果安装过程中提示需要编译工具，可下载安装 Visual Studio Build Tools
- 报错信息处理：如果遇到权限错误，请以管理员身份运行CMD或PowerShell
四、初始化OpenClaw
运行初始化向导完成配置：
cmd
openclaw onboard --install-daemon配置流程
- 选择Yes：确认开始配置
- 选择启动模式：推荐选择"完整模式"
- 选择模型：可选择OpenAI或跳过稍后配置
- 浏览器授权：按照提示完成授权流程
五、配置国产大模型
推荐使用国产大模型原因
- ✅ 国内访问速度快，无需代理
- ✅ 中文理解能力强
- ✅ 价格更实惠
- ✅ 稳定可靠
模型对比
| 模型 | 特点 | 适用场景 |
|---|---|---|
| Qwen（通义千问） | 中文能力强，代码优秀 | 通用对话、编程 |
| DeepSeek | 推理能力强，性价比高 | 分析、写作 |
| GLM-4 | 多模态支持好 | 图文理解 |
| Kimi | 长文本处理强 | 文档分析 |
配置方法（以Qwen为例）
- 获得API Key：访问 阿里云DashScope 注册并获取API Key
- 运行向导配置：
cmd
openclaw config add provider dashscope按提示输入API Key，选择默认模型即可完成配置。
六、常见问题
ssh报错解决方案
如果遇到SSH相关的错误，可以尝试以下方法：
cmd
# 使用https代替ssh
git config --global url."https://".insteadOf "git://"
# 或者配置ssh密钥
git config --global http.sslVerify false⚠️ 其他常见问题
- PowerShell执行策略限制：运行
Set-ExecutionPolicy RemoteSigned修改策略 - 中文路径问题：避免在安装路径中使用中文
- 杀毒软件拦截：将OpenClaw添加到白名单