前言

官方指引提到的 Win11 powershell 一行命令部署的方式是：

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

但是实际上运行下来，会有很多问题。

Windows PowerShell 安装 OpenClaw

前置要求

• Windows 10 或更高版本
• PowerShell 5.1 或更高版本（建议使用 PowerShell 7）
• 网络连接

第一部分：环境准备（国内网络环境必做）

在国内网络环境下，OpenClaw 的安装需要先配置开发环境，否则会遇到各种依赖问题。以下是经过实际测试的完整准备流程：

步骤 1：管理员账号登录 PowerShell

1. 点击开始菜单
2. 搜索 "PowerShell"
3. 右键点击 "Windows PowerShell"
4. 选择 "以管理员身份运行"

步骤 2：解除 PowerShell 脚本运行限制

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

步骤 3：下载并安装 Git

• 腾讯下载：https://pc.qq.com/detail/13/detail_15293.html
• Git官网：https://git-scm.com（国内下载较慢）

安装时建议选择：

• "Use Git from the Windows Command Prompt"
• "Checkout Windows-style, commit Unix-style line endings"

步骤 4：注册 GitHub 账户

如果还没有 GitHub 账户，需要先注册：

• 访问 GitHub 官网：https://github.com
• 点击 "Sign up" 进行注册
• 完成邮箱验证

步骤 5：生成 SSH 密钥

ssh-keygen -t ed25519 -C "your_email@example.com"

步骤 6：将 SSH 公钥复制到 GitHub 账户

1. 复制公钥内容：

   cat ~/.ssh/id_ed25519.pub

2. 登录 GitHub，访问：https://github.com/settings/keys
3. 点击 "New SSH key"，粘贴公钥内容，保存

步骤 7：测试 GitHub 权限

ssh -T git@github.com

步骤 8：安装 nvm 和 Node.js 22+

1. 下载 nvm-windows：https://github.com/coreybutler/nvm-windows/releases

   下载 nvm-setup.exe 版本，按提示安装

2. 打开新的 PowerShell 窗口，安装 Node.js 22：

   nvm install 22
   nvm use 22

3. 配置 npm 国内镜像源：

   npm config set registry https://registry.npmmirror.com

步骤 9：下载并安装 Visual Studio Build Tools

• 官方下载：https://visualstudio.microsoft.com/visual-cpp-build-tools/

安装时选择：

• C++ 桌面开发 工作负载

步骤 10：重启电脑

第二部分：安装 OpenClaw

在 PowerShell 中执行官方一键安装：

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

按照提示完成配置：

• 输入 API Key（推荐 Anthropic Claude）
• 选择开机自启

确保后台服务运行

安装完成后，验证服务已启动：

# 查看服务状态
openclaw status

如果服务未运行，手动启动：

openclaw start

验证安装

打开浏览器访问 http://127.0.0.1:18789 进入控制面板。

常见问题

npm 安装失败

npm cache clean --force
npm install -g openclaw@latest
openclaw onboard --install-daemon

权限问题

确保以管理员身份运行 PowerShell。

端口被占用

openclaw gateway --port 18889

下一步

• 打开浏览器访问 http://127.0.0.1:18789 进入控制面板
• 添加飞书、钉钉等通道
• 开始使用你的 AI 助手