小白零基础上手在Windows系统上安装OpenClaw小龙虾
老马发现很多小伙伴对OpenClaw小龙虾的手动安装还不熟悉,尤其是Windows系统上的安装。
市面上的教程多数写得比较笼统简单,而且每个人的Windows系统环境又不一样。
这就导致了大家在安装过程中,遇到的问题和卡点都不尽相同,跟着教程也不一定能安装成功。
所以还是觉得有必要写一个基础的入门教程,让新手小白也能零基础上手学会安装OpenClaw。
开始教程之前,先说一下一些注意事项前提:
1.老马演示安装的系统为Windows 11家庭版,纯净原版系统,里面除了系统自带,一个软件都没有安装过。
但这不代表你也要像老马一样,准备一个纯净的系统。假如你有闲置的电脑,或者虚拟机,那是可以重装一个新的,纯净的系统。
2.凡是电脑上有安装安全杀毒软件的,尤其是360,切记能完全关闭就完全关闭掉,甚至于卸载掉。
因为安装OpenClaw的过程中,你还需要安装Node.js以及Git软件,避免会被拦截,Windows自带的防火墙关不关闭倒没多大关系。
3.基本上一步步跟着老马的操作去安装,都可以成功的,除非个别网络问题,系统环境组件缺失问题。
如果在安装Node.js和Git的过程中,有任何报错的,记得把错误的界面截图下来,发给豆包,一般都能找到解决方法。
如果是在终端输入命令安装OpenClaw的过程中,出现一些红色文字的报错,可以鼠标按住全选,再按键盘Ctrl+C复制一下,同样发给豆包。
其它的就没有什么了,老马会分步骤演示,等于是用一个全新的Windows系统,从零开始装一遍。
期间遇到的细节、错误,都会进行说明,所以阅读文章的时候仔细一点,你遇到的问题,可能就是文章中提到的。
下面开整吧,争取把小龙虾先养起来,其它的进阶操作再说。
安装Node.js
第一步先安装Node.js,电脑浏览器打开官网:
https://nodejs.org/zh-cn/download,一般都会直接显示出Windows版本给你下载,版本号大于22的就行,如图:
下载安装包时可能会有点慢,需要耐心等待。下载了安装包之后,双击安装软件,安装过程跟普通Windows软件是一样的,一路点Next下去,如图:
到这里,没报错什么的话,第一步就完成了。
安装Git
第二步安装Git,同样电脑浏览器打开官网:
https://git-scm.com/install/windows,按下面截图所示下载对应的Windows 64位安装包,如图:
下载的过程同样可能会有点慢,需要耐心等待,如果下载失败了,就不断重试下载。直到安装包下载完成,双击进行安装,一路按默认Next下去,如图:
没啥报错的话,第二步Git的安装就算完成了。
接下来我们需要分别验证一下Node.js和Git是否都安装成功,在Windows桌面底部菜单找到搜索框,或者搜索的放大镜图标,输入CMD,打开命令提示符窗口,如图:
在黑色的命令提示符窗口中分别依次输入下面两个命令:
node -v
这个是验证Node.js是否安装成功的,成功的话会输出版本号,如图:
git --version
这个是验证Git是否安装成功的,成功的话同样会输出版本号,如图:
看到这两个版本号都正常显示,说明Node.js跟Git就已经成功安装了,接下来进行下一步。
安装OpenClaw
按照上面老马提到的,重新去搜索CMD,打开一个新的命令提示符窗口。当然,你要用之前查询过版本号的窗口也行,主要是为了避免有些小伙伴会搞乱。
然后电脑浏览器打开OpenClaw官网:https://openclaw.ai,往下滑动,在QuickStart里面,点击“npm”,就可以看到安装命令,如图:
npm i -g openclaw
在命令提示符窗口中,输入以上命令,回车运行,期间需要稍等一会儿让它安装,看到下面截图中所示的结果,就说明安装完成了,如图:
是的,OpenClaw小龙虾就这样安装完了,别着急,还得配置,配置完才能玩小龙虾。
OpenClaw配置
安装OpenClaw完成后,在当前的命令提示符窗口,输入以下命令,启动OpenClaw的配置向导:
openclaw onboard --install-daemon
第一步算是安全提示,我们使用键盘上的上下左右方向键来进行操作,选择“YES”,然后按回车键确认,进入下一步。第二步很简单,直接选第一个“QuickStart”,继续回车,如图:
第三步,我们按方向键的下键往下,一直滚动到“Custom Provider”,再按回车键确认,这里是选择自定义模型提供商的意思。
如果你有上述列表中其它模型提供商的API信息,比如Qwen、Z-AI的,那就选择你有的,这里主要是配置大语言模型的API信息。
由于刚才是选择了自定义模型提供商,所以老马这里也推荐阿里云近期刚推出的福利Coding Plan(编程计划)套餐。
首月只需要7.9元的Lite套餐,可以用很多主流的模型,一般小白上手体验小龙虾够用了,电脑浏览器打开阿里云官网:https://www.aliyun.com,如图:
我们先来开通一下这个套餐,等下可以给OpenClaw接入大语言模型。首先在阿里云官网,点击右上角注册一个账号,然后登录一下。
登录成功后,在首页就能看到这个Coding Plan大大的广告入口,点击“立即订阅”即可,如图:
进入订阅页面,往下滑动找到Coding Plan的Lite版本套餐,老马因为已经开通过了,所以这里没有显示首月7.9元,直接点立即购买,如图:
购买过程就不啰嗦了,一路确定下去,用支付宝支付就行。这个Lite版本的套餐,下个月续费的话还有5折优惠,也就是说原价40元/月只要20元/月。
开通了Lite版本的套餐后,默认网页会跳转到阿里云百炼平台,阿里云的模型服务都在云百炼上提供的,然后阿里云的账号也是通用同步登录的。
如果没有自动跳转到阿里云百炼,你也可以输入网址访问:
https://bailian.console.aliyun.com,点击顶部菜单“模型服务”即可进入管理界面,如图:
在管理界面左侧的菜单中,找到“订阅套餐”点击进去,就能看到你刚才开通的Lite版本的套餐,会有一个专门的API Key,右上角有个使用指南,可以点击看看。
不过使用指南主要是为了查询API的地址,因为Coding Plan的API Base URL 跟阿里云百炼的通用API Base URL是不一样的。
这里看不懂没关系,你只需要知道,API的地址有下面两个可选:
OpenAI 兼容协议:
https://coding.dashscope.aliyuncs.com/v1
Anthropic 兼容协议:
https://coding.dashscope.aliyuncs.com/apps/anthropic
老马这里演示,就用第一个OpenAI 兼容协议的API地址,复制一下,回到刚才的命令提示符窗口,把原来那串12XXXX数字开头的API Base URL,用键盘的删除键,删除掉。
复制后粘贴上:
https://coding.dashscope.aliyuncs.com/v1,如图:
按回车键确认,接下来输入API Key,回到刚才阿里云百炼的管理界面,Lite版本套餐那里,不是有一个专门的API Key么,复制一下,粘贴到这里,如图:
继续回车确认,接下来需要选择端点的兼容协议,默认选第一个OpenAI即可,因为刚才我们输入的API Base URL地址也是OpenAI兼容协议的,如图:
继续回车确认,接下来需要输入Model ID(模型ID),你也可以理解成模型的名称。回到阿里云百炼的网页,左侧菜单找到“模型广场”,切换到“前部模型”,如图:
这里就能看到我们可以使用的模型列表,找到一个你需要的模型,点击进去查看详情,顶部模型Code右边就是模型的ID,有一个复制按钮,点击复制一下,如图:
复制完成后,回到命令提示符窗口,接着粘贴模型ID进去,回车确认即可,如图:
这时会去验证一下API连接有没有问题,没问题就会提示“Verification successful”验证成功。
补充说明一下,如果验证老是失败,提示什么404之类的,你就把这个命令提示符窗口关掉,重新打开一个新的命令提示符窗口。
在新的命令提示符窗口中,重新输入命令:openclaw onboard –install-daemon,重新启动OpenClaw的配置向导,再走一遍上面的流程,直到验证成功,一般第二次就能成功。
验证成功后继续回车,接下来需要设置一个Mode alias(模型别名),格式一般是英文加下划线加数字,比如aliyun_666这样的,如图:
继续回车,接下来会提示我们是否接入聊天工具,这里直接按键盘下键移动到最后一个“Skip for now”回车选择跳过,如图:
跳过之后,接下来是“Configure skills now?”,是否现在配置技能,选择NO,回车继续下一步,如图:
然后是“Enable hooks?”,是否启用钩子,这里可以启用一下。操作方式是
按键盘上下键进行选择,按键盘空格键选中,把一个个选项选中变成绿色+号。最后按回车键确定,如图:
最后,稍等片刻,OpenClaw小龙虾的基本配置就算了完成了,显示结果如图:
开启OpenClaw养虾之旅
在刚才的命令提示符窗口中,我们先开启OpenClaw的网关,输入以下命令后,回车即可:
openclaw gateway
网关启动时,有可能Windows防火墙会提示是否允许Node.js访问公共网络和专用网络,点击允许就行了,如图:
稍等片刻,命令提示符窗口会显示一堆的蓝色文字,不用管是什么意思,一般就是启动成功了,只要不是一堆红色的报错文字就行。
接下来我们还是在Windows桌面的底部菜单,找到搜索框或者搜索放大镜的图标,输入CMD,打开一个新的命令提示符窗口。
然后输入下面的命令,启动OpenClaw的控制台,也就是小龙虾的网页控制台,可以进行对话和设置之类的操作Web界面,命令如下:
openclaw dashboard
输入命令后回车,这时会提示你是否允许使用默认的电脑浏览器访问这个网页控制台,点击“始终”按钮就行了,如图:
然后不出意外的,你就能看到自动打开的OpenClaw控制台网页了。老马随便输入一句话,告诉小龙虾,以后你就叫小猪,结果报错,如图:
这个报错提示是说模型上下文窗口太小,只有4096个tokens,最少得是16000,因此我们需要修改一下。
在OpenClaw控制台网页左侧的菜单中找到“模型”,点击进去,然后选择“Model”,切换到“Model Providers”。
往下滑动,就能看到“context window”的设置,把原来的4096改成16000,最后点右上角的“Apply”提交即可,如图:
老马上面截图中的标识标错了,点“Save”保存不会成功,得点“Apply”提交才行。提交后网关会被关闭掉,这时在右上角你就会发现小龙虾的健康状况提示为“离线”,如图:
离线就说明OpenClaw的网关服务被停掉了,解决方法就是回到刚才我们开启网关的那个命令提示符窗口,重新输入命令:openclaw gateway ,重新启动一下网关即可。
网关重新启动完成之后,右上角的小龙虾健康状况就会显示成“正常”了,老马继续输入刚才那句话,小龙虾就成功开始工作了,如图:
完美,你的OpenClaw小龙虾已经安装成功并可以正常使用。至于接下来需要安装什么必备的插件技能,你可以回看老马之前的文章:安装好这3个技能,你的OpenClaw才能正常使用
然后小龙虾的其它进阶玩法,你可以问问豆包,或者网上搜搜,都不少使用场景案例的。小龙虾养得好不好,好不好用,区别在于接入的大模型,以及安装的技能插件。
当然,还包括小龙虾自带的功能,比如多Agent协同工作。这些就留到后面的文章中,老马再继续为大家介绍了。
好了,以上就是今天的分享,欢迎关注、点赞、转发一键三连。有任何问题和需求,请在评论区留言,回见!
对了,老马最近刚创建了一个AI学习交流群,有兴趣进群的小伙伴可以添加老马微信号:immajiabin,添加好友时备注:进群。


