- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2025 年 6 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 中国
项目简介
宇树科技基于 Isaac Lab 搭建的仿真任务环境,用于数据采集、回放、数据生成和模型验证。仿真器收发与真机相同的 DDS 话题,可配合 xr_teleoperate 在仿真中遥操作采集数据,回放时生成增广数据,并配合 unitree_lerobot 验证策略。提供 G1(配 Dex1 夹爪、Dex3 或因时灵巧手)和 H1-2 的抓取放置、方块堆叠等任务,以及可移动的全身操作任务,支持 Isaac Sim 4.5 / 5.0 / 5.1。
unitree_sim_isaaclab 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库和子模块来源:isaacsim4.5_install.md
git clone git@github.com:unitreerobotics/unitree_sim_isaaclab.git cd unitree_sim_isaaclab git submodule update --init --depth 1运行自动安装脚本
官方推荐用这个脚本,版本参数可换 4.5 或 5.0
chmod +x auto_setup_env.sh bash auto_setup_env.sh 5.1 unitree_sim_env下载资产
官方说 auto_setup_env.sh 也会下载资产
sudo apt update sudo apt install git-lfs . fetch_assets.sh启动遥操作任务来源:isaacsim4.5_install.md
首次启动要加载资源,等待时间取决于硬件和网络
conda activate unitree_sim_env python sim_main.py --device cpu --enable_cameras --task Isaac-PickPlace-Cylinder-G129-Dex1-Joint --enable_dex1_dds --robot_type g129
环境要求
来源:README.md- Isaac Sim
- 4.5.0 或 5.x.0,安装文档覆盖 4.5.0、5.0.0、5.1.0
- Isaac Lab来源:isaacsim5.1_install.md
- 随 Isaac Sim 定:4.5 用 commit 91ad494,5.0 用 v2.2.0,5.1 用 commit 80094be
- Python来源:isaacsim5.0_install.md
- 3.10(Isaac Sim 4.5)、3.11(Isaac Sim 5.x)
- PyTorch来源:isaacsim5.0_install.md
- 2.5.1(Isaac Sim 4.5)、2.7.0(Isaac Sim 5.x),按 CUDA 版本选
- GPU
- 只在 RTX 3080、3090、4090 上测过;RTX 50 系用 Isaac Sim 5.0.0
- 操作系统
- Ubuntu 20.04 与 22.04 及以上的安装方式不同
适配矩阵
来源:README.md官方提供的机器人和末端执行器任务,Move-Cylinder 是可移动的 Wholebody 任务
| 名称 | PickPlace-Cylinder | PickPlace-RedBlock | Stack-RgyBlock | Move-Cylinder |
|---|---|---|---|---|
| G1 29dof + 夹爪(Dex1) | ✓ | ✓ | ✓ | ✓ |
| G1 29dof + Dex3 | ✓ | ✓ | ✓ | ✓ |
| G1 29dof + Inspire | ✓ | ✓ | ✓ | ✓ |
| H1-2 + Inspire | ✓ | ✓ | ✓ | — |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
libstdc++.so.6: version GLIBCXX_3.4.30' not found原因conda 环境里的 libstdc++ 版本太低
解决从 conda-forge 安装 libstdcxx-ng
来源:isaacsim5.1_install.mdconda install -c conda-forge libstdcxx-ngCould not locate cyclonedds. Try to set CYCLONEDDS_HOME or CMAKE_PREFIX_PATH原因找不到 cyclonedds 的路径
解决先从源码编译安装 cyclonedds,把 CYCLONEDDS_HOME 指向安装目录,再重新安装 unitree_sdk2_python
来源:unitree_sdk2_pythoncd ~ git clone https://github.com/eclipse-cyclonedds/cyclonedds -b releases/0.10.x cd cyclonedds && mkdir build install && cd build cmake .. -DCMAKE_INSTALL_PREFIX=../install cmake --build . --target install cd ~/unitree_sdk2_python export CYCLONEDDS_HOME=~/cyclonedds/install pip3 install -e .VkCreateFence failed with ERROR_OUT_OF_HOST_MEMORY原因Isaac Lab 版本装错
解决按 README 和安装文档重装 Isaac Sim 对应的 Isaac Lab 版本
来源:Issue #45program exception: 'bool' object has no attribute 'nonzero'原因Isaac Lab 和 Isaac Sim 版本不配套
解决把 Isaac Lab 切到配套版本:Isaac Sim 4.5 用 commit 91ad4944,5.0 按最新文档用 v2.2.0
来源:Issue #25git checkout v2.2.0ModuleNotFoundError: No module named 'teleimager.image_server'原因teleimager 子模块没安装
解决进 teleimager 子模块安装;Python 3.11 被版本限制拦下时,切到维护者给的 teleimager 提交
来源:Issue #89cd teleimager pip install -e .
适配机器人
- Unitree G1
- Unitree H1-2
- Unitree Dex1-1
- Unitree Dex3-1
- Inspire Hand
