Windows部署OpenClaw
Windows系统OpenClaw部署:2026.3.13版安装问题解决方案
本文将指导你于Windows PowerShell环境完成OpenClaw(2026.3.13版本)的完整部署。相比macOS,Windows平台的环境依赖与脚本执行策略常会引入额外挑战。遵循本指南的步骤,可系统性地规避常见安装错误。
核心环境预配置:不可跳过的关键步骤
切勿直接运行官方一键脚本。请首先独立安装Node.js与Git客户端。Windows PowerShell脚本对环境处理的不稳定性,要求我们必须先建立可控的基础。
安装后,务必使用管理员权限启动PowerShell,并执行以下环境校验命令:
# 验证核心工具链版本
node -v
git -v
npm -v
若npm -v在PowerShell报错而在CMD中正常,通常是PowerShell执行策略(Execution Policy)的限制所致。npm在Windows下依赖.ps1脚本运行。
通过以下命令诊断并调整策略:
# 检查当前执行策略
Get-ExecutionPolicy
# 返回结果为 Restricted 则确认此问题
# 将当前用户的执行策略设为 RemoteSigned
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
策略RemoteSigned允许运行本地脚本,同时对远程脚本实施签名验证,是兼顾安全与可用性的选择。根据提示输入Y确认更改。操作界面如下:
执行OpenClaw安装:问题诊断与修复流程
确保环境就绪后,执行官方安装命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程可能因npm路径或环境变量异常而中断。按顺序执行以下排查命令:
# 确认npm全局安装路径
npm config get prefix
# 检查系统Path变量是否包含必要条目
$env:Path -split ';'
# 若关键npm脚本缺失,尝试通过Node.js本身修复npm
node -e "const {execSync} = require('child_process'); execSync('npm install -g npm@latest', {stdio: 'inherit'})"
# 修复后,尝试直接通过npm安装OpenClaw
npm install -g openclaw@latest
完成上述步骤后,重新运行官方一键安装脚本。多数情况下,环境问题修复后,脚本可成功执行。关键在于顺序排查,避免遗漏配置项。
快速初始配置:以启动服务为首要目标
安装成功后,首要任务是让服务先运行起来。启动配置向导,并全程选择默认或跳过选项:
openclaw onboard
向导选项依次操作如下:
3. 选择 Skip for now(暂时跳过)以简化初次配置。

4. 模型提供商选取 All providers(所有提供商),回车。

5. 默认模型选择 Keep current (default: anthropic/claude-opus-4-6),维持默认设置,回车。

7. 配置搜索提供商(Search provider)时(如Brave Search、Gemini等),依然选择最下方的 Skip for now(暂时跳过),回车。

8. 系统询问是否现在配置技能(Configure skills now?),选择 No,回车。

服务启动与基础访问验证
配置完成后,服务将自动启动。请注意命令窗口中显示的本地访问地址(通常为 http://localhost:3000 或类似)。

在浏览器中访问该地址,即可进入OpenClaw的Web操作界面。

当前配置并未集成任何API密钥与模型,故直接在聊天界面交互会触发错误。这是预期状态。后续需根据实际需求,在设置中配置对应的模型提供商API密钥,才能使各项功能完全可用。






