OpenClaw安装部署Windows操作系统版 - 手把手教你搭建AI智能体平台

【第一篇】OpenClaw安装部署Windows操作系统版 - 手把手教你搭建AI智能体平台

摘要：本文详细介绍在Windows系统上安装部署OpenClaw的完整流程，从环境准备到首次运行，适合Windows新手用户。通过本教程，你将拥有一个运行在自己电脑上的AI智能体平台。

前言：为什么选择Windows版本？

OpenClaw作为一个开源AI智能体平台，支持多种操作系统。对于Windows用户来说，在本地搭建AI助手是一个绝佳的选择。Windows系统的用户基数大，但在Linux工具兼容性上往往需要额外处理。好消息是，OpenClaw官方提供了多种Windows部署方案，包括原生安装和WSL2两种方式。

推荐方案对比：

• WSL2方案：官方强烈推荐，兼容性最佳，接近Linux体验。
• 原生Windows方案：适合不想折腾的用户，但可能遇到兼容性问题。

本文将重点介绍两种方案，让你根据自己的需求选择最适合的部署方式。

一、部署前的准备工作

1.1 系统要求检查

在开始安装之前，先确认你的Windows系统满足以下要求：

最低配置要求：

• Windows 10或Windows 11（64位）
• 内存：4GB以上（推荐8GB）
• 磁盘空间：至少2GB可用空间
• 网络：稳定的互联网连接

开发环境要求：

• Node.js 22或更高版本（关键）
• npm或pnpm包管理器
• PowerShell或Windows Terminal

1.2 检查当前环境

打开PowerShell或Windows Terminal，输入以下命令检查Node.js版本：

node--version

期望输出：v22.x.x

如果版本低于22或提示"命令不存在"，需要先安装或升级Node.js。

1.3 安装Node.js（如果未安装）

方法一：使用winget（推荐）

winget install OpenJS.NodeJS.LTS

方法二：官网下载安装

1. 访问 https://nodejs.org
2. 下载LTS版本（长期支持版）
3. 双击安装包，一路点击"下一步"

安装完成后，重启终端或打开新的PowerShell窗口，再次验证Node.js版本。

二、方案一：WSL2部署（推荐）

2.1 什么是WSL2？

WSL2（Windows Subsystem for Linux 2）是微软提供的在Windows上运行Linux的环境。它提供了一个真正的Linux内核，性能和兼容性都非常好。

为什么推荐WSL2？

• 完美的Linux兼容性
• 原生OpenClaw支持，无兼容性问题
• 文件系统访问方便
• 与Windows系统集成良好

2.2 安装WSL2

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

wsl--install

系统会自动：

1. 启用WSL功能
2. 启用虚拟机平台
3. 下载并安装Ubuntu Linux

安装完成后，重启电脑。

2.3 配置WSL2环境

重启后，打开Ubuntu终端（在开始菜单搜索"Ubuntu"），首次启动会要求设置用户名和密码：

Installing, this may take a few minutes... Please create a default UNIX user account. The username does not need to match your Windows username. For more information visit: https://aka.ms/wslusers Enter new UNIX username: openclaw New password: Retype new password:

2.4 在WSL2中安装OpenClaw

进入Ubuntu终端，执行以下命令：

步骤1：更新系统包

sudoaptupdate&&sudoaptupgrade-y

步骤2：安装curl（如果未安装）

sudoaptinstallcurl-y

步骤3：一键安装OpenClaw

curl-fsSLhttps://openclaw.ai/install.sh|bash

等待安装完成，通常需要30秒到2分钟。

步骤4：验证安装

openclaw--version

期望看到版本号输出，例如：2026.3.7

2.5 运行初始化向导

openclaw onboard --install-daemon

向导会引导你完成以下配置：

1. 选择模型提供商（KIMI/MiniMax/GLM等）
2. 输入API Key
3. 选择消息渠道（可以先Skip）
4. 配置基础Skills
5. 设置安全策略

2.6 启动服务并测试

启动Gateway服务：

openclaw gateway start

检查状态：

openclaw status

打开控制台：

openclaw dashboard

浏览器会自动打开http://locahost:18789/或者http://127.0.0.1:18789/，你可以在网页界面中与AI对话。

三、方案二：原生Windows部署

3.1 原生部署的优势与劣势

优势：

• 无需额外安装Linux环境
• 更简单直接
• 适合熟悉Windows的用户

劣势：

• 可能遇到路径、权限兼容性问题
• 某些Linux特性工具无法使用
• 性能可能略低于WSL2

3.2 全局安装OpenClaw

打开PowerShell，执行：

npm install-g openclaw@latest

等待安装完成。

3.3 验证安装

openclaw--version

如果提示"命令不存在"，可能需要将npm全局路径添加到PATH环境变量：

检查npm全局路径：

npm prefix-g

添加到PATH（临时）：

$env:Path+=";$(npm prefix-g)"

永久添加（手动操作）：

1. 右键"此电脑" → “属性”
2. 点击"高级系统设置"
3. 点击"环境变量"
4. 在"系统变量"中找到Path，点击"编辑"
5. 点击"新建"，添加npm全局路径（通常是C:\Users\你的用户名\AppData\Roaming\npm）

3.4 运行初始化向导

openclaw onboard--install-daemon

在PowerShell中按提示完成配置。

3.5 启动服务

openclaw gatewaystart

