Windows 完整安装 OpenClaw！最完整安装教程 + 飞书接入，全程避坑

123次浏览
原创
帖子类型：服务器
2026/03/05 12:29:51

最近 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 中运行下列指令。

代码语言：PowerShell

window 里面打开PowerShell窗口输入如下命令：

# 安装指令
nvm install 22

# 使用指令
nvm use 22.22.0

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

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

二、安装 + 配置 OpenClaw

1）一键安装（PowerShell）

在 window 里面打开 管理员权限的 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。

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

关闭当前 PowerShell
重新用管理员方式打开 PowerShell
一般 nvm/环境变量会自动刷新路径，问题即可消失

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

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

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

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

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

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

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

如果遇到报错

unauthorized: too many failed authentication attempts (retry later) openclaw 报上面的错误

当你遇到 Gateway service install failed with error: unauthorized: too many failed authentication attempts (retry later) 错误时，说明 OpenClaw 网关在安装过程中尝试进行身份验证时失败次数过多，触发了安全机制。这通常发生在配置错误或环境异常的情况下。