- 类别
- 框架与工具 · 部署推理
- 开放程度
- 开源
- 发布时间
- 2024 年 3 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 中国
项目简介
面向四足、轮足和人形机器人的强化学习策略仿真验证与真机部署框架(sar 即 simulation and real),以 C++ 实现,支持 libtorch / onnxruntime 推理、ROS 1 / ROS 2、Gazebo 和 MuJoCo,也可不依赖 ROS 直接编译上机。内置 legged_gym、HIMLoco、robot_lab、BeyondMimic 等训练的预置策略,覆盖宇树、傅利叶、云深处、智元等多款机型,训练可配合作者的 robot_lab 项目。
rl_sar 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库
git clone --recursive --depth 1 https://github.com/fan-ziqi/rl_sar.git安装系统依赖
macOS 用 README 里的 brew 命令
sudo apt install cmake g++ build-essential libyaml-cpp-dev libeigen3-dev libboost-all-dev libspdlog-dev libfmt-dev libtbb-dev liblcm-dev安装 ROS 依赖
按自己的 ROS 版本选一条
# ros-noetic (Ubuntu20.04) sudo apt install ros-noetic-teleop-twist-keyboard ros-noetic-controller-interface ros-noetic-gazebo-ros-control ros-noetic-joint-state-controller ros-noetic-effort-controllers ros-noetic-joint-trajectory-controller ros-noetic-joy ros-noetic-ros-control ros-noetic-ros-controllers ros-noetic-controller-manager # ros2-foxy (Ubuntu20.04) / ros2-humble (Ubuntu22.04) sudo apt install ros-$ROS_DISTRO-teleop-twist-keyboard ros-$ROS_DISTRO-ros2-control ros-$ROS_DISTRO-ros2-controllers ros-$ROS_DISTRO-control-toolbox ros-$ROS_DISTRO-robot-state-publisher ros-$ROS_DISTRO-joint-state-publisher-gui ros-$ROS_DISTRO-gazebo-ros2-control ros-$ROS_DISTRO-gazebo-ros-pkgs ros-$ROS_DISTRO-xacro编译
只上真机加 -m,用 MuJoCo 加 -mj
./build.sh启动 Gazebo 仿真
首次打不开 Gazebo 要先下载模型包
# ROS1 source devel/setup.bash roslaunch rl_sar gazebo.launch rname:=<ROBOT> # ROS2 source install/setup.bash ros2 launch rl_sar gazebo.launch.py rname:=<ROBOT>启动控制程序
必须另开终端运行,否则机器人没人控制会摔倒
# ROS1 source devel/setup.bash rosrun rl_sar rl_sim # ROS2 source install/setup.bash ros2 run rl_sar rl_sim
环境要求
来源:README.md- 操作系统
- Ubuntu 20.04、22.04;macOS 只支持 MuJoCo 仿真
- ROS
- ROS Noetic、ROS2 Foxy/Humble
- 仿真器
- Gazebo Classic、MuJoCo 3.2.7
- 推理后端
- libtorch、onnxruntime
- 系统依赖
- cmake、g++、yaml-cpp、Eigen3、Boost、spdlog、fmt、TBB、LCM
- 训练
- 用 Isaac Lab 训练要走 robot_lab 项目
适配矩阵
来源:README.mdREADME 支持列表:各机器人在 Gazebo、MuJoCo 和真机上的状态
| 名称 | Gazebo | MuJoCo | 真机 |
|---|---|---|---|
| Unitree A1预训练策略 legged_gym | ✓ | 不支持 | ✓ |
| Unitree Go2预训练策略 himloco、robot_lab | ✓ | ✓ | ✓ |
| Unitree Go2W预训练策略 robot_lab | ✓ | ✓ | ✓ |
| Unitree B2README 真机栏标 ⚪,含义未说明 | ✓ | ✓ | — |
| Unitree B2WREADME 真机栏标 ⚪,含义未说明 | ✓ | ✓ | — |
| Unitree G1真机部署写的是 G1(29dofs) | ✓ | ✓ | ✓ |
| FFTAI GR1T1只能在 Ubuntu 20.04 上用;README 真机栏标 ⚪,含义未说明 | ✓ | 不支持 | — |
| FFTAI GR1T2只能在 Ubuntu 20.04 上用;README 真机栏标 ⚪,含义未说明 | ✓ | 不支持 | — |
| zhinao L4W4预训练策略 legged_gym | ✓ | 不支持 | ✓ |
| Deeprobotics Lite3预训练策略 himloco | ✓ | 不支持 | ✓ |
| Agibot D1预训练策略 robot_lab | ✓ | ✓ | ✓ |
| DDTRobot TitaREADME 真机栏标 ⚪,含义未说明 | ✓ | 不支持 | — |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
Unable to find either executable 'empy' or Python module 'em'解决在 catkin build 之前先指定 Python 路径
来源:README.mdcatkin config -DPYTHON_EXECUTABLE=/usr/bin/python3constants.pkl: file not found原因模型没有导出成 JIT
解决训练后用 export_policy_as_jit 导出 policy.pt,再放进 policy 目录
来源:Issue #12[ERROR] Failed to setup robot descriptions原因download_robot_descriptions.sh 调用了不存在的 set_version
解决拉取最新代码,维护者已在 eb7e212 修复;有用户再跑一次 ./build.sh 也通过了
来源:Issue #139git pullCould not find a package configuration file provided by "controller_manager"解决升级到 v2.4 及以上;在板载 Jetson 上按 README 用 ./build.sh -m 编译
来源:Issue #55./build.sh -m
适配机器人
- Unitree A1
- Unitree Go2
- Unitree Go2W
- Unitree B2
- Unitree G1
- FFTAI GR1T1
- DEEP Robotics Lite3
- AgiBot D1