OpenClaw 安装与初始化指南windows

OpenClaw 安装与初始化指南

1. 环境准备
   1.1 配置 PowerShell 执行策略
   首次运行 PowerShell 脚本时，建议先执行以下命令：

Windows PowerShell
版权所有 (C) Microsoft Corporation。保留所有权利。

尝试新的跨平台 PowerShell https://aka.ms/pscore6

PS C:\Windows\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为"N"): y
PS C:\Windows\system32> Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

执行策略更改
执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170
中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略?
[Y] 是(Y)  [A] 全是(A)  [N] 否(N)  [L] 全否(L)  [S] 暂停(S)  [?] 帮助 (默认值为"N"): y
PS C:\Windows\system32>

说明：

第一条命令用于允许当前用户执行本地脚本。

第二条命令仅对当前 PowerShell 会话生效，适合临时安装时使用。

1.2 安装基础软件

请先安装以下软件：

Git

Node.js

安装完成后，执行以下命令检查是否安装成功.

(1)在 Windows 上安装

在 Windows 上安装 Git 也有几种安装方法。 官方版本可以在 Git 官方网站下载。 打开 https://git-scm.com/download/win，下载会自动开始。 要注意这是一个名为 Git for Windows 的项目（也叫做 msysGit），和 Git 是分别独立的项目；更多信息请访问 http://msysgit.github.io/。

要进行自动安装，你可以使用 Git Chocolatey 包。 注意 Chocolatey 包是由社区维护的。

另一个简单的方法是安装 GitHub Desktop。 该安装程序包含图形化和命令行版本的 Git。 它也能支持 Powershell，提供了稳定的凭证缓存和健全的换行设置。 稍后我们会对这方面有更多了解，现在只要一句话就够了，这些都是你所需要的。 你可以在 GitHub for Windows 网站下载，网址为 GitHub Desktop 网站。

Microsoft Windows [版本 10.0.19045.4894]
(c) Microsoft Corporation。保留所有权利。

C:\Users\wqbboy>git --version
git version 2.55.0.windows.3

下载安装 Node.js

1.下载安装包 ：

访问 Node.js 官方下载页面。

测试安装

按下 win + r 键，输入cmd，打开cmd窗口。

输入以下命令并回车，验证版本信息：

node -v   // 检查 Node.js 版本  
npm -v    // 检查 npm 版本

Windows PowerShell
版权所有 (C) Microsoft Corporation。保留所有权利。

尝试新的跨平台 PowerShell https://aka.ms/pscore6

PS C:\Users\wqbboy> node -v
v24.18.0
PS C:\Users\wqbboy> npm -v
11.16.0
PS C:\Users\wqbboy>

2. 安装 OpenClaw 说明： • 原版 OpenClaw 适合直接使用官方版本的用户。 • openclaw-cn 为国内社区优化版，更适合中国大陆网络环境。 2.1 方法一：使用安装脚本

1.3 配置 npm 国内镜像源

为提升依赖下载速度，建议配置国内镜像源：

npm config set registry https://registry.npmmirror.com  

如需恢复官方源，可执行：

npm config set registry https://registry.npmjs.org  

1.4 配置 Git

配置 Git 使用 HTTPS 替代 SSH：

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"  

配置 GitHub 镜像站（可选）：

如果直接访问 GitHub 不稳定，可执行：

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"  

取消 Git 代理（可选）：

如果之前配置过 Git 代理，可执行：

git config --global --unset https.proxy  

2. 安装 OpenClaw
   说明：

原版 OpenClaw 适合直接使用官方版本的用户。

openclaw-cn 为国内社区优化版，更适合中国大陆网络环境。

2.1 方法一：使用安装脚本

2.1.1 安装原版 OpenClaw

iwr -useb https://openclaw.ai/install.ps1 | iex  

2.1.2 安装国内加速版 OpenClaw CN

如果官方脚本下载较慢，可使用国内加速安装脚本：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex  

出现安装成功提示，

openclaw doctor

3. 初始化配置 执行以下命令进入初始化向导：

openclaw onboard  

配置大模型