OpenClaw是一个强大的开源AI助手框架，支持多种大语言模型和通讯渠道。以下是在Windows 11系统上安装OpenClaw的完整步骤及详细解释。

一、准备工作

1.1 系统要求

• 操作系统：Windows 10或Windows 11（64位）

• 内存：至少4GB RAM（推荐8GB或更高）

• 磁盘空间：至少1GB可用空间

• 网络连接：稳定的互联网连接

1.2 临时设置

安装前建议临时关闭360安全卫士、电脑管家、Windows Defender实时防护等安全软件，避免它们拦截安装过程中的脚本执行。

二、安装Node.js（TypeScript运行环境）

OpenClaw基于TypeScript开发，需要Node.js运行环境。

2.1 下载Node.js

1. 访问Node.js官网：https://nodejs.org/zh-cn

2. 下载LTS版本（长期支持版），推荐v18.x或v24.x版本

3. 选择"Windows安装包（64位）"进行下载

2.2 安装Node.js

1. 双击下载的安装包（.msi文件）

2. 勾选"我接受许可协议"，点击"下一步"

3. 关键步骤：务必勾选"Add to PATH"（自动配置环境变量）

4. 安装路径建议保持默认（C:\Program Files\nodejs）

5. 点击"下一步"完成安装，过程约2-5分钟

2.3 验证安装

1. 按Win+R，输入cmd打开命令提示符

2. 输入以下命令验证：

   node --version
   npm --version

3. 如果分别显示Node.js版本和npm版本，说明安装成功

4. 如果提示"不是内部或外部命令"，需要重启电脑或手动配置环境变量

三、安装Git（版本控制工具）

Git用于拉取依赖和技能管理，虽然不是绝对必需，但强烈推荐安装。

3.1 下载Git

1. 访问Git官网：https://git-scm.com/download/win

2. 下载Windows版本安装程序

3.2 安装Git

1. 双击安装程序

2. 关键步骤：在安装过程中务必勾选"Add Git to PATH"

3. 其他选项保持默认即可

4. 完成安装

3.3 验证安装

在命令提示符中输入：

git --version

如果显示Git版本号，说明安装成功。

四、安装OpenClaw CLI

4.1 方法一：一键安装脚本（推荐新手）

这是最简单的方法，只需要一条命令：

1. 以管理员身份打开PowerShell：

   • 按Win键，搜索"PowerShell"

   • 右键点击"Windows PowerShell"，选择"以管理员身份运行"

   • 弹出"用户账户控制"时点击"是"

2. 解锁脚本执行权限（必做）：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

   输入Y确认

3. 执行一键安装命令：

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

   这条命令的含义：

   • iwr：Invoke-WebRequest的缩写，从URL下载内容

   • -useb：使用基本解析（Use Basic Parsing），兼容性更好

   • | iex：把下载的内容直接执行（Invoke-Expression）

4. 等待安装完成：

   • 安装过程约3-5分钟

   • 脚本会自动安装Node.js（如果尚未安装）和所有依赖

   • 看到"OpenClaw installed successfully"表示成功

4.2 方法二：npm全局安装

如果一键安装失败，可以尝试传统方法：

npm install -g openclaw@latest

或者使用pnpm（某些情况下更稳定）：

# 安装pnpm
npm install -g pnpm

# 配置pnpm环境
pnpm setup

# 安装OpenClaw
pnpm add -g openclaw@latest

4.3 验证OpenClaw安装

安装完成后，验证是否成功：

openclaw --version

如果显示版本号（如2026.2.1），说明安装成功。

五、配置向导（Onboarding）

安装完成后会自动进入配置引导，如果没有自动进入，可以手动运行：

openclaw onboard

5.1 配置步骤详解

