Windows环境下如何正确安装OpenClaw？

在Windows环境下安装OpenClaw，主要有两种方法：一键安装（推荐新手）和npm全局安装。以下是详细步骤：

一、环境准备

系统要求：Windows 10/11（64位），至少4GB内存（推荐8GB）。

安装Node.js 22+（必需）：

1. 访问 https://nodejs.org/ 下载LTS版本（22.x或更高）
2. 安装时务必勾选 “Add to PATH”（添加到系统环境变量）网页网页
3. 安装完成后，以管理员身份打开PowerShell，验证安装：
   1. node -v # 应显示 v22.x.x
   2. npm -v # 显示对应版本号

二、安装OpenClaw

方法一：一键安装（最简单，推荐）

1. 以管理员身份运行PowerShell（按Win+X，选择“Windows PowerShell（管理员）”）
2. 复制粘贴以下命令并按回车：
   1. iwr -useb https://openclaw.ai/install.ps1 | iex
3. 按照屏幕提示操作：
   • 安全警告选择 “Yes”
   • 安装模式选择 “QuickStart”（快速开始）
   • 按向导配置AI模型和API Key网页

方法二：npm全局安装

1. 在管理员PowerShell中执行：
   1. npm install -g openclaw@latest
   注意：如果网络较慢，可先设置淘宝镜像：
   1. npm config set registry https://registry.npmmirror.com/
2. 安装过程可能需要几分钟，请耐心等待

三、初始化配置

安装完成后，运行以下命令进行初始化：

1. openclaw onboard --install-daemon

这个命令会：

• 创建必要的配置文件
• 安装系统服务（daemon）
• 引导完成初始设置

四、验证安装

1. openclaw --version # 查看版本号
2. openclaw doctor # 检查环境状态

如果显示绿色✓，说明安装成功。

五、模型配置建议

OpenClaw支持多种AI模型，强烈推荐使用Moonshot的Kimi K2.5模型，原因如下：

配置示例（编辑 ~/.openclaw/config.yaml）：

1. models:
2. default: "moonshot/kimi-k2.5"
3. "moonshot/kimi-k2.5":
4. provider: moonshot
5. model: "kimi-k2.5"
6. max_tokens: 8192
7. temperature: 0.7

六、常见问题解决

1. 安装失败，提示“无法识别命令”：检查是否以管理员身份运行PowerShell，或尝试先安装WSL：wsl --install网页
2. Node.js版本过低：确保安装Node.js 22+版本
3. 网络问题导致安装慢或失败：使用代理或设置npm镜像源
4. 完全卸载：运行 openclaw uninstall 或手动删除 C:\Users\你的用户名\.openclaw 文件夹网页

七、后续使用

• 启动服务：openclaw gateway start
• 打开控制面板：openclaw dashboard（浏览器打开 http://localhost:18789）
• 重新配置：openclaw onboard网页

关键提醒：

• API Key只保存在本地加密文件中，不会上传到任何地方网页
• 建议给API Key设置使用限额（在AI平台后台设置）
• 首次使用建议用小额度API Key测试

按照以上步骤，你应该能在Windows上成功安装并运行OpenClaw。

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？