A bi-directional TCP socket skill for real-time Blender scene manipulation and asset integration in headless environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install blender-interactive
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-interactive 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 Interactive Socket Server?
The Blender Interactive skill enables seamless, real-time control over Blender instances using a bi-directional TCP socket protocol. Designed to complement batch-driven pipelines, this addition to the Openclaw Skills ecosystem allows AI agents to interactively build complex 3D scenes, query object states, and automate rendering tasks on remote or local headless servers.
By establishing a persistent socket connection, users can bypass the overhead of repeatedly launching Blender for every task. This skill is particularly optimized for headless environments where GPU access might be limited, utilizing Cycles CPU rendering for accurate previews and final outputs while maintaining a small memory footprint suitable for mini-PC deployments.
Blender Interactive Socket Server Use Cases
- Real-time 3D scene construction and object manipulation through AI agents.
- Automated fetching and application of CC0 assets from Poly Haven.
- Interactive state querying to monitor object locations, materials, and scene hierarchy.
- High-resolution rendering and preview generation on remote headless nodes.
- Dynamic material assignment and PBR texture mapping via code execution.
How Blender Interactive Socket Server Works
- The skill initializes a TCP socket server within a Blender instance using a specialized Python add-on.
- A client script sends JSON-formatted command packets over port 9876.
- Blender receives the packet and queues the operation within its main thread using the internal timer system.
- The command is executed (e.g., creating a sphere, applying a texture, or running arbitrary Python code).
- A JSON response containing the success status and any requested data is returned to the client.
Blender Interactive Socket Server Setup
To start the interactive server on a remote node, use the following commands within the Openclaw Skills framework:
# Start the Blender socket server
nodes.run(node="MiniPC", command=[
"bash", "-c",
"blender -b --factory-startup --python /home/spritz/blender-interactive/blender_socket_addon.py -- --port 9876 &"
])
# Verify connection with a ping
nodes.run(node="MiniPC", command=[
"python3", "/home/spritz/blender-interactive/scripts/blender_client.py",
"ping"
])
Blender Interactive Socket Server Data Schema & Taxonomy
The skill communicates using a structured JSON protocol for both requests and responses.
| Component | Format | Description |
|---|---|---|
| Request | {"type": "command", "params": {}} |
The standard envelope for all instructions. |
| Response | {"status": "success", "result": {}} |
Returned upon successful execution. |
| Error | {"status": "error", "message": "..."} |
Returned if a command fails or parameters are invalid. |
File Structure:
blender_socket_addon.py: The core server script running inside Blender.scripts/blender_client.py: The CLI utility for sending instructions.scripts/polyhaven.py: Integration for external asset libraries.
Blender Interactive Socket Server Advanced Features
- Arbitrary Python code execution for maximum flexibility in scene automation.
- Integrated Poly Haven API client for downloading HDRI, textures, and 3D models directly into the workspace.
- Multi-client support with sequential command processing to prevent race conditions.
- Systemd service templates for persistent, auto-restarting background operations.
- Headless-optimized rendering pipeline using Cycles CPU for reliable output without GPU dependencies.
SKILL.md
Loading
Related Openclaw Skills
Anti-Slop Design
A specialized design framework for AI agents to create high-end, non-generic frontend interfaces and game UIs.
AllStar Link Node Control
A specialized client for monitoring and controlling AllStar Link amateur radio nodes through a secure REST API using Openclaw Skills.
Soft Pillow
A specialized AI skill for retrieving and analyzing sleep logs, dream journals, and mood data from the Soft Pillow iOS application.
babblebrush
A voice-first image editing skill that enables iterative generation, version branching, and multi-model management through a structured canvas system.
Blender Headless Game Asset Pipeline
A comprehensive automation toolkit for 3D game asset production using the Blender Python API (bpy) in headless environments.
Game Design Skill
A comprehensive game design framework providing structured workflows for core loops, balancing curves, and monetization strategies.
Featured*