步骤	提示内容	推荐选择	详细解释
1	安全警告	选择"Yes"	表示你了解脚本执行的风险，这是必要的安全确认
2	安装模式	选择"QuickStart"	快速开始模式，适合新手，会自动配置基本设置
3	选择AI模型	根据需求选择	新手推荐OpenAI GPT或Google Gemini（国内网络选Gemini更稳定）
4	输入API Key	粘贴你的API Key	需要提前从AI平台获取API密钥（见下方获取方法）
5	选择具体模型	选gpt-4o-mini或gemini-pro	这些模型性价比较高，适合日常使用
6	选择通讯渠道	选"Skip for now"	先跳过，等基础运行正常后再配置微信、飞书等渠道
7	配置技能	选"No"或"Skip"	先不安装额外技能，确保基础功能正常运行
8	安装守护进程	选"Yes"	这样关闭命令行窗口后服务也能在后台运行

5.2 如何获取API Key

OpenAI（ChatGPT）：

1. 访问 https://platform.openai.com/api-keys

2. 注册/登录账号

3. 点击"Create new secret key"

4. 复制生成的字符串（以sk-开头）

Google Gemini：

1. 访问 https://aistudio.google.com/app/apikey

2. 登录Google账号

3. 点击"Create API key"

4. 复制生成的字符串

⚠️ 重要安全提示：

• API Key就像密码，不要发给任何人！

• OpenClaw只将API Key保存在你本地电脑的加密文件里，不会上传到任何地方

• 建议给API Key设置使用限额（在OpenAI/Google后台设置）

• 不要用主号的大额度API Key测试，建议用小额度或测试账号

六、启动和访问OpenClaw

6.1 启动网关服务

方法一：直接启动（适合测试）：

openclaw gateway --port 18789

方法二：安装为服务启动：

# 安装网关服务
openclaw gateway install

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

如果遇到权限错误（如"schtasks create failed"），可能是权限不足无法创建Windows任务计划程序，此时使用直接启动方法即可。

6.2 访问控制面板

启动成功后，会显示访问地址，通常是：

http://localhost:18789

或

http://localhost:3000

用浏览器打开这个地址，即可进入OpenClaw控制面板。

6.3 验证运行状态

openclaw doctor

如果显示绿色✓，说明一切正常。

七、常见问题解决

7.1 安装失败，提示"无法识别命令"

• 原因：没有以管理员身份运行PowerShell

• 解决：确保右键选择"以管理员身份运行"PowerShell

7.2 提示"Node.js版本过低"

• 原因：系统已安装的Node.js版本太旧

• 解决：

  1. 卸载旧版本Node.js

  2. 重新安装Node.js LTS版本（v18.x或更高）

  3. 或尝试使用pnpm安装OpenClaw

7.3 网关服务启动失败

• 错误信息："Gateway service missing"或"schtasks create failed"

• 解决：

  1. 直接启动网关：openclaw gateway --port 18789

  2. 或尝试安装WSL2：wsl --install，然后重启电脑再试

7.4 完全卸载OpenClaw

openclaw uninstall

或手动删除文件夹：C:\Users\你的用户名\.openclaw

八、后续配置（可选）

8.1 接入通讯渠道

基础运行正常后，可以配置：

• 飞书/钉钉：在企业开放平台创建应用，获取App ID和Secret

• 微信：使用wechaty方案，但个人微信接入有封号风险，建议用小号测试

• QQ：通过官方机器人接口配置

8.2 安装技能

openclaw skills install

可以安装各种预置技能，如文件处理、网络搜索、自动化任务等。

8.3 配置国内大模型

如果需要使用国内大模型（如通义千问、智谱AI）：

1. 注册相应平台账号（如阿里云）

2. 申请开通服务并获取API Key

3. 在OpenClaw配置中替换模型提供商

总结

OpenClaw在Windows 11上的安装主要分为四个阶段：环境准备（Node.js+Git）、核心安装（CLI工具）、配置向导（模型和API设置）、启动验证。整个过程约需15-30分钟，关键是要确保以管理员权限运行PowerShell，并正确配置环境变量。

安装成功后，你可以通过本地Web界面管理和使用OpenClaw，将其接入各种AI模型和通讯平台，实现自动化任务处理和智能对话功能。

如果在安装过程中遇到问题，可以参考OpenClaw官方文档：https://docs.openclaw.ai/zh-CN，或查看GitHub项目页面获取最新支持。