最好用的“小龙虾”Docker版安装指南

昨天有朋友来帮我看下电脑，他的小龙虾装上跑了几天，结果最近启动不了，之前让它整理的几个文档还找不着了。

问了下才知道，他是直接装在自己电脑上的。小龙虾也特别多更新，看见更新就点一下。

---
Hmm，我装了好多小龙虾之前我也遇到过这个问题，运行完某个任务之后，发现在workspace目录多了很多提示词片段创建的文件夹，有点诡异。

后来，摸索了一番之后，再也没出这种问题。今天就分享一下，这可能是全网最好的指南，因为我们所说的镜像是我们自己定制的。

除非你的电脑是专门用来跑小龙虾的（没其他用途的那种），否则一律推荐用 Docker。

为什么？三个原因：
- 隔离主系统，不污染本地环境
- 更新灵活，随时可以回滚版本
- 迁移重装轻松，秒级搞定
我的个人开发机就是 Docker 跑的，出了问题直接删容器重来，完全不影响其他工作。

---
那关键的问题是，从哪里获得好用的镜像？
有三个选择：
- 官方镜像 —— 虽然是官方的，但着实不太好用，不稳定的，不稳定的版本都有出现，是个headless版本，没有桌面环境，没有浏览器，以及缺乏很多默认技能，一切都需要自己配。

- QAgent 镜像 —— 我们 Claw 公开课团队定制的，只跟进稳定的小龙虾版本，并为其定制镜像；此外内置 Webtop Linux 完整桌面（包括浏览器），做到了开箱即用。虽然体积大一点，但省去了很多配置时间。很多人装小龙虾，不都期盼它是个全能助手么？

- 第三方未经测试的镜像 —— 目前公开发布的不是太多

---
使用我们QAgent的安装步骤（三步搞定）
- 第一步：拉取镜像（以4月为例，2026.4.23这个版本的小龙虾目前是官方最新最稳定的版本，往后的4.24版本的都因为匆忙集成Deepseek v4而有一些BUG被带入）
熟悉Docker命令的直接用docker命令。
docker pull ghcr.io/quseit/qagent-image/openclaw:v2026.4.23

- 第二步：启动容器
注意看这里！有两个端口要记住：
3000 端口 —— Webtop 桌面入口，必须映射！不映射的话你只能敲命令管理，很麻烦。
18789 端口 —— 龙虾管理面板webui 服务，可选。就算不影射这个端口，你也可以在 3000 的桌面里打开浏览器访问。龙虾管理面板。

- 最终推荐这样启动：
docker run -d --name qagent -p 3000:3000 -p 18789:18789 -v qagent-config:/config ghcr.io/quseit/qagent-image/openclaw:v2026.4.23
第三步：打开浏览器访问
http://localhost:3000
看到web桌面就是成功了！