当前位置：首页 > news >正文

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

news 2026/8/11 0:50:52

【第一篇】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

方法二：官网下载安装

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

安装完成后，重启终端或打开新的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

系统会自动：

启用WSL功能
启用虚拟机平台
下载并安装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

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

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

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)"

永久添加（手动操作）：

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

3.4 运行初始化向导

openclaw onboard--install-daemon

在PowerShell中按提示完成配置。

3.5 启动服务

openclaw gatewaystart

查看状态：

openclaw status

3.6 Windows防火墙配置

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

选择"允许访问"
勾选"专用网络"
确认

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

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)"

永久解决：

找到npm全局路径：npm prefix -g
添加到系统PATH（参考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（推荐）

申请步骤：

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

5.2 MiniMax Coding Plan

申请步骤：

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

5.3 GLM Coding Plan

申请步骤：

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

5.4 配置API Key到OpenClaw

方法一：使用向导配置

openclaw configure

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

方法二：手动配置

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

六、首次对话测试

6.1 完成Bootstrap

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

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

示例对话：

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

6.2 发送测试消息

简单测试：

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

天气查询测试：

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

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

七、后续步骤

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

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

八、总结与建议

用户类型	推荐方案	理由
开发者/技术人员	WSL2	兼容性最佳，接近原生Linux体验
普通用户	原生Windows	更简单，无需学习Linux
企业用户	Docker部署	更好的隔离性和可移植性