查看状态：

openclaw status

3.6 Windows防火墙配置

首次启动时，Windows可能弹出防火墙警告：

1. 选择"允许访问"
2. 勾选"专用网络"
3. 确认

手动添加防火墙规则（如果需要）：

New-NetFirewallRule-DisplayName"OpenClaw Gateway"-Direction Inbound-LocalPort 18789-Protocol TCP-Action Allow

四、常见问题排查

4.1 Node.js版本不满足要求

问题：node --version显示版本低于22

解决方案：

# 使用winget升级winget upgrade OpenJS.NodeJS.LTS# 或重新安装最新版本winget install OpenJS.NodeJS.LTS

4.2 openclaw命令找不到

问题：执行openclaw --version提示"不是内部或外部命令"

原因：npm全局路径未加入PATH环境变量

解决方案：

PowerShell临时解决：

$env:Path+=";$(npm prefix-g)"

永久解决：

1. 找到npm全局路径：npm prefix -g
2. 添加到系统PATH（参考3.3节）
3. 重启终端

4.3 端口18789被占用

问题：启动Gateway时提示端口被占用

排查端口占用：

netstat-ano|findstr :18789

解决方案1：更改端口

openclaw configsetgateway.port 18790 openclaw gatewaystart

解决方案2：结束占用进程

# 查看进程PIDnetstat-ano|findstr :18789# 结束进程（替换<PID>）taskkill/PID <PID>/F

4.4 WSL2网络问题

问题：WSL2中无法访问外网

解决方案：

重启WSL网络：

# 在PowerShell中执行wsl--shutdown# 等待几秒后重新打开Ubuntu

配置DNS：

# 编辑/etc/resolv.confsudonano/etc/resolv.conf# 添加以下内容nameserver8.8.8.8 nameserver114.114.114.114# 保存并退出

4.5 权限问题

问题：执行命令时提示权限不足

解决方案：

• 以管理员身份运行PowerShell
• 或在命令前添加sudo（WSL2中）

五、配置API Key（必做）

OpenClaw需要AI模型才能工作，选择以下任一方案：

5.1 KIMI Coding Plan（推荐）

申请步骤：

1. 访问https://www.kimi.com/code
2. 登录/注册账号
3. 点击"订阅Coding Plan"
4. 完成支付（支持支付宝/微信）
5. 进入控制台，点击"创建API Key"
6. 复制生成的Key（以sk-开头）

5.2 MiniMax Coding Plan

申请步骤：

1. 访问https://platform.minimaxi.com/subscribe/coding-plan
2. 注册/登录并完成实名认证
3. 订阅Coding Plan
4. 进入"API管理"页面
5. 创建API Key并复制

5.3 GLM Coding Plan

申请步骤：

1. 访问https://bigmodel.cn/glm-coding
2. 注册/登录智谱AI账号
3. 进入控制台
4. 点击"API Keys"菜单
5. 创建新的API Key
6. 复制保存

5.4 配置API Key到OpenClaw

方法一：使用向导配置

openclaw configure

按提示选择提供商并粘贴API Key。

方法二：手动配置

openclaw models auth setup-token--providerkimi# 输入你的API Key

六、首次对话测试

6.1 完成Bootstrap

首次对话时，建议主动告诉AI以下信息：

1. 你是谁：称呼、时区、工作语言
2. 角色定位：如"我的技术写作助手"
3. 工作场景：常用工具、文件目录
4. 偏好设置：回答风格、长度
5. 安全边界：哪些操作需要确认

示例对话：

你好！我是你的主人，称呼我为Tom，位于中国（UTC+8），使用中文工作。 我希望你扮演我的技术助理，帮助我整理文档、搜索资料、编写代码。 我主要工作目录是 C:\Users\ming\projects 偏好：回答先给结论，再展开细节。 注意：执行删除操作前必须向我确认。

6.2 发送测试消息

简单测试：

请给我一个"今天就能执行"的10条待办清单，并按优先级排序。

天气查询测试：

请告诉我北京今天的天气，并给出穿衣建议（五句话）。

如果AI能正常回复，恭喜你！安装成功！

七、后续步骤

安装完成后，你可以继续探索：

1. 配置消息渠道（第二篇开始介绍）
   • 接入微信、Telegram、Discord等
2. 安装Skills插件
   • 扩展AI能力
3. 配置安全策略
   • 设置配对、权限控制
4. 学习高级功能
   • 浏览器自动化、定时任务等

八、总结与建议

推荐方案总结

关键注意事项

1. Node.js版本必须≥22：这是硬性要求
2. API Key要妥善保管：泄露会被他人消耗你的额度
3. WSL2推荐但非必须：根据个人情况选择
4. 防火墙规则要配置：否则无法访问Gateway
5. 定期运行安全审计：openclaw security audit

获取帮助

遇到问题怎么办？

1. 运行诊断命令：

   openclaw doctor openclaw status--all

2. 查看日志：

   openclaw logs--follow

3. 访问官方文档：
   https://docs.openclaw.ai

恭喜你完成了OpenClaw在Windows系统上的安装部署！下一篇文章，我们将介绍如何在Mac系统上安装部署OpenClaw。

参考资料：

• OpenClaw官方文档: https://docs.openclaw.ai
• Windows WSL2文档: https://docs.microsoft.com/zh-cn/windows/wsl/
• Node.js官网: https://nodejs.org