训练框架开源

robot_lab

fan-ziqi中国

GitHub 仓库 fan-ziqi/robot_lab

又称 RobotLab

类别
框架与工具 · 训练框架
开放程度
开源
发布时间
2024 年 7 月
开源协议
Apache-2.0
发布方所在地
中国

项目简介

基于 Isaac Lab 的机器人强化学习扩展库,可在 Isaac Lab 主仓库之外独立开发训练环境。内置大量四足、轮足和人形机器人的速度跟踪运动环境,覆盖宇树、云深处、智元、魔法原子、傅利叶、加速进化、星动纪元等厂商机型,另有 BeyondMimic 动作模仿、AMP 舞蹈、倒立等示例,支持 rsl_rl 与 cusrl、对称数据增强、蒸馏和多机多卡训练。训练出的策略可配合作者的 rl_sar 项目部署到 Gazebo 或真机。

robot_lab 安装要点

来源:README.md

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

  1. 克隆 Isaac Lab 和 robot_lab

    两个目录放同一层,pyproject.toml 按相对路径找

    git clone --branch v3.0.0 --depth 1 https://github.com/isaac-sim/IsaacLab.git
    git clone https://github.com/fan-ziqi/robot_lab.git
  2. 安装依赖

    cd robot_lab
    uv sync --extra importers
  3. 列出任务

    uv run --extra importers isaaclab list_envs --show_presets
  4. 试跑一个任务

    走 Newton MJWarp,不用装完整 Isaac Sim

    uv run --extra importers isaaclab zero_agent --task RobotLab-Isaac-Velocity-Flat-Unitree-Go2-v0 --num_envs 4 --max_steps 100 --viz none physics=newton_mjwarp
  5. 开始训练

    用 Isaac Sim PhysX 要单独建环境,见 README

    uv run --extra importers isaaclab train --rl_library rsl_rl --task RobotLab-Isaac-Velocity-Flat-Unitree-Go2-v0 --viz none physics=newton_mjwarp

环境要求

来源:README.md
Python
3.12
环境管理
uv
Isaac Lab
v3.0.0,和 robot_lab 放在同一层目录
Isaac Sim
6.2,用 Newton 时可不装
平台
Linux、Windows(README 徽标)

适配矩阵

来源:README.md

robot_lab 各版本依赖的 Isaac Lab 和 Isaac Sim 版本

名称Isaac LabIsaac Sim
main(v3.0.0)v3.0.06.2(Newton 可选)
v2.3.2v2.3.24.5 / 5.0 / 5.1
v2.2.2v2.2.14.5 / 5.0
v2.1.1v2.1.14.5
v1.1v1.4.14.2

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

AttributeError: 'UnitreeGo2RoughPPORunnerCfg' object has no attribute 'clip_actions'

原因Isaac Lab 更新了 RslRlVecEnvWrapper,旧版组合不匹配

解决把 robot_lab、Isaac Lab、rsl-rl-lib 一起升级到配套版本

来源:Issue #40
ValueError: Error while parsing 'contact_forces:sensor_cfg'. Not all regular expressions are matched!

解决维护者让切到 robot_lab main 分支重试;现在的 main 是 v3.0.0,要配 Isaac Lab v3.0.0

来源:Issue #88
AttributeError: module 'robot_lab.tasks.manager_based.beyondmimic.mdp' has no attribute 'randomize_rigid_body_com'

原因Isaac Lab 太旧,没有这个函数

解决升级 Isaac Lab:维护者当时让用 main 分支,现在按版本依赖表配对应版本

来源:Issue #101
ValueError: 'pelvis' is not in list

解决维护者说最新版没有这个问题;提问者把 assets/unitree.py 的 merge_fixed_joint 改成 False 后解决

来源:Issue #93
ValueError: No contact sensors added to the prim: '/World/envs/env_0/Robot'.

解决先切到要用的分支,再以可编辑方式安装 robot_lab

来源:Issue #66

适配机器人

  • Unitree Go2
  • Unitree G1
  • Unitree H1
  • Anymal D
  • Deeprobotics Lite3
  • FFTAI GR1T1
  • Booster T1
  • RobotEra Xbot

获取方式

相关概念

数据来源

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

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

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

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