- 类别
- 框架与工具 · 部署推理
- 开放程度
- 开源
- 发布时间
- 2025 年 9 月
- 开源协议
- CC-BY-4.0
- 发布方所在地
- 中国
项目简介
人形机器人策略部署框架,把控制器(手柄、键盘、动作序列)、运行环境(MuJoCo 仿真或真机)和策略解耦,用配置文件组合,任务中可在多个策略间插值切换。已集成宇树官方策略、HugWBC、BeyondMimic、ASAP、TWIST、ProtoMotions 等,自带宇树 SDK 的 C++ 绑定,可在 G1 机载电脑上运行。属于 OpenMOSS 的 FRoM-W1 项目。
RoboJuDo 安装要点
来源:README.md依据官方资料的 1.5.0 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库并创建环境
git clone https://github.com/HansZ8/RoboJuDo.git cd RoboJuDo/ conda create -n robojudo python=3.11 -y conda activate robojudo安装 RoboJuDo
第一行可选,装 CPU 版 PyTorch
pip install torch --index-url https://download.pytorch.org/whl/cpu pip install -e .安装可选模块
先在 submodule_cfg.yaml 把要装的模块设为 true
python submodule_install.py运行 G1 仿真
默认配置,用 Xbox 手柄控制
python scripts/run_pipeline.py部署到真机
先改 g1_cfg.py 的 env_type 和 net_if,确认急停可用
python scripts/run_pipeline.py -c g1_real
环境要求
来源:README.md- Python来源:pyproject.toml
- 3.11 及以上
- 系统
- 官方测试过 Ubuntu、macOS 和 Windows
- 手柄
- 仿真控制需要 Xbox 手柄
- 机器人 SDK
- 控制真机才需要,sim2sim 和开发可跳过
- G1 机载部署来源:unitree_setup.md
- 算力有限,需要用 UnitreeCppEnv
适配矩阵
来源:README.md各策略在不同机器人上的状态:仿真表示可在仿真运行,真机表示已在真机测试
| 名称 | Unitree G1 | Unitree H1 | FFTAI gr1t1 |
|---|---|---|---|
| Unitree Official | 仿真、真机 | 仿真、真机 | — |
| Unitree Wo Gait | 仿真、真机 | — | — |
| Human2Humanoid需要 PHC 子模块 | 仿真、真机 | 仿真、真机 | 仿真 |
| Smoothgr1t1 真机标了 ⚠️,README 未解释 | 仿真、真机 | 仿真、真机 | 仿真、真机 |
| AMO | 仿真、真机 | — | — |
| GMTREADME 路线图里代码尚未发布 | 仿真、真机 | — | — |
| HugWBCREADME 路线图里代码尚未发布 | 仿真、真机 | 仿真、真机 | — |
| BeyondMimic | 仿真、真机 | — | — |
| ASAP | 仿真、真机 | — | — |
| KungfuBot / KungfuBot2需要 PHC 子模块 | 仿真、真机 | — | — |
| TWIST | 仿真、真机 | — | — |
| ProtoMotions | 仿真、真机 | — | — |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
RuntimeError: Sport state data is not available原因odometry_type 默认是 UNITREE,而 unitree.enable_odometry 为 False
解决把 odometry_type 设为 "DUMMY"
来源:Issue #1name 'G1FlatWoStateEstimationEnvCfg' is not defined原因把 RoboJuDo 配置和 BeyondMimic 的训练设置弄混了
解决策略基于该配置训练时,在 G1BeyondMimicPolicyCfg 里设 without_state_estimator=True,不用改 env 配置
来源:Issue #25onnxruntime cpuid_info warning: Unknown CPU vendor. cpuinfo_vendor value: 0原因作者判断是系统和环境问题,出错点在 import onnxruntime
解决先用下面的命令确认;复现时检查系统完整性,可以尝试恢复 PC2 镜像
来源:Issue #23python -c "import onnxruntime"
适配机器人
- Unitree G1
- Unitree H1
- FFTAI GR1T1