OpenClaw Windows 安装教程
本文档介绍在 Windows 系统上安装 OpenClaw 的步骤。OpenClaw 是一个可运行在自有设备上的个人 AI 助手，支持 WhatsApp、Telegram、Slack、Discord 等多种消息渠道。
环境要求
- 操作系统：Windows 10 或更高版本
- Node.js：版本 ≥ 22（推荐 ≥ 22.12.0）
- Git：建议提前安装，防止后期运行报错
1. 安装 Node.js（版本 ≥ 22）
OpenClaw 依赖 Node.js 运行，请确保安装 Node.js 22 或更高版本。
方式一：官网下载安装（推荐）
- 打开 Node.js 官网：nodejs.org/
- 选择 LTS（长期支持） 版本，当前 LTS 为 Node.js 22.x
- 下载 Windows 安装包（
.msi或.exe） - 运行安装程序，按提示完成安装
- 安装时建议勾选 "Add to PATH"，以便在命令行中使用
node和npm
方式二：使用 winget（Windows 包管理器）
在 PowerShell 或命令提示符中执行：
winget install OpenJS.NodeJS.LTS
方式三：使用 nvm-windows（多版本管理）
如需管理多个 Node.js 版本，可使用 nvm-windows：
- 下载并安装 nvm-windows
- 安装 Node.js 22：
nvm install 22
nvm use 22
验证安装
安装完成后，打开新的 PowerShell 或命令提示符窗口，执行：
node -v
应显示 v22.x.x 或更高版本（如 v22.12.0）。
npm -v
应显示 npm 版本号。
2. 安装 Git（防止后期运行报错）
OpenClaw 部分功能依赖 Git，建议提前安装以避免运行时报错。
方式一：官网下载安装（推荐）
- 打开 Git 官网：git-scm.com/download/wi…
- 下载 Windows 安装包
- 运行安装程序，按提示完成安装
- 安装时建议勾选 "Git from the command line and also from 3rd-party software"，以便在命令行中使用
git
方式二：使用 winget
winget install Git.Git
验证安装
git --version
应显示 Git 版本号（如 git version 2.x.x）。
3. 安装 OpenClaw
Node.js 和 Git 安装完成后，按以下步骤安装 OpenClaw。
以管理员方式打开终端
右键点击 PowerShell 或 命令提示符，选择 “以管理员身份运行”。建议使用 PowerShell，以避免安装命令执行过严导致失败。
放宽 PowerShell 执行策略
在 PowerShell 中依次输入以下命令，出现提示时一路输入 y 并回车：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
执行官方安装命令
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
提示：若在 PowerShell 中执行
curl | bash报错，可改用 Git Bash（随 Git 安装）运行上述命令。
等待安装完成。
验证安装
openclaw --version
4. 配置 OpenClaw 与模型
安装完成后，即可通过指令进行 OpenClaw 的配置与模型设置。
快速入门（向导模式）
openclaw onboard --install-daemon
向导会引导你完成网关、工作区、渠道、模型和技能的配置。
启动 Gateway 网关
openclaw gateway --port 18789 --verbose
5. 对接飞书（可选）
如需将 OpenClaw 对接飞书，需在飞书开放平台开通权限并配置事件回调。
开通权限
在飞书开放平台开通应用权限：
飞书开放平台：open.feishu.cn/app/cli_a93…
在此链接中为你的应用开通所需权限。
配置事件与回调（重要）
- 在飞书开放平台左侧菜单点击 「事件与回调」
- 本步骤很重要：需要本地运行代码实现长连接，以接收飞书的事件推送
长连接配置文档：open.feishu.cn/document/se…
按官方文档配置请求 URL 与长连接后，即可完成飞书对接。
推荐：使用 WSL2 安装（更稳定）
OpenClaw 官方推荐在 Windows 上通过 WSL2（建议 Ubuntu）运行，以获得更好的兼容性和工具支持。若在原生 Windows 下遇到问题，可参考官方文档使用 WSL2 方式安装：
常见问题
Node.js 版本过低
若提示 Node.js 版本不满足要求，请升级到 22 或更高版本后重试。
命令无法识别
若 openclaw 命令无法识别，请确认：
- Node.js 已正确安装且已加入 PATH
- 使用新的 PowerShell/命令提示符窗口
- 全局安装路径是否在 PATH 中（通常为
%APPDATA%\npm）
