blender-interactive

What This Skill Does

The blender-interactive skill provides a robust bridge between the OpenClaw agent and a headless Blender 5.0.1 instance running on a remote MiniPC. Unlike batch-processing pipelines, this skill maintains a persistent TCP socket connection on port 9876, enabling true bi-directional communication. This allows users to treat Blender as a real-time service, performing live scene manipulation, object instantiation, material adjustments, and immediate preview rendering. By utilizing a persistent socket, you avoid the heavy overhead of restarting the Blender process for every single command, making it the ideal choice for iterative design workflows, experimental 3D content generation, and dynamic scene construction.

Installation

To integrate this skill into your OpenClaw environment, ensure that your MiniPC host has Blender 5.0.1 installed and that the target machine is accessible via the network. Install the skill using the command: clawhub install openclaw/skills/skills/kjaylee/blender-interactive

Once installed, you must initialize the server on your MiniPC node. You can trigger the server start via the agent using: nodes.run(node="MiniPC", command=["bash", "/home/spritz/blender-interactive/scripts/start_server.sh", "--background"]). Verify connectivity by running the ping command through the client script.

Use Cases

• Real-time Scene Prototyping: Rapidly place and adjust objects within a 3D space to test layouts before committing to a final render.
• Dynamic Asset Integration: Automatically fetch and place assets from Poly Haven or Sketchfab into an active scene based on user requirements.
• Interactive Visual Debugging: Query the state of specific objects, check camera placement, or inspect material nodes programmatically during the creative process.
• Iterative Refinement: Apply material changes (color, metallic, roughness) to objects and request instant preview renders to verify appearance adjustments.

Example Prompts

1. "Check the current status of the blender server on the MiniPC and list all objects currently in the scene."
2. "Create a new sphere named 'Planet_X' at position [5, 2, 0] and apply a metallic blue material to it."
3. "Render a 512x512 preview of the current scene with 32 samples and save it to /tmp/render_test.png."

Tips & Limitations

• Performance: For high-fidelity renders or complex geometry, consider that socket communication is best suited for scene management. Very large data transfers over the socket might introduce minor latency.
• Persistence: Ensure the server script is managed carefully. If the process terminates, you must re-invoke the start_server.sh script to restore the connection.
• Headless Mode: This skill is specifically optimized for headless Blender 5.0.1; GUI-based interactions are not supported via this socket protocol. Always verify your nodes.run commands have the correct environmental paths set for your specific MiniPC configuration.