Automate 3D asset generation, procedural modeling, rendering, and 3D print preparation using Blender's Python API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install blender-bpy-enhanced
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install blender-bpy-enhanced using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Blender Python Automation (bpy)?
The blender-bpy automation skill provides developers and AI agents with the ability to programmatically drive Blender 3D workflows using the official Python bpy API. This capability allows for headless rendering, procedural model generation, automatic material node setup, and direct export to web-ready formats like GLB or 3D-printable STL files.
By incorporating this workspace capability into Openclaw Skills, developers can unlock automated pipelines for asset creation, rendering automation, and rapid physical modeling prototyping. The skill handles everything from scene clearing and dynamic 3-point lighting setup to complex math-driven coordinate shader seams.
Blender Python Automation (bpy) Use Cases
- Creating procedural 3D assets such as gears, structural components, or custom mechanical parts.
- Generating photorealistic marketing images or mockups on headless servers.
- Batch exporting models to GLB/glTF formats for web applications or games.
- Preparing solid models with specific wall-thickness configurations for physical FDM or SLA 3D printing.
- Automating high-volume render pipelines with Cycles and Eevee.
How Blender Python Automation (bpy) Works
- Scene Preparation: Clear existing objects, cameras, and obsolete materials to build from a clean workspace.
- Procedural Geometry Generation: Build parametric 3D meshes using coordinate formulas, extrusions, and modifiers.
- Shading & Texture Assignment: Define material nodes programmatically to apply procedural metals, glass, or dynamic coordinate patterns.
- Environment & Lighting Setup: Programmatically place standard 3-point area lights and focus the camera target dynamically.
- Rendering & Export: Run headless execution using the Cycles or Eevee engine to render high-fidelity PNGs or export watertight STL/GLB files.
Blender Python Automation (bpy) Setup
Ensure that Blender is installed in your target environment.
# Debian/Ubuntu (Linux)
apt-get install blender
# macOS
brew install blender
# Verify CLI exposure
blender --version
To execute scripts headlessly with this Openclaw Skills resource:
blender --background --python script.py
Blender Python Automation (bpy) Data Schema & Taxonomy
The skill organizes script execution inputs, generated geometry settings, and rendering variables.
Asset Generation Schema
| Variable / Output | Format | Description |
|---|---|---|
output_path |
String | Local directory path to write the rendered image or exported 3D model. |
render.engine |
String | Chosen render engine (CYCLES or BLENDER_EEVEE). |
unit_settings |
Struct | Defines unit system (e.g., metric with scale length of 0.01 for cm). |
Generated File Types
- 3D Assets:
.stl(3D printing),.glb/.gltf(Web graphics). - Visual Renders:
.png(Headless renders with optional denoising). - Source Blueprints:
.py(Reusable Python scripts driving thebpyAPI).
Blender Python Automation (bpy) Advanced Features
- Headless GPU Accelerated Rendering: Automatically detects and leverages macOS Metal or desktop GPUs for accelerated Cycles path-tracing.
- Procedural Shader Seams: Implements complex mathematical formulas (such as basketball curved seams) directly into shader nodes, avoiding heavy geometric subdivisions.
- Smart Boolean Carving: Avoids bulk subtraction pitfalls by handling cuts sequentially and ensuring safe bounding overlaps to maintain watertight meshes.
- 3D Print Calibration: Built-in support for metric unit scaling, mesh solidification rules, and polycount optimization using decimation modifiers.
SKILL.md
Loading
Related Openclaw Skills
Xiaoqinli (XQL)
An AST-First transpiler enabling AI agents to write structured JSON AST directly, compiling it into type-safe Go, Rust, TypeScript, Kotlin, Swift, and Python.
Viral Content Score
An AI-powered copywriting evaluation engine that predicts content virality across TikTok, Twitter, YouTube Shorts, and Instagram.
Cross-Cultural Insight
An AI-powered global brand compliance engine that detects linguistic, visual, and cultural risks across 50+ international markets.
Nefrologia Clinica (Clinical Nephrology)
An AI-powered clinical nephrology assistant supporting literature searches, decision-making, and clinical reasoning in kidney diseases, acid-base imbalances, and renal replacement therapies.
AI Startup Scout
A real-time investment and market intelligence scouting tool for tracking global AI startups, funding rounds, and founding team backgrounds.
System Dynamics
An AI-powered system dynamics modeling skill that designs feedback loops, identifies stock-flow boundaries, and simulates high-leverage intervention effects.
Featured*
