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 1164位内存4GB以上推荐8GB磁盘空间至少2GB可用空间网络稳定的互联网连接开发环境要求Node.js 22或更高版本关键npm或pnpm包管理器PowerShell或Windows Terminal1.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 什么是WSL2WSL2Windows 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更新系统包sudoaptupdatesudoaptupgrade-y步骤2安装curl如果未安装sudoaptinstallcurl-y步骤3一键安装OpenClawcurl-fsSLhttps://openclaw.ai/install.sh|bash等待安装完成通常需要30秒到2分钟。步骤4验证安装openclaw--version期望看到版本号输出例如2026.3.72.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特性工具无法使用性能可能略低于WSL23.2 全局安装OpenClaw打开PowerShell执行npm install-g openclawlatest等待安装完成。3.3 验证安装openclaw--version如果提示命令不存在可能需要将npm全局路径添加到PATH环境变量检查npm全局路径npm prefix-g添加到PATH临时$env:Path;$(npm prefix-g)永久添加手动操作右键此电脑 → “属性”点击高级系统设置点击环境变量在系统变量中找到Path点击编辑点击新建添加npm全局路径通常是C:\Users\你的用户名\AppData\Roaming\npm3.4 运行初始化向导openclaw onboard--install-daemon在PowerShell中按提示完成配置。3.5 启动服务openclaw gatewaystart查看状态openclaw status3.6 Windows防火墙配置首次启动时Windows可能弹出防火墙警告选择允许访问勾选专用网络确认手动添加防火墙规则如果需要New-NetFirewallRule-DisplayNameOpenClaw 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.LTS4.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# 结束进程替换PIDtaskkill/PID PID/F4.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或在命令前添加sudoWSL2中五、配置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位于中国UTC8使用中文工作。 我希望你扮演我的技术助理帮助我整理文档、搜索资料、编写代码。 我主要工作目录是 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.aiWindows WSL2文档: https://docs.microsoft.com/zh-cn/windows/wsl/Node.js官网: https://nodejs.org