- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 2021 年 11 月
- 开源协议
- BSD-3-Clause
- 发布方所在地
- 中国
项目简介
宇树科技基于 MuJoCo 和 unitree_sdk2 开发的仿真器,收发与真机相同的 DDS 话题,用 unitree_sdk2、unitree_sdk2_python 或 unitree_ros2 写的控制程序只需切换网卡配置即可在仿真与真机间迁移。提供 C++ 和 Python 两个版本,支持 Go2、B2、H1、G1、H2 等机型,附台阶、崎岖地面和高度图地形生成工具,可用 Xbox / Switch 手柄模拟宇树遥控器。宇树的强化学习仓库用它做 Sim2Sim 验证。
unitree_mujoco 安装要点
来源:readme.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装系统依赖
这里走官方推荐的 C++ 版,Python 版见 simulate_python
sudo apt install libyaml-cpp-dev libspdlog-dev libboost-all-dev libglfw3-dev安装 unitree_sdk2
git clone https://github.com/unitreerobotics/unitree_sdk2.git cd unitree_sdk2/ mkdir build cd build cmake .. -DCMAKE_INSTALL_PREFIX=/opt/unitree_robotics sudo make install链接 MuJoCo
先把 MuJoCo release 解压到 ~/.mujoco,版本号按实际改
cd unitree_mujoco/simulate/ ln -s ~/.mujoco/mujoco-3.3.6 mujoco编译仿真器
cd unitree_mujoco/simulate mkdir build && cd build cmake .. make -j4启动并测试
./test 在新终端运行;没有手柄先把 use_joystick 设为 0
./unitree_mujoco -r go2 -s scene_terrain.xml ./test
环境要求
来源:readme.md- 系统依赖
- yaml-cpp、spdlog、Boost、GLFW
- unitree_sdk2
- 官方推荐装到 /opt/unitree_robotics
- MuJoCo
- release 包解压到 ~/.mujoco,README 示例用 3.3.6
- Python 版依赖
- unitree_sdk2_python、mujoco、pygame
- 功能范围
- 当前只支持底层开发,主要用于控制器 sim to real 验证
适配矩阵
来源:readme.md仿真器可加载的机型和底层通信 IDL,空格表示 README 没有列出
| 名称 | C++ 仿真器 | Python 仿真器 | 底层 IDL |
|---|---|---|---|
| Go2 | ✓ | ✓ | unitree_go |
| B2 | ✓ | ✓ | unitree_go |
| B2w | ✓ | ✓ | unitree_go |
| H1 | ✓ | ✓ | unitree_go |
| Go2w | ✓ | — | unitree_go |
| G1 | ✓ | — | unitree_hg |
| H1-2unitree_robots 目录有 h1_2,配置注释没列 | — | — | unitree_hg |
| H2 | ✓ | — | — |
| AS2-r as2 时自动选 unitree_hg | ✓ | — | unitree_hg |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
cannot find -lddsc原因库被装到了 /usr/local/lib/x86_64,不在默认路径
解决把 libddsc.so 和 libddscxx.so 挪到 /usr/local/lib
来源:Issue #19sudo mv /usr/local/lib/x86_64/* /usr/local/lib/fatal error: spdlog/spdlog.h: No such file or directory原因缺 spdlog 开发包
解决安装 libspdlog-dev 后重新编译
来源:Issue #92sudo apt install libspdlog-devCould 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 .fatal error: glfw_adapter.h: No such file or directory原因glfw 是 MuJoCo 的依赖,用预编译包时不会自动装上
解决按 README 最新步骤用 apt 装 libglfw3-dev;glfw_adapter.h 在 MuJoCo 发布包的 simulate 目录里
来源:Issue #97sudo apt install libyaml-cpp-dev libspdlog-dev libboost-all-dev libglfw3-dev/usr/bin/ld: cannot find -lmujoco: No such file or directory原因下载的 MuJoCo 库和本机架构不匹配
解决换成和本机架构一致的 MuJoCo 发布包,比如 x86_64 机器用 linux-x86_64 版
来源:Issue #97
适配机器人
- Unitree Go2
- Unitree Go2W
- Unitree B2
- Unitree B2W
- Unitree H1
- Unitree G1
- Unitree H2
- Unitree AS2
