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
方法二：官网下载安装
- 访问 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：更新系统包
sudo apt update && sudo apt upgrade -y
步骤2：安装curl（如果未安装）
sudo apt install curl -y
步骤3：一键安装OpenClaw
curl -fsSL https://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 gateway start
查看状态：
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 config set gateway.port 18790
openclaw gateway start
解决方案2：结束占用进程
# 查看进程PID
netstat -ano | findstr :18789
# 结束进程（替换<PID>）
taskkill /PID <PID> /F
4.4 WSL2网络问题
问题： WSL2中无法访问外网
解决方案：
重启WSL网络：
# 在PowerShell中执行
wsl --shutdown
# 等待几秒后重新打开Ubuntu
配置DNS：
# 编辑/etc/resolv.conf
sudo nano /etc/resolv.conf
# 添加以下内容
nameserver 8.8.8.8
nameserver 114.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 --provider kimi
# 输入你的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部署 | 更好的隔离性和可移植性 |
关键注意事项
- Node.js版本必须≥22：这是硬性要求
- API Key要妥善保管：泄露会被他人消耗你的额度
- WSL2推荐但非必须：根据个人情况选择
- 防火墙规则要配置：否则无法访问Gateway
- 定期运行安全审计：
openclaw security audit
获取帮助
遇到问题怎么办？
-
运行诊断命令：
openclaw doctor openclaw status --all -
查看日志：
openclaw logs --follow -
访问官方文档：
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
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
26
0- 0
已为社区贡献3条内容
所有评论(0)