🦞 macopenclaw
入门指南/Windows 安装教程

Windows 安装 OpenClaw 教程

在 Windows 系统上快速安装和配置 OpenClaw，10 分钟内完成环境搭建。

2026年3月11日
阅读时间：10 分钟
虾小贤

1. 环境要求

在开始安装之前，请确保你的 Windows 系统满足以下条件：

  • 操作系统：Windows 10（版本 1903+）或 Windows 11
  • Node.js：版本 18.0 或更高（推荐 LTS 版本）
  • 内存：至少 4GB RAM（推荐 8GB+）
  • 磁盘空间：至少 1GB 可用空间
  • 网络：稳定的互联网连接

💡 提示：如果你不确定 Node.js 版本，可以先跳到第 2 步安装，安装程序会自动处理版本问题。

2. 安装 Node.js

OpenClaw 基于 Node.js 构建，需要先安装 Node.js 运行环境。

步骤 2.1：下载 Node.js

  1. 访问 Node.js 官网：https://nodejs.org
  2. 下载 LTS（长期支持）版本（左侧绿色按钮）
  3. 运行下载的 .msi 安装程序

步骤 2.2：安装过程

  1. 双击下载的 node-vxx.x.x-x64.msi 文件
  2. 点击 "Next" 接受许可协议
  3. 保持默认安装路径（C:\Program Files\nodejs）
  4. 确保勾选 "Automatically install the necessary tools"（自动安装必要工具）
  5. 点击 "Install" 开始安装
  6. 安装完成后点击 "Finish"

步骤 2.3：验证 Node.js 安装

打开 PowerShell 或命令提示符（CMD），运行以下命令：

node --version npm --version

如果显示版本号（如 v20.x.x 和 10.x.x），说明安装成功。

⚠️ 注意：如果提示 "node 不是内部或外部命令"，请重启电脑后再试，或检查环境变量配置。

3. 安装 OpenClaw

Node.js 安装完成后，可以使用 npm 全局安装 OpenClaw CLI。

步骤 3.1：打开 PowerShell

按 Win + X，选择 "Windows PowerShell" 或 "终端"。

步骤 3.2：安装 OpenClaw

运行以下命令：

npm install -g openclaw

安装过程可能需要 1-3 分钟，取决于网络速度。

步骤 3.3：验证安装

openclaw --version

如果显示版本号（如 1.x.x），说明安装成功！

4. 首次配置

安装完成后，需要初始化配置文件。

步骤 4.1：创建工作目录

mkdir C:\openclaw-workspace cd C:\openclaw-workspace

步骤 4.2：初始化配置

openclaw init

这会创建一个基础的配置文件结构：

  • openclaw.json - 主配置文件
  • .env - 环境变量（API 密钥等）
  • skills/ - Skill 目录

步骤 4.3：配置 AI 模型

编辑 .env 文件，添加你的 AI 模型 API 密钥：

# Kimi API KIMI_API_KEY=your_kimi_api_key_here # 或 OpenAI API OPENAI_API_KEY=your_openai_api_key_here # 或 Anthropic API ANTHROPIC_API_KEY=your_anthropic_api_key_here

💡 获取 API 密钥：
- Kimi：platform.moonshot.cn
- OpenAI：platform.openai.com
- Anthropic：console.anthropic.com

5. 验证安装

完成配置后，启动 OpenClaw 验证一切正常：

openclaw gateway start

如果看到类似以下的输出，说明运行成功：

🦞 OpenClaw Gateway ✓ Gateway started on http://localhost:3000 ✓ WebSocket ready ✓ Connected to 1 model provider

按 Ctrl + C 停止服务。

6. 常见问题

问题 1：npm 安装速度慢或失败

原因：网络问题或 npm 源在国外。

解决：切换为国内镜像源

npm config set registry https://registry.npmmirror.com npm install -g openclaw

问题 2：'openclaw' 不是内部或外部命令

原因：npm 全局安装路径未添加到系统 PATH。

解决：

  1. 找到 npm 全局安装路径：npm config get prefix
  2. 将 \bin 目录添加到系统环境变量 PATH
  3. 或使用 npx 运行：npx openclaw

问题 3：权限不足（EACCES）

原因：Windows 权限限制。

解决：

  1. 以管理员身份运行 PowerShell
  2. 或使用 Node 版本管理器（推荐 nvm-windows）

问题 4：启动后无法连接 AI 模型

原因：API 密钥配置错误或网络问题。

解决：

  1. 检查 .env 文件中的 API 密钥是否正确
  2. 确认 API 密钥有可用余额
  3. 检查防火墙是否阻止了连接

下一步

安装完成！接下来你可以：

🎉 恭喜你！现在你已经成功在 Windows 上安装并运行了 OpenClaw。如果遇到其他问题，欢迎在社区或 GitHub Issues 中提问。