在 Windows 10 上部署 OpenClaw 的过程已经在 2026 年进一步简化,官方和社区都提供了“一键脚本”方案,您可以通过 PowerShell 快速完成安装、配置和启动。以下是基于最新信息(2026 年)的详细部署指南:
在开始之前,请确认您的电脑符合以下基本要求:
系统:Windows 10 (64位) 或 Windows 11
内存:建议 8GB 以上(如果您计划运行本地大模型,建议 16GB 以上)
磁盘空间:至少 20GB(推荐 50GB 以上,尤其是需要下载模型文件时)
OpenClaw 主要基于 Node.js 环境运行,您需要先安装 Node.js、Git 和 PowerShell 权限。
方式 A(推荐):直接下载官方 MSI 安装包
访问 Node.js 官网(nodejs.org),下载 22.x LTS 版本的 Windows Installer(.msi 文件)。
安装时务必勾选 “Add to PATH”(添加到环境变量)选项。
方式 B:使用 Windows 包管理器 (winget)
winget install OpenJS.NodeJS.LTS --version 22.1.0 -y
打开 PowerShell,执行以下命令:
访问 Git 官方网站(git-scm.com),下载并安装 64 位版本的 Git 客户端。
由于 OpenClaw 的一键安装脚本是 PowerShell 脚本,您需要解除系统的安全限制:
右键开始菜单图标,选择 “Windows PowerShell(管理员)” 以管理员身份打开终端。
执行以下命令以允许运行本地脚本:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
OpenClaw 官方提供了非常强大的“一键安装”脚本,您只需要在 PowerShell 中执行一条命令即可自动完成下载、安装和基础配置。
在管理员 PowerShell 中输入以下命令并回车:
iwr -useb https://openclaw.ai/install.ps1 | iex
此命令会从官方服务器拉取安装脚本并执行。
Code 128 错误:如果在执行过程中出现 code 128 错误,通常是因为网络环境不佳(如下载依赖被墙)。建议更换网络环境或使用加速器重试。
下载速度慢:如果下载 Node.js 或依赖时速度很慢,您可以尝试使用国内镜像源(如 cnpm)安装 Node.js 或 Git,然后重新运行脚本。
一键脚本执行完毕后,您需要进行一次快速的“引导”(Onboarding)来配置大模型和使用界面。
在同一个 PowerShell 窗口中,执行以下命令:
openclaw onboard
此命令会启动一个交互式的配置向导。
模型选择:如果您已经有本地的大模型(如 Ollama),请选择对应的模型名称;如果没有,系统会建议您使用在线模型(需要联网)。
技能安装:系统通常会默认安装一些基础技能,您可以根据需要选择安装更多技能。
配置完成后,启动 OpenClaw 服务:
openclaw start
默认情况下,OpenClaw 会在本地启动一个 Web UI 服务,监听 http://127.0.0.1:1878 。
打开您常用的浏览器(Chrome、Edge 等),在地址栏输入:
http://127.0.0.1:1878
如果看到 OpenClaw 的控制台界面,并且可以发送消息进行对话,说明部署成功了。
“node” 不是内部或外部命令:说明 Node.js 未正确添加到环境变量。请重新安装 Node.js 并勾选 “Add to PATH” 选项。
“npm -v” 提示错误:可能是 Git 未安装或 PowerShell 权限不足。确保 Git 已安装且 PowerShell 以管理员身份运行。
本地模型下载过慢:如果您打算运行本地大模型(如 Qwen3.5:9b),下载模型文件可能需要很长时间(甚至超过 10GB)。建议使用高速网络或在网络条件允许的情况下下载。
一键脚本:iwr -useb https://openclaw.ai/install.ps1 | iex
Node.js 安装:建议下载 22.x LTS 版本
PowerShell 配置:Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
【版权声明】
本站部分内容来源于互联网,本站不拥有所有权,不承担相关法律责任。如果发现本站有侵权的内容,欢迎发送邮件至masing@13sy.com 举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。