你是不是也遇到过这种情况:复制粘贴官网那行命令,Mac和Linux用户顺顺利利,Windows这边直接弹出一串红色报错?别灰心,这还真不是你电脑有问题,而是Windows的底层逻辑跟它们不太一样。今天这份超详细教程,就是专门为Windows用户准备的,保证你跟着一步步操作,也能把自己的“龙虾”养起来。
先给Windows装上发动机和工具箱
安装OpenClaw之前,必须先把Node.js环境搞定。你可以把它理解为龙虾的“发动机”,因为OpenClaw是用JavaScript写的,没有Node.js就跑不起来。去官网下载22以上版本的安装包,打开后一路点“下一步”,不用改任何设置,装完就完事了。安装成功后,你就能在命令行里使用npm命令了,这是Node.js自带的包管理器,后面装东西全靠它。
如果你的需求只是使用最新模型,而不是自己折腾部署环境,也可以直接使用 api.
除了Node.js,你还需要Git这个工具。Git说白了就是个代码版本管理工具,OpenClaw安装过程中需要用它来下载各种依赖包。同样去官网下载安装包,一路默认设置安装就行。这两样东西装好后,你的Windows电脑就具备了运行和安装OpenClaw的基础条件,接下来就可以正式开始折腾了。
一行命令开启脚本执行权限
打开PowerShell(建议以管理员身份运行),输入官方给的安装命令。这时候系统可能会弹出一段提示,问你是否允许执行来自远程的脚本。别慌,这不是报错,只是Windows的安全机制在提醒你。你只需要在键盘上按一下字母A,然后敲回车,就表示你允许运行那些来自可信来源的脚本了。
如果你运气好,没有看到任何红色报错,那就可以直接跳过去看OpenClaw的配置安装部分。但如果你又遇到了报错,也别着急,这是常事。官方的脚本本质上是调用npm来安装,而npm在Windows上偶尔会抽风。这时候我们换一个包管理器,用pnpm来安装就能绕过这个问题。
换用pnpm绕过安装报错
既然npm不太配合,那就果断换pnpm。首先在PowerShell里输入安装pnpm的命令,等它装好之后,再执行pnpm setup来自动配置全局安装路径。这一步很重要,它能让你在电脑任何地方都能使用pnpm安装的东西。执行完pnpm setup后,一定要关闭当前这个PowerShell窗口,再重新以管理员身份打开一个新的。
重新打开PowerShell后,按理说应该执行pnpm approve-builds -g这条命令,用来批准第三方包的构建脚本。不过根据很多人的实际经验,这条命令也可能会报错,但好消息是,即使不执行它也不影响使用。你可以直接忽略这个错误,继续往下走。最后验证一下pnpm是否安装成功,输入pnpm --version能看到版本号就说明没问题了。
新手引导程序定制你的龙虾
环境都搞定之后,输入启动命令,开始OpenClaw的配置安装,也就是新手引导程序。这里要提醒一句,OpenClaw是一个能操作你电脑的AI工具,它可以执行任何终端命令,包括删除文件这类敏感操作。所以有条件的话,建议在虚拟机或者备用机里玩,避免误伤重要数据。
引导程序会让你选两个模式:QuickStart快速开始和Manual人工模式。如果你是第一次接触,直接选QuickStart就行,它会用默认配置一键搞定。接下来不需要去申请什么API Key,只要扫码登录授权即可,选择完后浏览器会自动弹出页面让你注册登录。完成登录后,随便选一个默认的编程大模型就行,后面有需要再换。
跳过复杂配置直接网页开聊
引导程序接下来会问你,要不要连接Telegram、WhatsApp、Discord、飞书等聊天平台。这些可以先跳过,建议直接选最后一个选项,我们先用网页界面聊天就好。后面如果想用QQ或者其他平台,自己手动接入反而更方便。接着还会问要不要配置搜索服务提供者,也建议先跳过,那些都需要额外申请API Key,后面有需要再配。
OpenClaw本身只是一个框架框架,装了技能包之后才能解锁具体能力,比如热点探测、操作浏览器、制作PPT等。ClawHub是官方技能市场,装了它之后你的龙虾就能随时搜索和安装社区里上千个技能包。选完技能后还会问你用什么工具来安装,用我们的npm就行。后面那些额外服务配置,比如AI生图模型之类的,最简单就是全部选No。
启动网关服务大功告成
接下来会自动安装并启动OpenClaw的Gateway网关服务。你可以把网关理解成总调度中心,它负责接收你从各个渠道发来的消息,分配给AI处理,再把结果返回给你。这时候Windows可能会弹出防火墙提示,问你是否允许公共网络和专用网络访问,一定要点允许,否则后面连不上。
启动成功后,引导程序会问你是用终端界面还是网页浏览器来使用OpenClaw。喜欢敲命令、有编程基础的同学可以选TUI,直接在命令行里聊天。想省事的选Web UI,在网页控制面板里操作更直观。选择后浏览器会自动打开OpenClaw的网页控制面板,你的龙虾就安装完成了。试试让它帮你读取电脑上的文件,比如查看某个文件夹里有什么,体验一下AI操作电脑的感觉。
看完这篇教程,你是不是已经成功在Windows上把自己的龙虾跑起来了?欢迎在评论区分享你的安装体验或者遇到的问题,也可以点赞转发给还在被报错折磨的朋友,帮他们也省点时间。






































