synthclaw

---

name: synthclaw

version: 0.1.3

license: MIT

description: Render Blender files with agent-controlled procedural parameters for synthetic data generation. Use when generating training data with controlled variations, creating procedural image datasets, or automating Blender renders via natural language. Supports CYCLES (production) and EEVEE (fast testing) render engines.

---

When to Use

When NOT to Use

Requirements

Configuration

No additional configuration required. Ensure `blender` command is available:

blender --version

Tools

render_procedural_scene

Adjusts procedural Value Nodes and renders a frame in Blender.

**Parameters:**

**Returns:**

**Examples:**

*Production quality (CYCLES):*

{
  "blend_file": "/home/user/project/assets/test.blend",
  "output_path": "/home/user/output/render_01.png",
  "parameters": {
    "GrainScale": 3.0,
    "DisplacementStrength": 1.5
  },
  "engine": "CYCLES",
  "samples": 256
}

*Fast testing (EEVEE):*

{
  "blend_file": "/home/user/project/assets/test.blend",
  "output_path": "/home/user/output/test_render.png",
  "parameters": {
    "GrainScale": 3.0
  },
  "engine": "EEVEE"
}

render_procedural_scene_fast

Convenience function for fast EEVEE rendering. Same as `render_procedural_scene` with `engine="EEVEE"`.

**Parameters:**

render_procedural_scene_production

Convenience function for production Cycles rendering. Same as `render_procedural_scene` with `engine="CYCLES"` and higher samples.

**Parameters:**

analyze_blend

Analyzes a .blend file and returns available Value Nodes that can be manipulated.

**Parameters:**

**Returns:** Dict containing `status`, a `complexity` object evaluating scene realism, and `value_nodes` (available parameter names with current values).

Engine Comparison

| Feature | CYCLES | EEVEE |

|---------|--------|-------|

| Quality | Photorealistic | Real-time |

| Speed | Slow (minutes) | Fast (seconds) |

| Timeout | 30 minutes | 1 minute |

| Use case | Production | Testing |

| Samples | Configurable | N/A |

Safety & Limitations

Files

| File | Purpose |

|------|---------|

| `src/synthclaw/blender_skill.py` | OpenClaw execution wrapper with engine selection |

| `scripts/agent_bridge.py` | Blender-side Python script (handles both engines) |

| `scripts/analyze_blends.py` | Blender-side analysis script |

| `config/render_schema.json` | Tool schema for LLM function calling |

| `config/analyze_schema.json` | Schema for blend file analysis |

Example Workflow

1. User: "Render with grain scale increased and surface rougher"

2. Agent calls `analyze_blend` to see available parameters

3. Agent calls `render_procedural_scene_fast` (EEVEE) for quick preview

4. If preview looks good, agent calls `render_procedural_scene_production` (CYCLES) for final output

5. Render completes, path returned to user

Version

Compatible with Blender 4.0+. Not backwards compatible with 2.7x.