乐于分享
好东西不私藏

Openclaw小龙虾安装部署详细教程,建议收藏

Openclaw小龙虾安装部署详细教程,建议收藏

准备工作:先把“锅碗瓢盆”备齐

说实话,第一次看到Openclaw小龙虾这个名字,我还以为是什么美食教程。后来才知道,这是个特别有意思的开源项目——给AI助手配了一个灵活的“大脑壳”,可以帮你跑任务、管流程、做自动化。我折腾了好几个周末,踩了不少坑,今天把最顺的安装部署流程整理出来,大家跟着做就行。

在动手之前,咱们得先确认几样东西:

一台电脑,Windows、macOS或者Linux都行,建议内存8G以上,不然跑起来会有点喘。
一个稳定的网络,因为要下载依赖包和模型文件。
Python环境,版本最好在3.9到3.11之间,太新或太旧都可能出幺蛾子。
Git工具,用来拉取代码,不会的话装个GitHub Desktop也能凑合。
小提示:别急着用最新版Python,Openclaw小龙虾目前对3.12的支持还不完美。我一开始图新鲜装了3.12,结果各种依赖报错,换回3.10就顺了。

第一步:打开龙虾安装地址:https://top.wokk.cn

第二步:选择Windows10/11或macOS apple、intel芯片下载。

第三步:双击安装包(exe或者dmg文件)等待3分钟。

第四步:打开桌面TopClaw龙虾软件注册登录即可使用

这些备齐后,就可以进入正题了。

安装部署:一步一步来,不慌

整个安装过程分四步,只要按顺序执行,基本一次过。

第一步,打开终端(Windows就打开PowerShell),把项目代码拉下来:

输入 git clone https://github.com/openclaw/openclaw-lobster.git
进入目录 cd openclaw-lobster

第二步,创建虚拟环境。这一步千万别省,不然依赖会装到全局,以后卸载都麻烦:


执行 python -m venv venv
激活环境:Windows用 venv\Scripts\activate,macOS/Linux用 source venv/bin/activate

第三步,安装依赖。这里需要注意,因为有些包是国内的镜像源才快,不然容易等半天还超时:

执行 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
安装完成后,再执行 pip install openclaw-lobster

第四步,初始化配置。这一步会生成一个配置文件,用来告诉小龙虾你的偏好和权限:

运行 openclaw init
按提示填写工作目录和默认模型名称(本地模型的话填 llama3.2 这类就行)

配置完成后,直接启动:openclaw run。看到终端出现一只小虾的图案,就说明部署成功了。

我第一次启动时卡在“正在加载模型权重”那儿好久,后来发现是Windows防火墙把端口拦了。大家记得在防火墙里放行对应的端口,一般是8787。
常见问题与体验分享

用了几周,我最喜欢它的一点是能无缝接入我自己的脚本和API。比如我写了个每天早上自动整理新闻摘要的脚本,现在只要跟小龙虾说一句“老规矩”,它就自己跑完了,省心太多。

不过也有几个小坑,给大家提个醒:

启动后如果终端一直提示“连接不上”,多半是代理设置的问题,把环境变量里的http_proxy和https_proxy暂时关掉再试。
如果想要更自然的对话,可以把温度参数调低一点,默认0.7有时候会太跳脱。
内存占用偏高属于正常现象,毕竟模型和上下文都在本地,别因此以为出了问题。

另外,升级也很简单,定期执行 git pull 和 pip install --upgrade openclaw-lobster 就能体验最新功能。

总的来说,Openclaw小龙虾的部署难度不高,只要你按步骤来,二十分钟内就能跑起来。过程中遇到问题别慌,先看日志,再去项目GitHub的Issues里搜一搜,基本都有答案。如果不想折腾本地环境,也可以直接用TopClaw的在线版本,打开就能用,省去配置烦恼,适合想快速体验的朋友——就是这里:https://top.wokk.cn/。等你玩熟了,再回来自己部署也不迟,毕竟自己电脑上跑起来的感觉,还是挺有成就感的。

OpenClaw中文版龙虾安装地址:https://top.wokk.cn