# Robot R1 Embodied Reasoning

> Train vision-language models for robotic manipulation using RL to improve embodied reasoning about spatial relationships and movements, achieving 31% improvement on manipulation benchmarks.

- Skill: `adu2021/robot-r1-embodied-reasoning` (Agent Skill)
- Install (CLI): `npx skillmds@latest add adu2021/robot-r1-embodied-reasoning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/adu2021/robot-r1-embodied-reasoning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: adu2021 (https://skillmd.com/u/adu2021)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/adu2021/robot-r1-embodied-reasoning

---


# Robot-R1: Reinforcement Learning for Enhanced Embodied Reasoning in Robotics

## Core Concept

Robot-R1 addresses a fundamental gap in robotics training: supervised fine-tuning datasets are "often heuristically constructed and not explicitly optimized for improving robot control." The framework applies reinforcement learning to teach vision-language models to reason about spatial relationships, movements, and robot state transformations—enabling embodied reasoning that directly improves manipulation performance.

The innovation reformulates robotic control as discrete QA problems, using RL to optimize reasoning about next keypoint states. This achieves 28% improvement over SFT baselines and 31% improvement on manipulation benchmarks, with a 7B model outperforming GPT-4o on spatial reasoning tasks.

## Architecture Overview

- **Core Training Paradigm**: GRPO (Group Relative Policy Optimization) optimizes waypoint prediction through explicit reasoning
- **Task Discretization**: Reformulates continuous action spaces as multiple-choice QA: predicting next robot states from visual observations
- **Three Complementary Objectives**: Waypoint prediction, current state identification, and movement description
- **Reward Combination**: Format rewards (proper output structure) + correctness rewards (exact match evaluation)
- **Vision-Language Base**: Built on Qwen2.5-7B-VL-Instruct, encoding visual observations of robot scenes

## Implementation

1. **Dataset Generation**: Create training data from RLBench simulation environment (50 demonstrations per task, 224×224 resolution)

```python
# Pseudo-code for QA-based training data generation
def generate_qa_from_demonstration(demo_trajectory, task_id):
    """
    Convert robot trajectory into spatial reasoning QA pairs.
    Generates waypoint, state, and movement prediction questions.
    """
    frames = demo_trajectory['frames']
    waypoints = demo_trajectory['keypoints']

    qa_pairs = []

    # Waypoint prediction: given current frame, predict next keypoint
    for i in range(len(frames) - 1):
        question = f"Next robot state after seeing: {visual_description(frames[i])}"
        options = [waypoints[i+1], random_waypoint(), random_waypoint()]
        qa_pairs.append({'question': question, 'options': options})

    # Current state prediction: identify robot configuration
    for i in range(len(frames)):
        question = f"Current gripper position in frame {i}: ?"
        options = [waypoints[i], random_waypoint(), random_waypoint()]
        qa_pairs.append({'question': question, 'options': options})

    # Movement description: linguistic output
    for i in range(len(frames) - 1):
        movement = describe_direction(waypoints[i], waypoints[i+1])
        qa_pairs.append({'question': question, 'answer': movement})

    return qa_pairs  # ~7,500 QA pairs per task
```

2. **Reward Function Design**: Implement dual reward structure

```python
# Dual reward calculation
def compute_reward(generated_answer, ground_truth):
    """
    Combines format correctness (output structure) and
    answer correctness (spatial accuracy).
    """
    format_reward = 0.0
    if generated_answer.has_valid_structure():
        format_reward = 1.0

    correctness_reward = 0.0
    if exact_match(generated_answer, ground_truth):
        correctness_reward = 1.0
    elif spatial_proximity(generated_answer, ground_truth) > threshold:
        correctness_reward = 0.5

    total_reward = 0.4 * format_reward + 0.6 * correctness_reward
    return total_reward
```

3. **Training Configuration**: Apply GRPO optimization with specific hyperparameters
   - Batch size: 128 over 5 epochs
   - Learning rate: 1.0×10⁻⁶ with weight decay 1.0×10⁻²
   - Generate 5 samples per prompt with temperature 1.0
   - Rollout batch size: 512

4. **Evaluation Strategy**: Create Robot-R1 Bench with 215 open-ended questions across four reasoning types (planning, high-level action, movement, spatial), validated against human expert assessments (0.89+ Pearson correlation with GPT-4o automated judging).

## Practical Guidance

**When to Apply:**
- Training vision-language models for robotic manipulation tasks
- Need to improve spatial and movement reasoning without massive labeled datasets
- Want to move beyond heuristically-constructed SFT datasets

**Key Implementation Points:**
- Start with RLBench or equivalent simulation for safe trajectory collection
- Frame all robotic control as discrete QA problems to leverage LLM reasoning
- Ensure human evaluation shows 0.89+ agreement with automated reward scoring
- Use visual descriptions at appropriate abstraction level (not raw pixels)

**Performance Targets:**
- 28%+ improvement in embodied reasoning vs SFT baselines
- 7B models achieving GPT-4o-level spatial reasoning
- 31%+ improvement on manipulation benchmarks
- Lower correlation on planning tasks (0.33) acceptable due to multi-solution validity

**Common Challenges:**
- Trajectory quality significantly impacts learned reasoning—ensure demonstrations are skilled
- Visual encoding must preserve spatial information (224×224 minimum resolution)
- Movement descriptions need consistent vocabulary across dataset
- Automated rewards may miss subtle but correct solutions—conduct human validation

## Reference

Implemented on Qwen2.5-7B-VL-Instruct with RLBench simulation environment. Training uses 16 A100 GPUs with GRPO algorithm. Evaluated on proprietary Robot-R1 Bench and established robotics benchmarks (EmbodiedBench Manipulation, SpatialRGPT).