OpenClaw安装配置指南

创想小编 · 发表于 2 小时前

作者：CSDN博客
一、下载node.js

Node.js — 在任何地方运行 JavaScript

判断电脑是否已经安装了Node.js
（1）通过运行命令行进行检查打开命令行工具，在Windows系统上，按 Win + R 键，输入 cmd，然后按 Enter。

输入 node -v 这个指令回车，显示版本号就代表已经安装Node.js

二、安装Nvm

nvm（Node Version Manager）是一个用于管理 Node.js 版本的命令行工具。它允许开发者在同一台机器上安装和切换多个版本的 Node.js，以便于在不同的项目中使用不同的 Node.js 版本。
开始下载nvm - nvm中文官网

注意，如果已经安装了node.js ,这里要允许控制安装的版本

安装完成弹出如下界面

三、安装git

Git - Install for Windows

推荐清华大学镜像下载站，速度更快
Index of /github-release/git-for-windows/git/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

安装一直点next就

验证电脑是否已经安装了Git
命令提示符（CMD）验证
1.打开命令提示符
Win + R，输入 cmd，回车
2.验证 Git 版本
git --version
3.查看 Git 安装路径
where git
PowerShell 验证
1.验证 Git 命令是否可用
Get-Command git
2.查看 Git 版本
git --version
3.查看环境变量中的 Git 路径
$env:Path -split ';' | Select-String git

四、安装OpenClaw

拉取 OpenClaw 本地源码
1、在任务栏点击搜索按钮，搜索PowerShell，这里要注意"以管理员的身份运行"

2、为了避免 Windows 默认安全策略拦截脚本，先运行以下指令并输入 Y 回车同意：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
OpenClaw 国内镜像安装

#配置npm国内镜像地址
npm config set registry https://registry.npmmirror.com/

复制代码

换成国内的淘宝镜像后，检查

官网文档给出的安装命令是npm install -g openclaw@latest，这个在安装过程中控制台是没有日志输出的，本来这个安装耗时就比较长，这个过程中再没有内容输出，我们心里会很没有底。可以在后边加上–verbose，像这样：npm install -g openclaw@latest --verbose
在执行安装命令之前，我们可以通过npm show openclaw来查看一下 OpenClaw 的信息

通过npm show openclaw versions来查看一下 OpenClaw 的所有版本

通过openclaw@latest安装的是最新版本，我们看到当前 latest 指向的是 2026.4.9。那如果我们想要安装其它版本怎么办呢？只要将 latest 替换成具体的版本号就可以了，比如，我想安装之前的 2026.3.28这个版本，那么只要openclaw@2026.3.28就可以了。OpenClaw 的版本命名规则也很特别，采用基于日期的日历版本号规则。
再来解释一下命令-g 的含义，-g = --global = 全局安装，作用是把包安装到「整个系统都能用」的位置，而不是只安装在当前项目文件夹里。
接下来，就是正式的安装了，我们执行npm install -g openclaw@latest --verbose，可以看到这时候的安装是实时有日志在控制台输出的。
我们在这里装2026.3.28版本，所以使用npm install -g openclaw@2026.3.28 --verbose

在下载界面等待1-3分钟，无报错即安装成功，安装完成后如下图。

验证 OpenClaw 有没有安装成功，一种是通过 OpenClaw 本身，我们执行openclaw --version看看可不可以输出版本号

另一种是 npm 的方式，我们执行npm ls -g openclaw，看一下全局有没有安装 openclaw

五、配置OpenClaw

OpenClaw 安装好首次配置一定要使用openclaw onboard --install-daemon，因为这时候工作目录~\.openclaw还没有建立，配置文件也没有，这条命令除了引导我们配置之外，还会帮我们把工作目录这些必要的环境准备好，这一步暂且称之为“Onboarding”，大概就是初次使用的意思；之后，如果有一些配置需要再次调整或添加的，就可以不用 Onboarding 的命令了，一般可以通过openclaw configure，或者是手动修改配置文件的方式。
使用openclaw onboard --install-daemon开始配置