OpenClaw 用 winget 一键安装:Windows 最简单、最现代的 AI 部署方案
教程说明:winget 是微软在 Windows 10/11 中内置的官方包管理器(Windows Package Manager),自 Windows 10 21H2 起预装,让 Windows 用户也能像 Linux 用户那样用命令行安装软件。本教程将完整演示如何通过 winget 在 Windows 上安装 Node.js 22 和 OpenClaw AI 助手,实现一条命令完成全部依赖部署,告别繁琐的手动下载安装流程。
winget 是什么?为什么它是安装 OpenClaw 的最佳方式
winget(Windows Package Manager)是微软在 2020 年推出的官方包管理器,类似于 macOS 的 Homebrew 或 Linux 的 apt/dnf。通过 winget,你可以用一行命令安装、更新、卸载数千款软件,无需手动去官网下载安装包,无需担心版本是否最新,系统会自动处理一切。
在安装 OpenClaw 的场景中,winget 的优势格外明显:你只需打开终端输入两行命令,就可以完成 Node.js 的安装,而不需要打开浏览器、找到下载页面、下载安装程序、双击运行、点击下一步……整个过程自动化、可重复、易于维护。此外,winget 安装的软件可以统一通过 winget upgrade --all 一键更新,保持 OpenClaw 始终运行最新版本。
第一步:确认 winget 可用
在开始之前,先确认你的 Windows 系统已经具备 winget。以管理员身份打开 PowerShell(右键开始菜单 → "Windows PowerShell (管理员)"),输入:
# 检查 winget 版本
winget --version
# 应该显示类似 v1.8.x 的版本号
# 如果提示 "winget" 不是命令,说明需要安装
✅ winget 已可用(显示版本号)
直接进入第二步,无需额外操作。
⚠️ winget 不可用(提示命令不存在)
打开 Microsoft Store,搜索 "App Installer",点击安装/更新。App Installer 包含了 winget,更新完成后重新打开 PowerShell 即可使用。Windows 10 21H2+ 和 Windows 11 已内置,但可能需要通过 Store 更新到最新版。
第二步:用 winget 安装 Node.js 22
winget 提供了直接安装特定版本 Node.js 的能力。以下命令会安装 Node.js LTS(当前为 v22):
# 安装 Node.js LTS(推荐,自动选择最新 LTS 版本)
winget install OpenJS.NodeJS.LTS
# 或者安装特定版本(确保是 v22)
winget install OpenJS.NodeJS.LTS --version 22.14.0
# 安装完成后,打开新的 PowerShell 窗口(重要!PATH 需要刷新)
# 然后验证
node --version # 应显示 v22.x.x
npm --version # 应显示 10.x.x
winget 安装的优势
与手动下载安装包相比,winget 安装有以下优势:
- • 自动配置 PATH:安装后重开终端即可直接使用,无需手动添加环境变量
- • 签名验证:winget 会自动验证软件包的数字签名,确保来源可信
- • 一键更新:日后只需
winget upgrade OpenJS.NodeJS.LTS即可更新到最新版本
第三步:安装 OpenClaw
Node.js 就绪后,使用官方 PowerShell 安装脚本安装 OpenClaw:
# 方法一:官方 PowerShell 一键安装脚本(推荐)
iwr -useb https://openclaw.ai/install.ps1 | iex
# 方法二:npm 安装(已有 Node.js 22 的前提下)
npm install -g openclaw@latest
# 验证安装
openclaw --version
# 运行初始配置向导
openclaw onboard
遇到执行策略限制?
如果 PowerShell 提示"此系统上禁止运行脚本",需要临时允许脚本执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 然后重新运行安装命令
终极方案:winget + npm 完全自动化脚本
如果你是 Windows 管理员,需要在多台机器上部署 OpenClaw,或者想把安装过程做成可重复的自动化脚本,以下是终极一键部署方案:
# ===== OpenClaw 一键部署脚本 =====
# 以管理员身份运行此脚本
Write-Host "步骤 1/4: 安装 Node.js 22 LTS..." -ForegroundColor Cyan
winget install OpenJS.NodeJS.LTS --silent --accept-package-agreements
Write-Host "步骤 2/4: 刷新环境变量..." -ForegroundColor Cyan
$env:PATH = [System.Environment]::GetEnvironmentVariable("PATH", "Machine")
Write-Host "步骤 3/4: 安装 OpenClaw..." -ForegroundColor Cyan
npm install -g openclaw@latest
Write-Host "步骤 4/4: 验证安装..." -ForegroundColor Cyan
openclaw --version
Write-Host "✅ 安装完成!运行 'openclaw onboard' 开始配置" -ForegroundColor Green
第五步:首次配置与 Windows 服务注册
OpenClaw 安装完成后,运行 onboard 配置向导,并将其注册为 Windows 服务实现开机自启:
# 运行首次配置向导(同时安装 Windows 守护进程服务)
openclaw onboard --install-daemon
# 配置完成后,检查服务状态
openclaw gateway status
# 打开 Dashboard 控制台(默认浏览器打开)
openclaw dashboard
# 发送测试消息(需已配置 Telegram 频道)
openclaw message send --target "@你的用户名" --message "Hello from OpenClaw!"
给 AI 助手起名字
输入你想要的 AI 助手名称,将出现在 Telegram 等渠道的消息中。
输入 Anthropic API Key
粘贴 Anthropic Claude API Key(以 sk-ant- 开头)。前往 console.anthropic.com 可免费获取试用额度。
配置 Telegram Bot
打开 Telegram → 搜索 @BotFather → /newbot → 获取 Token → 粘贴到配置中。完成后 Telegram 中即可与 AI 对话。
用 winget 管理 OpenClaw 的完整生命周期
winget + npm 组合给 OpenClaw 的管理带来了前所未有的便捷性:
| 操作 | 命令 |
|---|---|
| 更新 Node.js | winget upgrade OpenJS.NodeJS.LTS |
| 更新 OpenClaw | npm update -g openclaw |
| 查看 OpenClaw 版本 | openclaw --version |
| 检查运行健康 | openclaw doctor |
| 重启服务 | openclaw gateway restart |
| 一键更新全部依赖 | winget upgrade --all |
winget vs 其他安装方式对比
为什么我们推荐 winget 而不是其他安装方式?以下对比让你一目了然:
✅ winget(推荐)
最优雅- • 微软官方工具,Windows 10/11 内置,零门槛
- • 软件包经过数字签名验证,安全可信
- • 一键更新所有软件包,维护成本极低
- • 可编写批量部署脚本,适合企业环境
官网手动下载
繁琐- • 需要打开浏览器找下载页面,耗时
- • 容易下载错版本(x86 vs x64)
- • 更新需要重复手动操作
Chocolatey(第三方)
额外安装- • 需要额外安装 Chocolatey 本体
- • 非微软官方工具,有安全顾虑
- • 包质量参差不齐
常见问题与解决方案
❌ winget 安装 Node.js 后 node 命令找不到
关闭并重新打开 PowerShell 窗口(winget 安装后需要刷新 PATH)。如仍无效,手动将 Node.js 路径添加到系统 PATH:C:\Program Files\nodejs。
⚠️ winget 下载速度慢或失败
winget 的软件包通过 GitHub 分发,国内访问速度较慢。建议连接 VPN07 后再运行 winget 命令,1000Mbps 千兆带宽可将 Node.js 安装包(约 25MB)的下载时间缩短到 1 秒以内。
💡 OpenClaw API 调用失败
国内 Windows 用户访问 Claude/OpenAI API 需要 VPN。确保 VPN07 已开启系统代理模式,或在 OpenClaw 配置文件中手动设置代理地址:在 %APPDATA%\openclaw\config.yml 中添加代理配置。
🔒 Windows Defender 阻止安装
如果 Windows Defender 弹出警告,点击"更多信息" → "仍要运行"。OpenClaw 是开源软件,其数字签名在 winget 安装前已经过验证。也可将 OpenClaw 安装目录添加到 Defender 排除列表中。
OpenClaw 在 Windows 上能帮你做什么
通过 winget 完成安装后,你的 Windows 电脑就升级为了一台 24 小时运行的 AI 工作站。以下是 Windows 用户最常用的 OpenClaw 应用场景,帮助你快速上手:
Outlook 邮件自动化
- • 每日早上自动汇总收件箱重要邮件
- • 识别紧急邮件并 Telegram 推送提醒
- • 自动分类和归档邮件
Office 文件处理
- • 通过 PowerShell 自动处理 Excel 数据
- • 批量生成 Word 报告模板
- • 自动转换和整理 PDF 文件
个人效率提升
- • 番茄工作法计时与提醒
- • 网页内容摘要推送到 Telegram
- • 本地文件智能搜索与整理
开发工作流
- • 监控 GitHub Actions 构建结果
- • 自动运行测试套件并报告
- • Cursor/VS Code 任务远程触发
winget 带来的便捷安装只是第一步,OpenClaw 在 Windows 上的真正价值在于它打通了你的数字生活:从 Telegram 发一条消息,你的 Windows 电脑就开始行动,查资料、写报告、发邮件、提醒日程……一切都在你不在电脑前的时候自动完成。这就是 AI 助手该有的样子。
VPN07 — Windows 用户的 AI 网络加速首选
Windows 原生客户端 · winget 安装支持
用 winget 安装 OpenClaw,网络质量决定了整个体验——从下载软件包到调用 AI API,都需要稳定快速的国际连接。VPN07 运营十年,提供 Windows 原生图形界面客户端,开机自动连接,对 Windows 系统代理完美兼容。1000Mbps 千兆带宽让 winget 下载、npm 安装、Claude API 调用全部飞速完成,70+ 国家 200+ 节点随心切换,30天退款保证零风险。月费仅 ¥9,Windows 用户运行 OpenClaw 的最优选择。