厂商 SDK开源

Unitree SDK2

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_sdk2

又称 unitree_sdk2、unitree_sdk2_python、unitree_legged_sdk

类别
框架与工具 · 厂商 SDK
开放程度
开源
发布时间
2023 年 9 月
开源协议
BSD-3-Clause
发布方所在地
中国

项目简介

宇树科技第二代机器人开发接口,基于 CycloneDDS 通信,提供高层运动服务(站立、速度、姿态控制等)和底层关节电机、IMU、遥控器状态的读取与控制。C++ 版 unitree_sdk2 与 Python 版 unitree_sdk2_python 接口一致,覆盖 Go2、B2、A2、H1、H2、G1、R1 等机型,也是 unitree_ros2、unitree_mujoco 等宇树开源项目的通信基础。面向 Go1 / A1 的上一代 unitree_legged_sdk 已停更,并入本条。

Unitree SDK2 安装要点

来源:README.md

依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 安装依赖

    README 针对 Ubuntu 20.04

    apt-get update
    apt-get install -y cmake g++ build-essential libyaml-cpp-dev libeigen3-dev libboost-all-dev libfmt-dev
  2. 编译示例

    只跑仓库自带示例到这一步即可

    mkdir build
    cd build
    cmake ..
    make
  3. 安装到系统

    自己的工程要用 SDK 时执行

    mkdir build
    cd build
    cmake ..
    sudo make install
  4. 安装到指定目录

    和上一步二选一;其他目录要加进 CMAKE_PREFIX_PATH

    mkdir build
    cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=/opt/unitree_robotics
    sudo make install

环境要求

来源:README.md
操作系统
Ubuntu 20.04 LTS
CPU
aarch64、x86_64
编译器
GCC 9.4.0
CMake
3.10 或更高
系统依赖
yaml-cpp、Eigen3、Boost、fmt

适配矩阵

来源:example

仓库 example 目录里有示例的机型,不代表完整的接口支持范围

名称示例目录
Go2example/go2
Go2Wexample/go2w
B2example/b2
B2Wexample/b2w
G1example/g1
H1example/h1
H2example/h2
A2example/a2
AS2example/as2
R1example/r1

适配机器人

  • Unitree Go2
  • Unitree B2
  • Unitree A2
  • Unitree H1
  • Unitree H1-2
  • Unitree H2
  • Unitree G1
  • Unitree R1

获取方式

发布方

数据来源

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

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

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

Unitree SDK2(unitree_sdk2):安装步骤与环境要求 | 具身集