宇樹科技作為國內人形機器人、四足機器人領域的頭部企業，其開源生態覆蓋數據集、AI模型、開發框架、仿真工具、硬件SDK、ROS包等全鏈路資源，既面向學術研究，也深度適配工業級嵌入式開發需求。下面先系統梳理其開源資料體系，再針對嵌入式開發者給出精準的資源利用策略。

官方鏈接：

https://www.unitree.com/cn/opensource

一、宇樹科技開源資料體系：按功能分類解析

宇樹的開源資料高度聚焦“機器人開發全流程”，從底層硬件控制到上層AI算法、從仿真驗證到實物部署，形成了完整閉環。可分為6大類，核心信息如下：

1. embodied AI數據集與預訓練模型：機器人“感知-決策”基礎數據

面向機器人操作任務的AI模型訓練，提供高質量標注數據和成熟模型，降低算法研發門檻。

?核心數據集：

?G1靈巧手操作數據集、G1夾爪操作數據集、Z1雙臂操作數據集：覆蓋“單指/多指抓取、雙臂協同”等高頻工業場景，包含力控、視覺、關節角度等多模態數據。

?預訓練模型：

?主流模仿學習（IL）模型：如DP（Data-efficient Policy）、ACT（Action Chunking with Transformers），已適配宇樹硬件，可直接用于“從人類演示中學習操作技能”。

2.機器人開發框架：封裝核心算法，支持全流程落地

針對特定開發目標（模仿學習、強化學習）提供模塊化框架，嵌入式開發者可直接基于框架二次開發，無需從零搭建基礎邏輯。

框架名稱	核心功能	支持硬件	開發價值
unitree_IL_lerobot	基于LeRobot的模仿學習框架，覆蓋“數據收集→算法開發→模型訓練→實物部署”全流程	人形機器人G1、機械臂Z1、靈巧手Dex3	嵌入式開發者可快速實現“AI驅動的機器人操作”，無需關注算法底層細節，僅需適配硬件接口
unitree_rl_gym	強化學習（RL）實現倉庫，封裝經典RL算法	四足機器人Go2、人形機器人H1/H1_2、G1	用于開發“自主決策類任務”（如機器人避障、動態平衡），支持仿真與實物端統一調用

3.仿真工具：降低嵌入式開發“實物試錯成本”

嵌入式開發中“實物調試風險高、周期長”，宇樹提供2類仿真工具，支持“先仿真驗證，再實物部署”。

?unitree_mujoco：

?基于宇樹SDK2和Mujoco物理引擎開發，可無縫集成用unitree_sdk2/unitree_ros2/unitree_sdk2_python寫的控制程序。

?核心價值：嵌入式開發者可先在仿真中驗證“關節控制、運動規劃”邏輯，避免因代碼bug損壞硬件（如電機堵轉、機械臂碰撞）。

?unitree_ros（ROS1）/ unitree_ros2（ROS2）：

?包含所有宇樹機器人的URDF模型（可獲取質量、轉動慣量、關節限位等關鍵硬件參數），并提供unitree_controller（控制器）、unitree_gazebo（Gazebo仿真包）。

?核心價值：適配ROS生態，支持用Gazebo快速搭建“多機器人協同、傳感器融合”的仿真場景，嵌入式開發者可基于此做“分布式控制”驗證。

4.硬件控制SDK：嵌入式開發的“底層入口”

SDK是嵌入式開發者與宇樹機器人硬件交互的核心工具，按“機器人類型”和“開發語言”細分，覆蓋從“單關節控制”到“整機運動”的全層級需求。

（1）多機器人通用SDK

SDK名稱	支持硬件	開發語言	核心功能	嵌入式場景適配
unitree_legged_sdk	四足機器人Aliengo、A1、Go1	C++	提供“底層關節控制接口”（單關節角度/力矩控制）和“高層運動接口”（指定速度/步態控制）	適用于對實時性要求高的場景（如四足機器人動態平衡），可直接對接嵌入式實時系統（如RT-Thread、VxWorks）
unitree_sdk2	四足機器人Go2/B2、人形機器人H1	C++	功能定位與unitree_legged_sdk一致，硬件適配升級	支持新一代機器人的“高算力硬件”（如H1的軀干計算單元），接口更簡潔，實時性優化
unitree_sdk2_python	Go2/B2/H1/G1	Python	unitree_sdk2的Python封裝	適合嵌入式開發者快速做“原型驗證”（如用Python寫簡單的步態測試腳本），再用C++重構底層邏輯

