Windows 安装 OpenClaw

通过 PowerShell 一键安装 AI 助手

Windows 10/11 约 5 分钟 难度：简单

什么是 OpenClaw？

OpenClaw 是一个开源的命令行 AI 助手工具，支持多种大语言模型（OpenAI、Claude、腾讯云等），帮助你：

1

检查系统环境

确保你的 Windows 系统满足以下要求：

系统要求
  • • Windows 10 版本 1903 或更高 / Windows 11
  • • 已启用 Windows PowerShell 或 PowerShell 7+
  • • Git 版本 2.30 或更高
  • • Node.js 18 LTS 或更高
  • • 管理员权限（可选，推荐）
  • • 网络连接正常
重要提示
  • • 如果之前未运行过 PowerShell 脚本，可能需要解除执行策略限制
  • • 某些公司网络可能需要配置代理

如遇到执行策略限制，先运行：

# 解除 PowerShell 执行策略限制
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

打开 PowerShell（以管理员身份）：

# 右键点击开始菜单 -> Windows PowerShell (管理员)
2

安装依赖环境

OpenClaw 需要 Node.js 和 pnpm 环境支持。

安装 Git

# 使用 winget 安装 Git (推荐)
winget install Git.Git

# 验证安装
git --version
提示

如果 winget 不可用，请从 git-scm.com 下载安装包。

安装 Node.js

# 使用 winget 安装 Node.js (推荐)
winget install OpenJS.NodeJS.LTS
提示

如果 winget 不可用，请从 nodejs.org 下载 LTS 版本安装。安装后请重新打开 PowerShell。

安装 pnpm

# 使用 npm 安装 pnpm
npm install -g pnpm
国内用户加速

如果下载速度慢，可以配置淘宝镜像：

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

备用：验证安装

# 使用 npm 安装 pnpm
npm install -g pnpm

验证安装

# 检查所有依赖是否安装成功
git --version
node --version
pnpm --version
3

安装 OpenClaw

使用 npm 全局安装 OpenClaw CLI 工具。

# 全局安装 OpenClaw
pnpm add -g openclaw
使用 npm 安装

如果 pnpm 遇到问题，可以使用 npm 替代：

npm install -g openclaw

验证安装

openclaw --version
4

初始化配置

创建配置文件并设置 API 密钥。

创建配置目录

# 创建 OpenClaw 配置目录
mkdir $env:USERPROFILE\.openclaw
cd $env:USERPROFILE\.openclaw

初始化配置

# 运行初始化向导
openclaw init
配置完成

初始化向导会引导你完成：

  • • 选择默认 AI 模型
  • • 配置 API 密钥
  • • 设置工作目录
5

启动 OpenClaw

开始使用你的 AI 助手！

启动命令

# 在任何目录启动 OpenClaw
openclaw

常用命令

# 查看帮助
openclaw --help

# 检查状态
openclaw status

# 更新到最新版本
pnpm update -g openclaw
恭喜！安装完成

现在你可以通过 openclaw 命令启动 AI 助手了！

常见问题

Q: 提示 "无法识别 openclaw 命令"

A: 请检查系统环境变量 PATH 是否包含 npm/pnpm 全局安装路径。尝试重新打开 PowerShell 或重启电脑。

Q: 安装过程报错网络超时

A: 设置 npm 使用淘宝镜像：pnpm config set registry https://registry.npmmirror.com

Q: 如何卸载 OpenClaw

A: 运行 pnpm remove -g openclaw 即可卸载。

Q: 需要配置哪些 API 密钥

A: 根据你要使用的 AI 模型，需要配置相应的 API 密钥（如 OpenAI、Claude、腾讯云等）。可以在初始化时设置或稍后编辑配置文件。

🎉

准备好开始了吗？

OpenClaw 将帮助你提高工作效率，探索无限可能！

查看命令行速查