跳转到内容

最近更新 · 2026-01-30

OpenClaw Windows 安装教程(小白保姆级)

⚠️ 安全提醒:建议先在“无重要资料的电脑/虚拟机/独立 Windows 账号”测试。
OpenClaw 具备较高权限能力,不建议在主力工作环境裸奔运行。

你将完成什么

  • 用 PowerShell 安装 OpenClaw
  • 完成 onboarding
  • 启动并验证 OpenClaw 工作正常
  • 解决 Windows 常见问题:脚本策略、路径、Firewall、Defender、旧版冲突

开始前准备

  • 建议:Windows 用户名尽量英文,路径尽量不要太复杂(避免路径/编码问题)
  • 准备好模型 API Key(例如 Anthropic/Claude)
  • 网络能访问安装脚本(如受限请先准备网络/代理)

Step 1:以管理员身份打开 PowerShell

开始菜单搜索 PowerShell → 右键 → 以管理员身份运行

验证

powershell
whoami

Step 2:允许脚本执行(仅当前用户)

powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

验证

powershell
Get-ExecutionPolicy -Scope CurrentUser

Step 3:运行安装脚本

powershell
iwr -useb https://openclaw.bot/install.ps1 | iex

验证

powershell
openclaw --versionwhere openclaw

Step 4:处理“命令找不到”

  • 关闭 PowerShell → 重新打开 → 再试 openclaw --version

Step 5:处理旧版 moltbot / clawdbot 残留冲突(强烈建议做)

powershell
npm uninstall -g clawdbotnpm uninstall -g moltbotnpm uninstall -g openclaw

然后重新执行 Step 3。

Step 6:首次初始化(onboarding)

powershell
openclaw onboard --flow quickstart

Step 7:启动 OpenClaw

powershell
openclaw start

验证方式(至少一个)

  • 终端日志无持续错误
  • 通道测试能响应

Windows 常见坑与解决(小白重点)

  • 执行策略报错 → 确保 Step 2 已设置
  • 中文路径/路径过长 → 使用简单路径如 D:\openclaw
  • 防火墙拦截 → 允许通过防火墙或临时关闭验证
  • Defender 扫描高 CPU → 给数据目录加白名单

下一步推荐

  • Docker/VPS 安全部署:/docs/vps-setup
  • 常见报错排查:/docs/troubleshooting
  • 使用场景:/use-cases