仿真器开源

unitree_mujoco

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_mujoco

又称 Unitree MuJoCo

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

  1. 安装系统依赖

    这里走官方推荐的 C++ 版,Python 版见 simulate_python

    sudo apt install libyaml-cpp-dev libspdlog-dev libboost-all-dev libglfw3-dev
  2. 安装 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
  3. 链接 MuJoCo

    先把 MuJoCo release 解压到 ~/.mujoco,版本号按实际改

    cd unitree_mujoco/simulate/
    ln -s ~/.mujoco/mujoco-3.3.6 mujoco
  4. 编译仿真器

    cd unitree_mujoco/simulate
    mkdir build && cd build
    cmake ..
    make -j4
  5. 启动并测试

    ./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

sudo mv /usr/local/lib/x86_64/* /usr/local/lib/
来源:Issue #19
fatal error: spdlog/spdlog.h: No such file or directory

原因缺 spdlog 开发包

解决安装 libspdlog-dev 后重新编译

sudo apt install libspdlog-dev
来源:Issue #92
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
fatal error: glfw_adapter.h: No such file or directory

原因glfw 是 MuJoCo 的依赖,用预编译包时不会自动装上

解决按 README 最新步骤用 apt 装 libglfw3-dev;glfw_adapter.h 在 MuJoCo 发布包的 simulate 目录里

sudo apt install libyaml-cpp-dev libspdlog-dev libboost-all-dev libglfw3-dev
来源:Issue #97
/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

获取方式

发布方

数据来源

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

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

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

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