项目>宇树 Go2>分清四个官方开源仓库:sdk2、sdk2_python、ros2 与 lerobot

分清四个官方开源仓库:sdk2、sdk2_python、ros2 与 lerobot

摘要:按抓取日期 2026-11-18 的官方仓库元数据分清 unitree_sdk2、unitree_sdk2_python、unitree_ros2 与 unitree_lerobot 的定位、许可、语言、默认分支与推送时间,认出 lerobot 面向 G1 双臂与灵巧手数采、不是 Go2 的直接二开证据。

四个官方仓库先分清,再决定从哪个入手

宇树官方在代码托管平台上并列放着四个与 Go2 生态相关的仓库,它们的定位、许可、默认分支和面向的机型并不一样。项目登记里挂的仓库是 unitree_sdk2,这只是一个指向,不代表官方只有这一个仓库;四个仓库是并列关系,本页按抓取日期 2026-11-18 的官方仓库元数据把它们放在一起对照。

表里 star、fork、open issues 与 created、pushed 都来自官方仓库元数据接口,标注抓取日期 2026-11-18,是当天的快照值,不写成实时值;官方仓库的推送时间与第三方 star 快照不同源,不互相替换混用。表后的定位表再回答「各自管什么、该从哪个入手」。

仓库 stars forks open issues 许可 语言 默认分支 创建日期 推送日期
unitree_sdk2 1452 404 15 BSD-3-Clause C++ main 2023-09-22 2026-11-18
unitree_sdk2_python 849 356 142 BSD-3-Clause Python master 2024-04-26 2026-09-21
unitree_ros2 898 265 14 BSD-3-Clause C++ master 2023-10-20 2026-07-02
unitree_lerobot 791 142 33 NOASSERTION·Other Python main 2024-10-18 2026-05-25

各自定位与该从哪个仓库入手

仓库 官方描述要点 与 Go2 的关系 该不该从这里入手
unitree_sdk2 自述为 Unitree robot sdk version 2,仓库描述直接指向宇树文档中心;自述分 Prebuild environment、Environment Setup、Build examples、Installation、Notice 几段,Notice 指向文档中心 Go2 主力 SDK,C++ 接口 准备用 C++ 按官方 SDK 做开发时从这里入手;项目 repository_url 挂的也是它
unitree_sdk2_python 自述为 Python interface for unitree sdk2;依赖 Python 3.8 及以上、cyclonedds 0.10.2、numpy、opencv-python;例程含 DDS 通信、高层状态与控制、底层状态与控制、无线遥控器状态、前相机、避障开关、音量灯光,数据结构与控制方式与 unitree_sdk2 保持一致 Go2 的 Python 接口 用 Python 写例程、不写 C++ 时从这里入手
unitree_ros2 自述基于 Cyclonedds,写明支持 Unitree Go2、B2 与 H1;测试系统为 Ubuntu 20.04 配 foxy、Ubuntu 22.04 配 humble;含 cyclonedds_ws 与 example 工作区,以及 read_motion_state、read_low_state、go2_sport_client 等例程,用 ROS2 msg 直接通信与控制 Go2 的 ROS2 接口 已有 ROS2 工程、按 topic 收发时从这里入手
unitree_lerobot LeRobot 开源训练框架的改造;发布记录 v0.1 起支持 G1 + Dex1 + Dex3,v0.2 增加 brainco 与 inspire1 灵巧手;示例数据集为 G1_Dex3_ToastedBread_Dataset,真机推理脚本为 eval_g1,环境里另装 unitree_sdk2_python 只作 DDS 通信铺垫 不是 Go2 的直接二开证据,面向 G1 双臂与灵巧手数采生态 不把这里当作给 Go2 写二开程序的入口;它属于另一条机型线上的生态辅助仓库

单独写死:unitree_lerobot 不是 Go2 的二开证据

这一条在中文资料里最容易串台,单独列清楚:unitree_lerobot 面向 G1 双臂与灵巧手数采,不是 Go2 的直接二开证据。仓库自述是对 Hugging Face LeRobot 训练框架的改造,用来训练和测试由宇树 G1 双臂、灵巧手采集的数据;发布记录从 v0.1 起就写 G1 + Dex1 + Dex3,示例数据集、真机推理脚本与数据集转换里的 robot_type 举例都以 Unitree_G1 系列为主,没有 Go2 的条目。四个仓库并列看时,前三个才是 Go2 的开发接口,unitree_lerobot 是另一条机型线上的生态辅助仓库。

本 wiki 不把 unitree_lerobot 写成 Go2 可以照着二开的材料,也不据它推断任何 Go2 的二开能力或限制;Go2 能二开到哪一层,结论仍回到官方文档中心的电气接口口径与《Go2 SDK 开发指南》的适用型号声明。

默认分支差异:自己 clone 时最容易踩的坑

四个仓库的默认分支并不统一,这一点在按 README 链接取文件、或自己拼仓库里某个文件的链接时最容易出错。官方仓库元数据的抓取留痕里记着:首次按 main 分支去抓 README,有两个仓库直接返回 404,改成 master 之后才拿到 200,这两个正是默认分支为 master 的 unitree_sdk2_python 与 unitree_ros2。

仓库 默认分支
unitree_sdk2 main
unitree_sdk2_python master
unitree_ros2 master
unitree_lerobot main

玩家自己 clone 时若照着 main 去拼文件链接或切分支,会在默认分支是 master 的仓库上取不到内容;动手取文件前先看仓库页标的是 main 还是 master,比记住某一串固定链接可靠。四个仓库的 README 当时都已落盘,落盘留痕还记着两个仓库首次取元数据遇到未认证限流、带 UA 重试后才拿到 200,这些只说明取证过程,不改变上表的快照值。这里只写清默认分支的差别与取不到文件的原因,不替官方补写任何分支迁移结论。

从 unitree_sdk2 入手时的环境落点与边界提醒

若按上表判断从 unitree_sdk2 开始,官方仓库 README 给出的构建环境要求可作为准备环境时的核对项。

环境项 官方要求
操作系统 Ubuntu 20.04 LTS
CMake 3.10 及以上
GCC 9.4.0

另外要留住一条边界:即便代码从 unitree_sdk2 入手,对应的官方《Go2 SDK 开发指南》仍只适用于 Go2 Edu 型号,并按软件版本分「低于 V1.1.6」与「V1.1.6 及以上」两套接口;这两个判断放在「按型号找到官方开发入口」那一页逐条核对,本页不把仓库环境要求当成「四个版本都能照着开发」的结论。

核完手里多了什么

  1. 按语言与开发方式选定一个主仓库:C++ 看 unitree_sdk2,Python 看 unitree_sdk2_python,ROS2 工程看 unitree_ros2。
  2. 把 unitree_lerobot 明确排除在 Go2 二开入口之外,记住它面向的是 G1 双臂与灵巧手数采。
  3. 动手取文件前先确认目标仓库默认分支是 main 还是 master,避免按 main 去 master 仓库取不到内容。
  4. 若从 unitree_sdk2 入手,按 Ubuntu 20.04、CMake 3.10 及以上、GCC 9.4.0 核对环境,并把型号与软件版本边界带回开发入口页确认。

核完的结果:手里有一张「四个仓库各管什么、我该进哪一个、clone 前先看哪个分支」的对照,不会把生态辅助仓库误当成 Go2 的开发入口,也不会以为官方只有项目登记里挂的那一个仓库。

资料来源

  • 宇树官方开源仓库元数据
  • 宇树官方 Go2 SDK 开发指南
  • 证据包校准条目