（2）機械臂專用SDK

?z1_controller：Z1機械臂的“驅動橋梁”，必須單獨運行才能調用z1_sdk，負責硬件通信協議解析。

?z1_sdk：Z1機械臂控制核心SDK，提供C++/Python接口：

?底層模式：直接控制每個關節的角度、速度、力矩；

?高層模式：實現“點到點運動”（如指定機械臂末端坐標）。

?z1_joystick：B1機器狗搭載Z1時的“遙控器控制例程”，支持自定義遙控器適配（如替換為工業遙控器）。

（3）傳感器SDK

針對宇樹自研傳感器，提供二次開發接口，降低嵌入式“傳感器-機器人”集成難度：

?電機SDK：封裝電機通信協議，避免嵌入式開發者手動解析CAN/LIN總線數據，直接調用“電機啟停、轉速控制”接口。

?4D Lidar SDK：L1/L2激光雷達的二次開發SDK，支持獲取點云、IMU數據。

?4D Lidar L1 Open Source SLAM：基于Point-LIO算法，僅用L1的點云和內置IMU即可完成SLAM（同步定位與地圖構建），嵌入式開發者可直接集成到“機器人自主導航”模塊。

（4）相機SDK

?Go1 Camera SDK routines：Go2機器人相機的開發例程，支持獲取RGB、深度圖像，可用于“視覺引導抓取”等場景。

5.遙操作示例：嵌入式“人機交互”開發參考

提供2類主流設備的遙操作方案，嵌入式開發者可直接復用“硬件通信邏輯”和“運動映射算法”：

?Kinect Camera Teleoperation：基于Azure Kinect深度相機的H1人形機器人雙臂遙操作程序，實現“人類動作→機器人動作”的實時映射。

?Apple Vision Pro Teleoperation：基于AVP（Apple Vision Pro）的H1_2遙操作倉庫，適配VR設備的空間定位數據，適合開發“沉浸式遙操作”（如遠程工業裝配）。

6.學習與教學資源：嵌入式入門進階工具

?unitree_guide：配合教材《四足機器人控制算法——建模、控制與實踐》的開源項目，包含：

?機器人關節電機控制方法、四足機器人力控算法；

?同時配置“仿真環境”和“實物開發環境”，1-2條命令即可切換。

?核心價值：嵌入式開發者可從“基礎控制算法”入手，理解“電機模型→力控邏輯→步態規劃”的底層關聯，避免直接開發時“知其然不知其所以然”。

二、嵌入式開發者如何精準利用這些開源資料？

嵌入式開發的核心需求是“底層硬件控制、實時性優化、硬件-算法協同、低成本試錯”，需根據具體開發場景匹配資源，以下分6類場景給出策略：

場景1：底層電機/關節控制（核心需求：實時性、硬件適配）

?推薦資源：unitree_legged_sdk（C++）、unitree_sdk2（C++）、電機SDK、z1_sdk（底層模式）。

?使用方法：

a.先通過unitree_guide的仿真環境，理解“電機力矩控制、關節限位保護”的邏輯（避免實物調試時電機過載）；

b.用C++基于SDK開發底層驅動：直接調用SDK的“關節控制接口”，對接嵌入式硬件的CAN總線（宇樹機器人電機多采用CAN通信）；

c.重點關注SDK中的“實時性參數”（如控制周期、數據傳輸波特率），適配嵌入式系統的調度優先級（如在Linux中用RT_PREEMPT補丁優化實時性）。

場景2：機器人整機運動控制（如四足步態、人形行走）

?推薦資源：unitree_guide、unitree_sdk2（高層模式）、unitree_mujoco。

