OpenClaw最完整安装教程

技术社区作者：hTrust 2026-02-21 19:26:15 阅读：0

最近 OpenClaw 热度很高，但官方对 Windows 原生环境并不算友好，很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把自己完整跑通的流程整理成一篇“照做就能成”的教程：从环境准备 → OpenClaw 安装 → 初始化配置 → 最后再补一份常用排错命令。

一、环境准备

1）安装 nvm for Windows（建议用最新版）

Windows 用户到 GitHub Releases 下载 nvm-setup.exe：https://github.com/coreybutler/nvm-windows/releases

安装过程一路 Next 即可。

安装成功后建议你用管理员权限打开 PowerShell：

按 Win 键 + S

搜索 PowerShell

鼠标右键 → 以管理员身份运行

2）安装 node.js 22.22.0 版本

按照顺序分别在 powershell 中运行下列指令。

# 安装指令
nvm install 22
# 使用指令
nvm use 22.22.0

成功后会看到类似提示：Now using node v22.22.0

如果你仍然下载失败，或者公司网络拦截了下载，也可以手动去官网下载安装：https://nodejs.org/zh-cn/download

不会的可以直接点击（Node.js安装教程）

1）一键安装（PowerShell）

在管理员 PowerShell 中运行：

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

如果遇到执行策略报错（常见于首次运行脚本），在 PowerShell 输入：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2）初始化配置

安装完成后通常会自动进入配置流程。如果你不小心关闭了 PowerShell，重新打开后执行：

openclaw onboard –flow quickstart

第一个风险提示：

I understand this is powerful and inherently risky. Continue?

选择 Yes。

如果有小伙伴遇到这个问题：系统不知道它被安装在哪里了。处理方式通常很简单：

一般 nvm/环境变量会自动刷新路径，问题即可消失

之后按提示选择模型。我这里示例用的是 Kimi，你也可以按自己习惯选择。

可以看下配置，主要输入API key，其他都可以默认。

接着配置通讯工具，虽然官方这里直接可以选飞书，但官方文档明确建议 Windows 通过 WSL2 运行，并且提到原生 Windows 未测试、更容易出问题。并且我实测这里下载插件会报错，所以我们这里先跳过，后续再安装。

skill也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。

安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。

浏览器会自动打开控制台。后续你也可以直接访问：http://127.0.0.1:18789/

发消息测试，有回复就说明安装成功：