Windows 10 安装 OpenClaw 完整指南(2026 最新版)
前言
OpenClaw 是一款自托管的 AI 网关工具,可以将 AI 智能体接入你的日常聊天工具(飞书、Telegram、微信等),实现 AI 自动处理邮件、管理日历、网页搜索、文件操作等功能。本文详细介绍在 Windows 10 系统上安装 OpenClaw 的最简方案——Windows Hub。
一、准备工作(安装前必做)
1.1 硬件要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 64 位,2 核以上 | 4 核以上(Intel/AMD) |
| 内存 | 8 GB | 16 GB |
| 硬盘 | 10 GB 空闲 | SSD |
| 操作系统 | Windows 10 64bit (1903+) | 20H2+ |
| 虚拟化 | BIOS 已开启(VT-x / SVM) | — |
| 网络 | 稳定互联网 | 能访问 GitHub |
1.2 开启 CPU 虚拟化
这是最关键的一步。打开任务管理器 → 性能 → CPU,查看右下角「虚拟化」状态:
- 已启用 → 跳过此步
- 已禁用 → 重启进 BIOS 开启:Intel 叫
VT-x(或 Intel Virtualization Technology),AMD 叫SVM Mode
1.3 启用 WSL 功能
以管理员身份打开 PowerShell,执行以下命令(如果提示重启则重启):
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
1.4 准备 AI API Key
OpenClaw 需要连接 AI 模型才能工作,提前准备好一个 Key:
| 提供商 | 费用 | 推荐场景 |
|---|---|---|
| Google Gemini | 有免费额度 | 新手首选,零成本上手 |
| Ollama(本地) | 完全免费 | 本地运行,无需联网 |
| 硅基流动 | 价格便宜 | 国内直连,网络友好 |
| DeepSeek | 价格便宜 | 国产模型,性价比高 |
二、安装 OpenClaw(两种方案)
方案 A:Windows Hub(推荐,图形界面)
适用人群:普通用户,不想敲命令,想要桌面体验。
操作系统要求:Windows 10 20H2 及以上版本。
第一步:打开浏览器访问 Windows Hub 发布页面,下载 OpenClawCompanion-Setup-x64.exe。
第二步:双击安装包,一路默认安装。无需管理员权限。
第三步:从开始菜单启动 OpenClaw Companion。
- 首次启动会弹出设置界面,选择 Set up locally(本地设置)
- 它会自动创建一个专属的
OpenClawGatewayWSL 环境,在其中安装 Gateway 核心服务 - 此过程不影响你已有的 WSL/Ubuntu 系统
第四步:等待系统托盘图标变绿 ✅,表示 Gateway 运行成功。
第五步:打开浏览器访问 http://localhost:18789,进入 Dashboard 控制面板。
方案 B:PowerShell 一键安装(命令行)
适用人群:习惯命令行的用户。
以管理员身份打开 PowerShell,粘贴:
iwr -useb https://openclaw.ai/install.ps1 | iex
安装器会自动检测并安装 Node.js(如果需要),然后安装 OpenClaw,最后启动引导向导。
安装完成后:
openclaw --version openclaw doctor openclaw gateway openclaw dashboard
三、安装后设置
3.1 设置为开机自启
openclaw gateway install
这会创建一个 Windows 定时任务,开机自动后台运行 Gateway。
3.2 验证一切正常
openclaw doctor
正常输出示例:
✔ Node.js version: v24.x.x ✔ openclaw version: 2026.x.x ✔ Gateway configured (mode: local) ✔ Gateway running on ws://127.0.0.1:18789 ✔ Gateway service installed
3.3 关闭电脑睡眠
OpenClaw 需要持续运行,建议将电源设置改为:设置 → 系统 → 电源与睡眠 → 睡眠设为「从不」。
四、常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
npm.ps1 cannot be loaded | PowerShell 禁止脚本执行 | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
EBADENGINE Unsupported engine | Node.js 版本太低 | 升级到 ≥ 22.22.3 |
| 托盘图标不出现 | 应用未正常启动 | 检查任务管理器 OpenClaw.Tray.WinUI.exe |
| 本地设置失败 | WSL 问题/网络问题 | 检查日志:%LOCALAPPDATA%\OpenClawTray\Logs\ |
| Gateway 无法访问 | 服务未启动 | openclaw gateway 手动启动 |
| GitHub 连接超时 | 网络限制 | 使用代理或 VPN |
总结
在 Windows 10 上安装 OpenClaw 的核心准备只有三件事:开 BIOS 虚拟化 + 启用 WSL 功能 + 准备 API Key。剩下的全部由 Windows Hub 自动化完成。装好后你的 Windows 电脑就变成了一个 24 小时在线的 AI 助理节点。
