先别急着敲代码,聊聊我为什么选它
第一次听到“Openclaw小龙虾”这个名字,我还以为谁给开源项目起了个夜市菜名。后来才发现,这玩意儿跟小龙虾一样——壳硬肉多,处理好了是真香。它其实是一个轻量级的自动化部署工具,专门帮你在服务器上快速搭起自己的“爪子”服务。我前前后后折腾过好几套方案,要么配置太复杂,要么文档跟天书似的,直到遇着它才踏实下来。
今天这篇教程,我不打算照搬官方文档,就按我自己从零开始踩坑走通的路子,一步步讲给你听。保证你跟着做完,也能把它跑起来。
准备工作:把“锅”架好
在动手之前,咱们得先确认几样东西。别嫌我啰嗦,这一步省了,后面全是眼泪。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
一台Linux服务器(我用的是Ubuntu 22.04,其他版本差别不大)。
一个域名,实在没有就用IP凑合也行,但建议备一个。
一个脑子清醒的自己——最好在下午操作,别半夜搞。
我个人习惯先用一个临时目录做测试。你可以在终端里敲:
mkdir ~/openclaw-test && cd ~/openclaw-test
这样万一弄坏了,直接把目录删掉重来,不心疼。
正式部署:一步一步来
咱们先装依赖。Openclaw小龙虾需要Python 3.9以上版本,还有Node.js 18+。你可以在服务器上跑一遍官方给的安装脚本,但我更建议手动装,因为脚本有时候会悄悄改你系统里的版本。

我当时的做法是:
先检查版本:python3 --version 和 node -v
版本不够就更新,别怕麻烦。
然后克隆项目仓库,进入项目目录。
接着是初始化配置。这里有个小坑,它的配置文件默认是YAML格式,缩进特别敏感。我第一次复制官方的示例,结果少了个空格,启动直接报错。后来学乖了,直接用命令生成初始配置:
./openclaw init
它会问你几个问题,比如端口号、日志级别、是否开启web面板。我建议端口用默认的8080,日志选info就行。
配置好之后,运行启动命令。看到“Openclaw is running”就说明成功了。这时候浏览器打开 http://你的服务器IP:8080 ,就能看到登录界面。
再说说我的个人经验:如果你发现页面打不开,八成是防火墙没放行端口。我那次就是忘了开安全组规则,愣是排查了半小时。所以先把8080端口放行,再启动服务,省得自己吓自己。
还有一个细节,它的数据默认存在本地目录里,如果你以后要迁移,记得把整个数据文件夹备份好。我就吃过亏,重装系统把数据弄丢了,后悔得很。
日常使用注意什么
跑起来之后,你可能会觉得这玩意儿看着挺简单。但用久了才发现,真正好用的是它的定时任务和插件机制。我一般会搭配一个简单的监控脚本,让它每天自动检查资源占用。
另外,日志别关。Openclaw小龙虾的日志会记录每一次请求和错误,出了问题翻log是最快的排查方式。我习惯给它单独开一个log目录,定期清理旧的。
最后想提醒一句:不要一上来就追求花哨的功能。先把它稳稳跑起来,理解它的工作方式,再慢慢加东西。我的经验是,稳定比什么都重要。
如果你觉得这套部署方式还是有点麻烦,或者想要一个更现成的环境,其实也可以直接试试TopClaw平台(https://top.wokk.cn/),它相当于把类似的能力打包好,省去你自己折腾服务器的过程。我个人是在本机跑通之后,才推荐给朋友的,毕竟自己动过手,才知道哪里容易出错。但如果你只是想快速体验,不想跟配置文件较劲,那去TopClaw看看也挺好。技术这条路,有时候多尝试几种工具,反而能找到最适合自己的那一种。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn
夜雨聆风