部署推理开源

RoboJuDo

复旦大学中国

GitHub 仓库 HansZ8/RoboJuDo

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

  1. 克隆仓库并创建环境

    git clone https://github.com/HansZ8/RoboJuDo.git
    cd RoboJuDo/
    conda create -n robojudo python=3.11 -y
    conda activate robojudo
  2. 安装 RoboJuDo

    第一行可选,装 CPU 版 PyTorch

    pip install torch --index-url https://download.pytorch.org/whl/cpu
    pip install -e .
  3. 安装可选模块

    先在 submodule_cfg.yaml 把要装的模块设为 true

    python submodule_install.py
  4. 运行 G1 仿真

    默认配置,用 Xbox 手柄控制

    python scripts/run_pipeline.py
  5. 部署到真机

    先改 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 G1Unitree H1FFTAI 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 #1
name 'G1FlatWoStateEstimationEnvCfg' is not defined

原因把 RoboJuDo 配置和 BeyondMimic 的训练设置弄混了

解决策略基于该配置训练时,在 G1BeyondMimicPolicyCfg 里设 without_state_estimator=True,不用改 env 配置

来源:Issue #25
onnxruntime cpuid_info warning: Unknown CPU vendor. cpuinfo_vendor value: 0

原因作者判断是系统和环境问题,出错点在 import onnxruntime

解决先用下面的命令确认;复现时检查系统完整性,可以尝试恢复 PC2 镜像

python -c "import onnxruntime"
来源:Issue #23

适配机器人

  • Unitree G1
  • Unitree H1
  • FFTAI GR1T1

获取方式

数据来源

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

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

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

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