- 类别
- 框架与工具 · 训练框架
- 开放程度
- 开源
- 发布时间
- 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。版本更新后命令可能变化,以官方文档为准。
克隆 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安装依赖
cd robot_lab uv sync --extra importers列出任务
uv run --extra importers isaaclab list_envs --show_presets试跑一个任务
走 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开始训练
用 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.mdrobot_lab 各版本依赖的 Isaac Lab 和 Isaac Sim 版本
| 名称 | Isaac Lab | Isaac Sim |
|---|---|---|
| main(v3.0.0) | v3.0.0 | 6.2(Newton 可选) |
| v2.3.2 | v2.3.2 | 4.5 / 5.0 / 5.1 |
| v2.2.2 | v2.2.1 | 4.5 / 5.0 |
| v2.1.1 | v2.1.1 | 4.5 |
| v1.1 | v1.4.1 | 4.2 |
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
AttributeError: 'UnitreeGo2RoughPPORunnerCfg' object has no attribute 'clip_actions'原因Isaac Lab 更新了 RslRlVecEnvWrapper,旧版组合不匹配
解决把 robot_lab、Isaac Lab、rsl-rl-lib 一起升级到配套版本
来源:Issue #40ValueError: 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 #88AttributeError: module 'robot_lab.tasks.manager_based.beyondmimic.mdp' has no attribute 'randomize_rigid_body_com'原因Isaac Lab 太旧,没有这个函数
解决升级 Isaac Lab:维护者当时让用 main 分支,现在按版本依赖表配对应版本
来源:Issue #101ValueError: 'pelvis' is not in list解决维护者说最新版没有这个问题;提问者把 assets/unitree.py 的 merge_fixed_joint 改成 False 后解决
来源:Issue #93ValueError: 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