# Docker构建IsaacLab报错及teleimager Python版本不兼容

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-02-27-unitree-sim-isaaclab-104
> 频道：pitfalls | 更新日期：2026-02-27 | 标签：auto, github-issue, unitree_sim_isaaclab
> 核心摘要：Docker构建IsaacLab失败需重装setuptools或禁用隔离安装flatdict；teleimager因Python版本限制报错，需更新Dockerfile或调整依赖约束。

# Docker构建IsaacLab报错及teleimager Python版本不兼容

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[安装Docker时，在安装IsaacLab时报错了](https://github.com/unitreerobotics/unitree_sim_isaaclab/issues/104)（GitHub unitreerobotics/unitree_sim_isaaclab #104）

**状态**：有绕过办法

## 问题

Docker构建unitree_sim_isaaclab镜像时，运行脚本提示isaaclab未找到，重新执行./isaaclab.sh --install报错。解决后sim_main.py引用teleimager.image_server失败，手动拉取子模块并pip install -e .时，因teleimager要求Python<3.11与当前环境3.11.14冲突导致安装失败。

## 环境

unitree_sim_isaaclab Docker镜像，NVIDIA CUDA 12.2.0-runtime-ubuntu22.04，Conda环境unitree_sim_env，Python 3.11.14，IsaacLab 0.44.9，teleimager子模块。

## 解决办法

1. 针对IsaacLab安装报错，尝试执行 `pip install --force-reinstall setuptools` 后重试，或使用 `pip install --no-build-isolation flatdict` 绕过构建隔离问题。
2. 针对 `ModuleNotFoundError: No module named 'teleimager.image_server'`，确保在Dockerfile中执行 `git submodule update --init --depth 1` 拉取teleimager子模块。
3. 针对teleimager Python版本不兼容（requires-python <3.11），使用维护者提供的最新Dockerfile重新构建，或修改teleimager/pyproject.toml中的 `requires-python` 字段以支持Python 3.11。
4. 若仍遇依赖解析耗时或失败，检查Dockerfile中是否已正确…

讨论原作者：@gaoshuze 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub unitreerobotics/unitree_sim_isaaclab #104：安装Docker时，在安装IsaacLab时报错了](https://github.com/unitreerobotics/unitree_sim_isaaclab/issues/104)