厂商 SDK开源

unitree_ros2

宇树科技中国

GitHub 仓库 unitreerobotics/unitree_ros2

又称 Unitree ROS2

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

项目简介

宇树科技新一代机器人的 ROS 2 支持包。unitree_sdk2 与 ROS 2 都基于 DDS 通信,Go2、B2、H1、G1 等机型可直接用 ROS 2 消息通信和控制,无需封装 SDK。仓库提供 unitree_go、unitree_hg、unitree_api 消息包,以及读取运动状态、底层电机和遥控器状态,发送高层运动请求、G1 底层控制和 rosbag 录制等示例,支持 ROS 2 Foxy 和 Humble。ROS 1 仿真包见 unitree_ros。

unitree_ros2 安装要点

来源:README.md

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

  1. 克隆仓库

    git clone https://github.com/unitreerobotics/unitree_ros2
  2. 安装依赖

    README 以 foxy 为例,其他发行版替换名字

    sudo apt install ros-foxy-rmw-cyclonedds-cpp
    sudo apt install ros-foxy-rosidl-generator-dds-idl
    sudo apt install libyaml-cpp-dev
  3. 编译 cyclonedds

    Humble 可跳过;编译前不要 source ROS2 环境

    cd ~/unitree_ros2/cyclonedds_ws/src
    git clone https://github.com/ros2/rmw_cyclonedds -b foxy
    git clone https://github.com/eclipse-cyclonedds/cyclonedds -b releases/0.10.x
    cd ..
    colcon build --packages-select cyclonedds
  4. 编译 unitree_go 和 unitree_api

    source /opt/ros/foxy/setup.bash
    colcon build
  5. 配置网卡

    把 setup.sh 里的 enp3s0 改成实际网卡

    sudo gedit ~/unitree_ros2/setup.sh
    source ~/unitree_ros2/setup.sh
  6. 连接并测试

    官方建议测试前先重启电脑

    source ~/unitree_ros2/setup.sh
    ros2 topic list

环境要求

来源:README.md
Ubuntu 22.04
ROS2 humble(官方推荐)
Ubuntu 20.04
ROS2 foxy
CycloneDDS
0.10.2,Humble 可跳过编译
RMW
rmw_cyclonedds_cpp
网络
网口 IPv4 手动设 192.168.123.99,掩码 255.255.255.0

适配矩阵

来源:README.md

各机型有哪些官方示例,空格表示 README 示例列表没有提到

名称底层控制读底层状态读运动状态读遥控器高层控制
Go2✓✓✓✓✓
B2✓✓✓✓—
G1✓✓—✓—
H1—✓———
H1-2✓✓———

✓ 官方资料写明支持,— 资料没写。没写不等于不支持。

适配机器人

  • Unitree Go2
  • Unitree B2
  • Unitree H1
  • Unitree H1-2
  • Unitree G1

获取方式

发布方

数据来源

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

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

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

unitree_ros2:安装步骤与环境要求 | 具身集