部署推理开源

rl_sar

fan-ziqi中国

GitHub 仓库 fan-ziqi/rl_sar

类别
框架与工具 · 部署推理
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 克隆仓库

    git clone --recursive --depth 1 https://github.com/fan-ziqi/rl_sar.git
  2. 安装系统依赖

    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
  3. 安装 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
  4. 编译

    只上真机加 -m,用 MuJoCo 加 -mj

    ./build.sh
  5. 启动 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>
  6. 启动控制程序

    必须另开终端运行,否则机器人没人控制会摔倒

    # 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.md

README 支持列表:各机器人在 Gazebo、MuJoCo 和真机上的状态

名称GazeboMuJoCo真机
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 路径

catkin config -DPYTHON_EXECUTABLE=/usr/bin/python3
来源:README.md
constants.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 也通过了

git pull
来源:Issue #139
Could not find a package configuration file provided by "controller_manager"

解决升级到 v2.4 及以上;在板载 Jetson 上按 README 用 ./build.sh -m 编译

./build.sh -m
来源:Issue #55

适配机器人

  • Unitree A1
  • Unitree Go2
  • Unitree Go2W
  • Unitree B2
  • Unitree G1
  • FFTAI GR1T1
  • DEEP Robotics Lite3
  • AgiBot D1

获取方式

相关概念

数据来源

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

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

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

rl_sar:安装步骤、环境要求与常见报错 | 具身集