Blender Bpy

---

name: blender_bpy description: Blender Python scripting via bpy API. Use for scene automation, procedural modeling, batch rendering, and object manipulation. metadata: { "openclaw": { "requires": { "bins": ["blender"] }, "user-invocable": true } }

---

Blender Python Automation (bpy)

Prerequisites

Blender must be installed and accessible from the CLI (blender --version).

Scripts run via: blender --background --python

For interactive use: connect via Blender's built-in Python console or the REST server addon.

Common Snippets

Create an object

import bpy
bpy.ops.mesh.primitive_cube_add(location=(0, 0, 0))
obj = bpy.context.object
obj.name = "MyCube"

Batch render all frames

import bpy
scene = bpy.context.scene
scene.render.filepath = "//renders/frame_"
bpy.ops.render.render(animation=True)

Apply a material by name

import bpy
mat = bpy.data.materials.get("MyMaterial")
if mat is None:
    mat = bpy.data.materials.new(name="MyMaterial")
obj = bpy.context.object
if obj.data.materials:
    obj.data.materials[0] = mat
else:
    obj.data.materials.append(mat)

Tips

Always use --background when running headless (no UI).

Use bpy.data (global access) vs bpy.context (active selection) correctly.

For long renders, consider Cron jobs in OpenClaw so main chat isn't blocked.

Blender must be installed and accessible from the CLI (blender --version).

Scripts run via: blender --background --python

For interactive use: connect via Blender's built-in Python console or the REST server addon.

Always use --background when running headless (no UI).

Use bpy.data (global access) vs bpy.context (active selection) correctly.

For long renders, consider Cron jobs in OpenClaw so main chat isn't blocked.