从零开始:无界面服务器上的小龙虾之旅
前阵子手头有台闲置的云服务器,配置不高,连桌面环境都没装,就一个黑乎乎的终端窗口。本来想省点资源跑点小服务,后来看到大家都在玩那个叫“Openclaw小龙虾”的开源项目,手痒了。可问题来了——这玩意儿平时都是在图形界面或者有浏览器的环境里装,我这台光秃秃的服务器咋办?总不能为了它再去装个桌面吧。折腾了两天,踩了不少坑,总算用纯命令行把它跑起来了。今天就把这个过程捋一捋,给同样喜欢在终端里折腾的朋友做个参考。
准备工作:别急着动手,先看清楚要啥
在无界面服务器上装东西,最怕的就是缺依赖。你这边敲着命令,那边提示缺这个库少那个包,心态容易崩。我的建议是,先把服务器的基础环境升级一遍,再把必要的工具装上。别嫌麻烦,这一步能省后面好多事。
系统我用的Ubuntu 22.04,其他基于Debian的发行版应该类似;
需要Python 3.10以上版本,太老的话有些组件跑不起来;
务必保证有git和curl,后面拉取代码和下载脚本都要用;
如果服务器在国内,记得把pip源和git源换成镜像,不然下载速度能急死人。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
我的个人经验:千万不要用root直接跑安装脚本,很多项目会检测权限然后拒绝执行。创建一个普通用户,分配给sudo权限,后面能省不少麻烦。
准备工作做完,可以先跑一句 python3 --version 和 git --version 确认一下环境。如果版本不够,用apt装一下就行。整个过程也就几分钟,但心里踏实。
核心步骤:命令行下的Openclaw安装全流程
最关键的环节来了。Openclaw小龙虾本身提供了一个官方安装脚本,但因为没有交互界面,我们不能直接那样干。我试了几次,总结出下面这套比较稳定的纯命令行流程。
首先,把项目仓库克隆到本地。用git clone指定分支,别整那些花里胡哨的参数,简单直接就好。克隆完进入目录,你会看到一堆配置文件和安装脚本。

接下来是装依赖。用虚拟环境隔离最稳妥,别图省事直接pip装到全局。我习惯用python3 -m venv venv创建环境,然后激活它,再升级pip。这一步不会报错,但能避免将来版本冲突。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
依赖装完,别急着启动。因为无界面环境没有浏览器,我们需要修改配置文件,把Web界面改成“无头模式”,也就是不启动本地浏览器,只监听端口。具体方法是在配置项里找到类似 headless 的字段,把它设为 true。然后设置一个端口号,比如8080,记住这个端口,后面要用。
如果你也像我一样第一次搞,建议先把防火墙关掉或者放行端口,不然外部访问不到,你还以为是装错了。等后面调通了再封锁端口也不迟。
配置文件改好,就可以启动了。用nohup或者systemd把它扔后台跑,不然你一关终端它就停了。我比较喜欢写一个简单的启动脚本,里面加上自动重启机制,这样就算进程意外退出,也能自己拉起来。
nohup python3 main.py --port 8080 > openclaw.log 2>&1 &
等上十几秒,观察一下日志文件。看到“listening on”之类的字样,说明服务已经起来了。这时候你可以在另一台电脑的浏览器里输入服务器IP加端口,就能看到Openclaw的界面了。虽然服务器本身没有界面,但通过这种方式,你一样能操作它。
踩坑与心得:为什么我建议这么搞
整个过程最让我头疼的不是安装本身,而是各种环境问题。比如一开始我用的是Python 3.8,结果有个核心库怎么都编译不过去。后来升级到3.10,世界就清净了。还有一次,我忘了设置时区,日志时间全是UTC,排查问题的时候对不上号,特别郁闷。
所以说,如果你也想在无界面服务器上装Openclaw小龙虾,最好提前准备一个干净的系统,按我上面的步骤一步步来,别想着一步到位。命令行的好处就是每一步都看得见报错,坏消息是也容易让人烦躁。但当你看到浏览器里成功弹出控制面板的那一刻,之前的折腾都值了。
另外,这种玩法非常适合放在低配的VPS上。平时开着当个轻量级助手,不占资源,也不打扰你。唯一要注意的就是安全,毕竟暴露在公网上,建议设置访问密码,或者用密钥对登录,别裸奔。
最后,如果你不想自己折腾服务器安装配置,或者临时想体验一下这个项目的功能,可以直接访问TopClaw网址:https://top.wokk.cn/。它提供了一个在线的集成环境,不用操心依赖和部署,打开就能用,特别适合懒人或者只想快速试试看的朋友。我自己也经常上去溜达,看看别人的配置思路,确实省了不少时间。
从装系统到跑通服务,全程没碰过一次图形界面,就靠一个终端窗口搞定了。这种“纯命令行”的快乐,懂的人自然懂。希望这篇小记录能帮到正打算在无界面服务器上折腾的你。如果你也装成功了,欢迎回来分享你的经验,咱们评论区见。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn
夜雨聆风