仿真器开源

unitree_sim_isaaclab

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_sim_isaaclab

又称 Unitree Sim IsaacLab

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 克隆仓库和子模块来源:isaacsim4.5_install.md

    git clone git@github.com:unitreerobotics/unitree_sim_isaaclab.git
    cd unitree_sim_isaaclab
    git submodule update --init --depth 1
  2. 运行自动安装脚本

    官方推荐用这个脚本,版本参数可换 4.5 或 5.0

    chmod +x auto_setup_env.sh
    bash auto_setup_env.sh 5.1 unitree_sim_env
  3. 下载资产

    官方说 auto_setup_env.sh 也会下载资产

    sudo apt update
    sudo apt install git-lfs
    . fetch_assets.sh
  4. 启动遥操作任务来源: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-CylinderPickPlace-RedBlockStack-RgyBlockMove-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

conda install -c conda-forge libstdcxx-ng
来源:isaacsim5.1_install.md
Could not locate cyclonedds. Try to set CYCLONEDDS_HOME or CMAKE_PREFIX_PATH

原因找不到 cyclonedds 的路径

解决先从源码编译安装 cyclonedds,把 CYCLONEDDS_HOME 指向安装目录,再重新安装 unitree_sdk2_python

cd ~
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 .
来源:unitree_sdk2_python
VkCreateFence failed with ERROR_OUT_OF_HOST_MEMORY

原因Isaac Lab 版本装错

解决按 README 和安装文档重装 Isaac Sim 对应的 Isaac Lab 版本

来源:Issue #45
program exception: 'bool' object has no attribute 'nonzero'

原因Isaac Lab 和 Isaac Sim 版本不配套

解决把 Isaac Lab 切到配套版本:Isaac Sim 4.5 用 commit 91ad4944,5.0 按最新文档用 v2.2.0

git checkout v2.2.0
来源:Issue #25
ModuleNotFoundError: No module named 'teleimager.image_server'

原因teleimager 子模块没安装

解决进 teleimager 子模块安装;Python 3.11 被版本限制拦下时,切到维护者给的 teleimager 提交

cd teleimager
pip install -e .
来源:Issue #89

适配机器人

  • Unitree G1
  • Unitree H1-2
  • Unitree Dex1-1
  • Unitree Dex3-1
  • Inspire Hand

获取方式

发布方

相关概念

数据来源

本页信息均整理自以下公开资料。

9 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

unitree_sim_isaaclab:安装步骤、环境要求与常见报错 | 具身集