Windows 下安装OpenClaw

在 Windows 系统下安装 OpenClaw，最推荐的方式是使用官方提供的一键安装脚本。整个过程自动化程度很高，通常 5-10 分钟内即可完成。

请严格按照以下步骤操作，可以避免绝大多数问题。

🚀 一键安装部署

这是最简单、最快捷的安装方式，脚本会自动处理 Node.js 环境、权限配置和依赖安装。

1. 以管理员身份运行 PowerShell
* 点击屏幕左下角的“开始”菜单或搜索图标。
* 输入 PowerShell。
* 在搜索结果中，右键点击“Windows PowerShell”，然后选择 “以管理员身份运行”。
* 在弹出的用户账户控制（UAC）窗口中，点击“是”。

2. 解锁脚本执行权限
Windows 默认禁止运行远程脚本，需要先手动授权。在管理员 PowerShell 窗口中，复制并粘贴以下命令，然后按回车键执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

如果系统提示确认，请输入 Y 或 A 并按回车。

3. 执行一键安装命令
继续在同一个 PowerShell 窗口中，复制并粘贴官方安装命令，然后按回车：
iwr -useb https://openclaw.ai/install.ps1 | iex

* 提示：如果下载速度很慢或出现网络超时，可以替换为国内镜像源命令：
iwr -useb https://clawd.org.cn/install.ps1 | iex

脚本会自动开始运行，它会检测并安装 Node.js、配置环境、下载并安装 OpenClaw 核心程序。这个过程大约需要 3-8 分钟，请耐心等待，期间无需任何手动操作。

4. 验证安装是否成功
安装脚本提示“OpenClaw installed successfully”后，关闭当前的管理员 PowerShell 窗口。
然后，重新打开一个普通的 PowerShell 窗口（无需管理员身份），输入以下命令并回车：
openclaw --version

如果屏幕上成功显示出类似 2026.3.7 的版本号，恭喜你，OpenClaw 的核心程序已经成功安装在你的电脑上了！

⚙️ 初始化配置与启动

安装完成只是第一步，接下来需要配置你的 AI“大脑”并启动服务。

1. 启动配置向导
在普通的 PowerShell 窗口中，输入以下命令开始初始化配置：
openclaw onboard --flow quickstart

系统会进入一个交互式的问答流程，你只需要跟着提示操作即可：
* 风险提示：选择 yes 并回车。
* 安装模式：选择 quick start（快速安装）。
* 模型选择：对于新手，推荐选择 千问（Qwen） 或 Kimi 等国内模型，它们速度快且通常有免费额度。选择后，系统可能会自动打开浏览器让你登录并获取 API Key，按照网页提示操作即可。
* 其他配置：后续的频道、技能等配置可以先全部选择 skip 跳过，以后可以在管理面板中随时设置。

2. 启动 OpenClaw 服务
配置完成后，在 PowerShell 中输入以下命令来启动 OpenClaw 网关服务：
openclaw start

等待终端显示 Gateway started successfully 之类的成功日志，就表示服务已经启动。

3. 打开管理面板
打开你常用的浏览器（如 Chrome 或 Edge），在地址栏输入以下地址并回车：
http://127.0.0.1:18789

你将看到 OpenClaw 的控制台登录界面。首次登录可能需要输入在配置过程中生成的 Token，请根据终端提示或面板指引操作。

🛠️ 常见安装问题排查

如果在安装过程中遇到问题，可以对照以下列表进行排查。
问题现象 可能原因 解决方案
npm.ps1 cannot be loaded PowerShell 脚本执行被禁止 重新执行第 2 步的 Set-ExecutionPolicy 命令。
Could not find Visual Studio 或 node-gyp 编译失败 缺少 C++ 编译工具 下载并安装 Microsoft Visual Studio Build Tools，安装时务必勾选 “使用 C++ 的桌面开发” 工作负载。
安装命令无反应或网络超时 网络连接问题 尝试使用第 3 步中提供的国内镜像源命令进行安装。
openclaw: command not found 环境变量未生效 关闭所有 PowerShell 窗口后重新打开一个，或重启电脑。