?使用方法：

a.從unitree_guide學習“四足機器人力控步態”的數學模型（如足端軌跡規劃、身體姿態調整）；

b.在unitree_mujoco中仿真驗證“步態參數”（如步長、步頻），觀察機器人是否穩定；

c.用unitree_sdk2的高層接口（如“指定速度控制”）將仿真驗證后的步態移植到實物，僅需修改“硬件偏移參數”（如不同機器人的關節零位差異）。

場景3：AI +機器人融合（如視覺抓取、自主避障）

?推薦資源：embodied AI數據集、unitree_IL_lerobot、unitree_rl_gym、4D Lidar SLAM、Go1 Camera SDK。

?使用方法：

a.若做“模仿學習”（如讓G1手模仿人類抓?。河?/span>unitree_IL_lerobot的“數據收集模塊”采集人類演示數據，結合官方數據集訓練模型，再通過SDK部署到機器人；

b.若做“自主導航”：直接集成4D Lidar L1的SLAM倉庫，獲取機器人位姿，再用unitree_sdk2控制機器人避障（SLAM輸出的地圖+ SDK的運動控制結合）；

c.嵌入式優化點：將AI模型（如ACT）通過TensorRT量化，部署到機器人的嵌入式算力單元（如H1的NVIDIA Jetson），降低延遲。

場景4：傳感器集成（激光雷達、相機與機器人協同）

?推薦資源：4D Lidar SDK、Go1 Camera SDK、unitree_ros2。

?使用方法：

a.用傳感器SDK獲取原始數據（如L1的點云、Go1相機的RGB圖），通過unitree_ros2的“話題發布”功能，將數據同步到機器人的控制節點；

b.嵌入式層需處理“傳感器時間同步”（如用ROS2的時間戳機制，對齊點云、IMU、關節數據），避免因數據延遲導致“控制失準”（如視覺抓取時相機與機械臂不同步）。

場景5：遙操作功能開發（如工業遠程控制）

?推薦資源：Kinect Camera Teleoperation、Apple Vision Pro Teleoperation、z1_joystick。

?使用方法：

a.復用示例中的“設備通信邏輯”（如Azure Kinect的深度數據解析、AVP的空間定位數據接收）；

b.自定義“運動映射規則”（如將人類手臂的角度映射到H1的雙臂關節，需根據嵌入式硬件的算力調整映射延遲）；

c.基于z1_joystick的例程，適配工業遙控器（如替換為無線手柄），增加“緊急停止”硬件接口（嵌入式安全開發核心需求）。

場景6：快速原型驗證與學習進階

?推薦資源：unitree_sdk2_python、unitree_ros（Gazebo）、unitree_guide。

?使用方法：

a.用Python（unitree_sdk2_python）快速寫測試腳本（如控制G1手開合、H1單腿抬起），驗證硬件通信是否正常；

b.用unitree_ros的Gazebo環境，搭建“多機器人協同”仿真（如Go2配合Z1搬運物體），驗證分布式控制邏輯；

c.新手從unitree_guide配合教材入手，先掌握“機器人建模→控制算法→SDK調用”的全鏈路，再深入某一方向（如電機控制、AI部署）。

三、總結：嵌入式開發的“宇樹開源資源使用邏輯”

宇樹的開源資料不是孤立的，而是“從學習→仿真→開發→部署”的遞進關系：

1.入門層：用unitree_guide+仿真環境打基礎，理解控制原理；

2.原型層：用Python SDK（unitree_sdk2_python）快速驗證硬件與算法邏輯；

3.開發層：用C++ SDK（unitree_sdk2、z1_sdk）做底層開發，優化實時性；

4.集成層：用框架（unitree_IL_lerobot）+傳感器SDK（Lidar/Camera）做上層功能集成；

5.驗證層：用unitree_mujoco/ROS Gazebo做全場景驗證，再落地實物。

嵌入式開發者無需“面面俱到”，只需根據自身需求（如專注電機控制、還是AI部署）錨定核心資源，逐步深入，即可高效利用宇樹的開源生態降低開發成本。