Manus AI 部署失败，这个问题困扰了不少用户。很多人一看到“缺少必要的系统库”的提示，第一反应就是去排查缺了哪个库，然后尝试手动补齐。但实际上，问题的本质比想象中更直接——Docker 容器沙盒在启动过程中，因底层依赖缺失，导致 Claw 助手初始化失败、PlanAct Agent 无法正常创建沙盒实例。这种情况在 Ubuntu 或 Debian 系操作系统中尤为常见，主要原因是系统未预装 libfuse3、libglib2.0-0 或 libc6-dev 等关键运行时库，从而引发沙盒环境无法正常加载。

好了，我们先别着急，第一步是确认到底缺了哪个库。在部署主机上执行以下命令，即可快速诊断：docker run --rm -it ubuntu:22.04 bash -c "ldconfig -p | grep -E '(fuse|glib|c6)'"。如果返回结果为空，说明基础依赖库根本没有安装；如果直接报错command not found: ldconfig，那问题就比较严重了——容器内甚至缺乏基础工具链，这已经不是缺少某个库的问题，而是整个 base 镜像可能已经损坏。此时需要先清理本地 Docker 镜像缓存，再重新拉取完整的镜像文件。

确认缺失库的具体名称

在部署主机上执行：docker run --rm -it ubuntu:22.04 bash -c "ldconfig -p | grep -E '(fuse|glib|c6)'"。若无任何输出，说明基础库未安装；若报错command not found: ldconfig，则容器内连基础工具链都缺失——此时不是缺某个库，而是整个 base 镜像损坏，需先清理本地 Docker 镜像缓存。

一次性补全全部必需系统库

关键时刻来了，一次性补全全部必需系统库。Ubuntu/Debian 系统敲入以下命令：

sudo apt update && sudo apt install -y libfuse3-3 libglib2.0-0 libc6-dev libcurl4-openssl-dev libssl-dev libz-dev libsqlite3-dev

注意，这一步必须用sudo权限执行，否则libfuse3-3无法注册内核模块，后续沙盒将无法挂载临时文件系统——【缺少libfuse3-3会导致所有AI工具调用立即失败，且错误日志中不显式提示】。

验证沙盒容器能否正常加载依赖

依赖装好了，但能不能用，还得验证一下。运行一个测试容器：docker run --rm -it --cap-add=SYS_ADMIN --device=/dev/fuse ubuntu:22.04 bash -c "apt update && apt install -y fuse3 && fusermount3 --version"。

如果返回类似fusermount3 version: 3.14.2，说明libfuse3已生效；如果提示bash: fusermount3: command not found，说明apt install -y fuse3没成功，这时候需要检查网络能否访问archive.ubuntu.com，或者手动下载deb包强制安装。

重拉Manus最新运行时镜像

最后一步，也是很多人容易忽略的：重拉Manus最新运行时镜像。执行：docker pull manusai/sandbox:latest → docker images | grep sandbox → 确认IMAGE ID为最新哈希值 → 删除旧容器：docker rm -f $(docker ps -aq --filter ancestor=manusai/sandbox)。

旧镜像可能缓存了早期编译的二进制文件，它们硬编码链接了已被新版glibc废弃的符号，即使宿主机装齐所有库也无法运行——必须强制更新镜像才能同步修复。