自变量机器人 GitHub 开源生态深度解析：5 项目具身智能软件栈全景

研究对象 ：X-Square-Robot 组织在 GitHub 上公开的 5 个仓库 （与组织 Public Repos 数量一致）。

研究方法 ：2026 年 6 月初克隆全部仓库，对 README、目录结构、VERSION、示例与 API 文档逐仓分析；并与 GitHub API Star/更新时间、Hugging Face 权重交叉验证。

核心结论 ：自变量 GitHub 开源呈 「WALL 模型栈（wall-x）+ 真机 gRPC SDK（sdk_robot）+ ROS2 末端/桌面臂 SDK（sdk_hand / sdk_arm_6a）+ 无本体数采框架（XRZero-G0）」 四层结构；wall-x 是唯一高 Star（~1k）生态枢纽 ，与 LeRobot / HF 权重 / 官网 WALL-OSS 叙事闭环；硬件 SDK 均走 Docker + ROS2 Dev Container ，分发形态以 Release whl / 预编译 deps 为主而非纯源码 SDK。

关联研究 ：自变量机器人官网与开源生态深度研究_产品与WALL体系全景.md

生态总览与分层架构
[5 仓库分类索引](#5 仓库分类索引)
[wall-x：WALL 系列训练与推理](#wall-x：WALL 系列训练与推理)
[sdk_robot：量子整机 gRPC SDK](#sdk_robot：量子整机 gRPC SDK)
[sdk_hand 与 sdk_arm_6a：ROS2 末端与桌面臂](#sdk_hand 与 sdk_arm_6a：ROS2 末端与桌面臂)
XRZero-G0：无本体数采与数据飞轮
仓库间协作关系与数据闭环
维护状态与选型建议
上手路径建议
参考资料与免责声明

1. 生态总览与分层架构

GitHub 组织：github.com/X-Square-Robot

公开仓库：5 个（2026 年 6 月，与本地索引 README 一致）

与官网「GreatWall / WALL-A·OSS·WM + 量子 X1/X2 + ArtiXon 灵巧手」叙事对应，GitHub 侧呈现 模型开源优先、硬件 SDK 跟进 的策略：
#mermaid-svg-yOLM4i8fyotUDBrA{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-yOLM4i8fyotUDBrA .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-yOLM4i8fyotUDBrA .error-icon{fill:#552222;}#mermaid-svg-yOLM4i8fyotUDBrA .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-yOLM4i8fyotUDBrA .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-yOLM4i8fyotUDBrA .marker{fill:#333333;stroke:#333333;}#mermaid-svg-yOLM4i8fyotUDBrA .marker.cross{stroke:#333333;}#mermaid-svg-yOLM4i8fyotUDBrA svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-yOLM4i8fyotUDBrA p{margin:0;}#mermaid-svg-yOLM4i8fyotUDBrA .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-yOLM4i8fyotUDBrA .cluster-label text{fill:#333;}#mermaid-svg-yOLM4i8fyotUDBrA .cluster-label span{color:#333;}#mermaid-svg-yOLM4i8fyotUDBrA .cluster-label span p{background-color:transparent;}#mermaid-svg-yOLM4i8fyotUDBrA .label text,#mermaid-svg-yOLM4i8fyotUDBrA span{fill:#333;color:#333;}#mermaid-svg-yOLM4i8fyotUDBrA .node rect,#mermaid-svg-yOLM4i8fyotUDBrA .node circle,#mermaid-svg-yOLM4i8fyotUDBrA .node ellipse,#mermaid-svg-yOLM4i8fyotUDBrA .node polygon,#mermaid-svg-yOLM4i8fyotUDBrA .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-yOLM4i8fyotUDBrA .rough-node .label text,#mermaid-svg-yOLM4i8fyotUDBrA .node .label text,#mermaid-svg-yOLM4i8fyotUDBrA .image-shape .label,#mermaid-svg-yOLM4i8fyotUDBrA .icon-shape .label{text-anchor:middle;}#mermaid-svg-yOLM4i8fyotUDBrA .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-yOLM4i8fyotUDBrA .rough-node .label,#mermaid-svg-yOLM4i8fyotUDBrA .node .label,#mermaid-svg-yOLM4i8fyotUDBrA .image-shape .label,#mermaid-svg-yOLM4i8fyotUDBrA .icon-shape .label{text-align:center;}#mermaid-svg-yOLM4i8fyotUDBrA .node.clickable{cursor:pointer;}#mermaid-svg-yOLM4i8fyotUDBrA .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-yOLM4i8fyotUDBrA .arrowheadPath{fill:#333333;}#mermaid-svg-yOLM4i8fyotUDBrA .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-yOLM4i8fyotUDBrA .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-yOLM4i8fyotUDBrA .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-yOLM4i8fyotUDBrA .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-yOLM4i8fyotUDBrA .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-yOLM4i8fyotUDBrA .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-yOLM4i8fyotUDBrA .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-yOLM4i8fyotUDBrA .cluster text{fill:#333;}#mermaid-svg-yOLM4i8fyotUDBrA .cluster span{color:#333;}#mermaid-svg-yOLM4i8fyotUDBrA div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-yOLM4i8fyotUDBrA .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-yOLM4i8fyotUDBrA rect.text{fill:none;stroke-width:0;}#mermaid-svg-yOLM4i8fyotUDBrA .icon-shape,#mermaid-svg-yOLM4i8fyotUDBrA .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-yOLM4i8fyotUDBrA .icon-shape p,#mermaid-svg-yOLM4i8fyotUDBrA .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-yOLM4i8fyotUDBrA .icon-shape .label rect,#mermaid-svg-yOLM4i8fyotUDBrA .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-yOLM4i8fyotUDBrA .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-yOLM4i8fyotUDBrA .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-yOLM4i8fyotUDBrA :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 数采 / 数据
末端 / 桌面臂 ROS2
整机真机
模型 / 策略
rig-augmented
黑客松奖品 / 桌面
wall-x
HF: wall-oss-*
LeRobot policy.type=wall_x
sdk_robot gRPC
Quanta X1
Quanta X2
sdk_hand ZBL 灵巧手
sdk_arm_6a 六轴臂
XRZero-G0 框架
HF: XRZero-G0-3K
sdk_robot convert_to_lerobot

与宇树/智元差异（结构层面） ：自变量 仅 5 仓 ，无独立仿真 benchmark 仓、无多 SKU 四足/人形驱动层；wall-x + LeRobot 承担策略训练，sdk_robot 一条 gRPC 链路覆盖 X1/X2/桌面，末端能力拆到 ROS2 子仓。

2. 5 仓库分类索引

仓库	★ Star	主语言	体积≈	最近推送	VERSION / 版本	一句话定位
wall-x	1041	Python	~2 MB	2026-05-29	---	WALL-OSS 训练/推理/评测；LeRobot 微调
sdk_robot	0	Python	~990 MB	2026-05-26	1.0.7	量子 X1/X2/桌面 gRPC Python SDK + 数采转 LeRobot
sdk_hand	0	Python	~319 MB	2026-06-04	rc-misc-force-build	ZBL 五指灵巧手 ROS2 SDK（15 主动关节）
sdk_arm_6a	0	Shell/C++	~77 MB	2026-06-04	v0.1.1	六轴桌面臂 ROS2 SDK（CAN 总线）
XRZero-G0	32	---	~59 MB	2026-05-21	---	无本体数采框架说明仓（论文+数据集链接，无代码）

许可：sdk_robot / sdk_hand / sdk_arm_6a 含 LICENSE；wall-x 见仓库声明；XRZero-G0 README 标注 MIT，GitHub 元数据未挂 license 文件。

3. wall-x：WALL 系列训练与推理

3.1 仓库角色

官网 WALL-OSS / WALL-OSS-0.5 / WALL-WM 的 代码主仓 （WALL-WM、0.5 训练代码 README 标注 Code coming soon ，当前以 WALL-OSS Flow/FAST 为主）。

环境：Python 3.10 · Ubuntu 22.04 · CUDA 12.x · FlashAttention 2.7.4 · 固定 LeRobot commit c66cd401...

3.2 目录结构

text 复制代码

wall-x/
├── wall_x/                 # 核心 Python 包
│   ├── model/qwen2_5_based/   # Qwen2.5-VL + Action Head (MoE/VLA)
│   ├── trainer/               # 训练循环
│   ├── infer/                 # 推理
│   ├── serving/policy/        # 策略服务
│   ├── data/                  # LeRobot 数据集映射
│   └── fusions/               # 多模态融合
├── workspace/
│   ├── README.md              # 训练超参/显存说明
│   └── lerobot_example/       # run.sh + config_qact.yml + LIBERO 评测
├── scripts/
│   ├── fake_inference.py      # 基础动作推理
│   ├── vqa_inference.py       # VQA + 具身 CoT
│   ├── draw_openloop_plot.py  # 开环对比图
│   ├── compute_norm_stats.py  # 归一化统计
│   ├── infer_libero.py        # LIBERO 仿真推理
│   └── infer_robochallenge.py
├── csrc/ + 3rdparty/cutlass/  # CUDA 扩展
└── train_qact.py              # 训练入口

3.3 关键能力

能力	实现要点
模型加载	`Qwen2_5_VLMoEForAction.from_pretrained()`
动作分支	Flow Matching （默认）与 FAST 离散分支（`use_fast_tokenizer`）
机器人 DoF	`customized_dof_config` / `agent_pos_config`，最大维度 20（与官网量子配置对齐）
数据集	LeRobot parquet；内置 `lerobot/aloha_mobile_cabinet` 等 key 映射表
仿真评测	`workspace/lerobot_example/libero/`、`infer_libero.py`
对外集成	HF 权重 4 个 · LeRobot `policy.type=wall_x` · 官网 `/oss` 技术页

3.4 维护信号

创建：2025-09-04（与 WALL-OSS 论文时间线一致）
最近提交：2026-05-29 add wm in readme (#96) --- 同步 WALL-WM 发布叙事
社区活跃度最高（Star ~1k，Issues/PR 活跃）

4. sdk_robot：量子整机 gRPC SDK

4.1 仓库角色

量子 1/2 号与桌面臂 的统一 Python 控制接口；通过 x2://host:50051 gRPC 连接机载 SDK Server（非 ROS 直连）。

安装形态 ：GitHub Release 下载 whl （README 示例 x2robot-1.0.0-py3-none-any.whl；本地 VERSION 文件为 1.0.7 ）--- 仓库内 无 x2robot 包源码，以文档 + 示例 + 转换工具为主。

4.2 目录结构

text 复制代码

sdk_robot/
├── docs/
│   ├── API_Quanta_X1.md / _CN.md
│   ├── API_Quanta_X2.md / _CN.md
│   └── API_Desktop.md / _CN.md
├── examples/               # 30+ 示例脚本
│   ├── quanta_x1/          # 升降、臂、夹爪
│   ├── quanta_x2/          # 腰、臂、夹爪
│   ├── desktop/            # 桌面臂
│   ├── data_collection/    # 数采管线
│   ├── camera.py / chassis_control.py / navigation.py
│   └── audio.py            # 2026-05 新增音频 API
├── tools/
│   └── convert_to_lerobot.py   # → LeRobot v0.4.2 格式
├── samples/                # 推理 workflow 样例
│   ├── quanta_x1/
│   └── desktop/
└── urdf/
    ├── quanta_x1/          # 484 STL 网格
    └── quanta_x2/

4.3 网络与约束（README 强调）

项	要求
连接	USB 网卡 + 静态 IP（例 PC `192.168.10.10/24`，机器人 `192.168.10.1:50051`）
代理	必须关闭企业代理/安全软件，否则高频相机流会断连
控制频率	≤ 200 Hz
模式	回放/推理需 idle 模式；数采与回放模式互斥
底盘建图	有效地图需移动 ≥3.5 m 或旋转 ≥210°
低电量	<7% 时双臂自动掉电

4.4 数采 → 训练闭环

tools/convert_to_lerobot.py 支持：

robot-type ：quanta_x1（含主从臂）、quanta_x2、desktop
数据源：关节、末端位姿、多模态 action（master_arm / vr_control 等）、RGB/MP4、里程计/IMU/触觉等
输出对接 wall-x workspace/lerobot_example 微调流程

4.5 维护信号

最近功能提交：2026-05-26 音频 API
Star 为 0，但 体量大（URDF/STL）、文档完整（中英 API + 8 条 FAQ）

5. sdk_hand 与 sdk_arm_6a：ROS2 末端与桌面臂

两仓共享 ZBL 内部代号命名空间（zbl_dexterous_hand_* / zbl_arm_6a_*），与官网 ArtiXon Hand 及黑客松 六轴臂奖品 对应。

5.1 sdk_hand · ZBL 五指灵巧手

维度	内容
栈	ROS2 + Docker Dev Container（`zbl_hand_sdk_image:v0.1.1`）
关节	15 主动 DOF（5 指 × 3）；拇指/四指 splay + MCP/PIP 范围见 README 关节表
感知	Tashan 指尖触觉（`x2robot_msgs/TashanTactileData`）· 掌部 eye-in-hand 相机（YUYV 640×480@30fps）
遥操作	外骨骼 `use_exoskeleton:=true` · 左右手 PID d601/d602 udev 规则
API 层	ROS2 原生 Topic/Service + Python/C++ Wrapper （`DexterousHand` 类）
示例	`hand_demo` 手势（fist/pinch/point 等）· `finger_control` · `tactile_monitor`
首发	2026-06-04 `<feat> first version of hand sdk` --- 五仓中最新

安全警告 ：禁止多进程重复 launch；双手勿共用同一 USB Hub 上行；控制前需 activate position controller（默认 inactive）。

5.2 sdk_arm_6a · 六轴桌面臂

维度	内容
栈	ROS2 + CAN（`open_can0.sh` + USB-to-CAN）+ Docker（`zbl_arm_6a_sdk`）
启动	`ros2 launch zbl_arm_6a_description test_single_arm.launch.py`
接口	关节状态/末端位姿/诊断/相机 · 关节位置 · 任务空间 · 零力拖动 · 夹爪（见 `docs/API_en.md`）
示例	`examples/python/01_state_monitor.py` 等
版本	v0.1.1（2026-01 BUILD）；仓库 2026-06 有元数据推送，本地浅克隆末次提交为 License

安全警告：臂体必须螺丝固定；禁止多 Docker 同时向同一 CAN 臂发令（会导致抖动/损坏电机）。

5.3 两仓共性

ROS_DOMAIN_ID 默认 134
依赖 /opt/xr/core/install 预编译 ROS 包（deps/ 体积大，非轻量 pip 库）
面向 二次开发者 / 科研集成，而非即装即用 pip SDK

6. XRZero-G0：无本体数采与数据飞轮

6.1 仓库现状

几乎无代码------含 README、 teaser 图、PDF；指向：

论文：arXiv:2604.13001
数据集：HF XRZero-G0-3K（~34 GB 视频）
官网：x2robot.com/x2go

6.2 框架叙事（README）

亮点	说明
人体工学解耦接口	无机器人本体的可穿戴/ rig 采集
闭环质量验证	解决数采「质量黑盒」
Data Mixing Laws	真机/无本体数据混合比例经验律
跨本体零样本	与 WALL-WM 页「XRZero-G0 rig-augmented corpus」呼应

规模宣称 ：3,000 distinct 操作任务 · 峰值 93.2 episodes/h · 成本约为纯真机的 1/20

6.3 与 wall-x / WALL-WM 关系

官网 WALL-WM 技术页明确使用 XRZero-G0 rig-augmented data ；HF 数据集 XRZero-G0-3K 为公开子集。完整采集软件 尚未开源（本仓为索引/宣传性质）。

7. 仓库间协作关系与数据闭环

text 复制代码

                    ┌─────────────────────────────────────┐
                    │  XRZero-G0 无本体 rig 数采（论文）   │
                    └──────────────┬──────────────────────┘
                                   │ XRZero-G0-3K (HF)
                                   ▼
┌──────────────┐    LeRobot      ┌──────────────┐    gRPC     ┌─────────────┐
│  sdk_robot   │ ──convert────► │   wall-x     │ ──deploy──► │ Quanta X1/X2│
│  真机数采     │                 │  WALL-OSS    │             │ + sdk_hand  │
└──────────────┘                 └──────────────┘             └─────────────┘
       │                                ▲
       │ URDF/STL                       │ LIBERO / RoboChallenge 评测
       └────────────────────────────────┘

具亮计划 2026 黑客松指定 WALL-OSS + wall-x ；奖品 sdk_arm_6a 六轴臂与 sdk_robot 桌面类型一致。

8. 维护状态与选型建议

8.1 维护热度矩阵

仓库	文档	示例	更新频率	社区	可用性
wall-x	★★★★☆	★★★★☆	高（2025-09→2026-05 持续）	★★★★★	需 GPU + LeRobot 环境
sdk_robot	★★★★★	★★★★★	中（2026-05 音频）	★☆☆☆☆	需真机 + whl Release
sdk_hand	★★★★★	★★★★☆	新（2026-06 首发）	★☆☆☆☆	需 Docker + 电源 30V/4A
sdk_arm_6a	★★★☆☆	★★★☆☆	低	★☆☆☆☆	需 CAN 硬件 + Docker
XRZero-G0	★★☆☆☆	☆☆☆☆☆	低（README 级）	★★☆☆☆	仅论文/数据集

8.2 选型建议

目标	推荐路径
复现 WALL-OSS / 参赛具亮计划	`wall-x` + HF 权重 + LeRobot
量子 X1/X2 数采与真机控制	`sdk_robot` Release whl → examples → `convert_to_lerobot.py` → `wall-x`
ArtiXon / ZBL 灵巧手集成	`sdk_hand` Dev Container → Wrapper API
桌面六轴臂 / 黑客松硬件	`sdk_arm_6a` + CAN 环境
无本体数据研究	HF `XRZero-G0-3K` + 论文；等待 G0 采集代码开源

9. 上手路径建议

9.1 仅模型验证（无真机）

bash 复制代码

# 1. 环境
conda create -n wallx python=3.10 && conda activate wallx
git clone https://github.com/X-Square-Robot/wall-x.git && cd wall-x
pip install -r requirements.txt
# FlashAttention + LeRobot 固定 commit + pip install -e .

# 2. 下载 HF 权重 wall-oss-flow 或 wall-oss-0.5

# 3. 推理 smoke test
python ./scripts/fake_inference.py
python ./scripts/vqa_inference.py

9.2 量子 X1 数采 → 微调 → 部署

text 复制代码

sdk_robot: pip install x2robot-*.whl → check_connect.py
         → data_collection_example.py 采集
         → tools/convert_to_lerobot.py --robot-type quanta_x1
wall-x:  workspace/lerobot_example/run.sh 微调
         → sdk_robot samples/quanta_x1 真机推理样例

9.3 灵巧手 ROS2 快速验证

text 复制代码

sdk_hand: setup_serial.sh --install-rules → docker compose up
         → ros2 launch zbl_dexterous_hand_bringup single_hand.launch.py
         → python3 examples/python/WrapperAPI/hand_demo.py --gesture fist

10. 参考资料与免责声明

10.1 官方链接

资源	URL
GitHub 组织	https://github.com/X-Square-Robot
wall-x	https://github.com/X-Square-Robot/wall-x
sdk_robot	https://github.com/X-Square-Robot/sdk_robot
sdk_hand	https://github.com/X-Square-Robot/sdk_hand
sdk_arm_6a	https://github.com/X-Square-Robot/sdk_arm_6a
XRZero-G0	https://github.com/X-Square-Robot/XRZero-G0
Hugging Face 组织	https://huggingface.co/x-square-robot
WALL-OSS 论文	https://arxiv.org/abs/2509.11766
XRZero-G0 论文	https://arxiv.org/abs/2604.13001

10.2 本地克隆索引

工程内仓库地址列表见 X-Square-Robot/README（5 个 SSH URL）；克隆后目录与 GitHub 仓库名一一对应。

10.3 免责声明

本文基于 2026 年 6 月初 对 GitHub 公开仓库的静态克隆与分析，不构成投资建议 。Star 数、Release 版本、WALL-WM/0.5 代码开放进度以官方仓库为准。sdk_robot 核心 whl 不在 git 源码树内，需从 Release 获取。

文档版本：v1.0 · 2026-06-05