OpenClaw 3D Blender MCP Skill
Skill completo para instalar, configurar y usar Blender MCP con OpenClaw. Incluye todo lo necesario para empezar a crear personajes 3D.
⚠️ Step 0: Estudiar Recursos (ANTES de Instalar)
Estudia estos 3 recursos primero (~40 minutos):
- 1. blender-mcp Official Repo - https://github.com/ahujasid/blender-mcp (~15 min)
- Instalación oficial, herramientas soportadas, configuración
- 2. blender-orchestrator - https://github.com/mlolson/blender-orchestrator (~15 min)
- Spatial reasoning, real-world dimensions (55+ objetos)
- 3. Video: "I Made Claude Use Blender" - https://www.youtube.com/watch?v=dxlyCPGCvy8 (~10 min)
- Setup completo, demo en vivo, ejemplos prácticos
¿Por qué estudiar primero? Evita errores de posicionamiento, enseña coordenadas relativas, muestra ejemplos de éxito.
Step 1: Verificar Prerrequisitos
CODEBLOCK0
Step 2: Elegir Tipo de Setup
Opción A: Local (Misma Computadora)
CODEBLOCK1
Configurar MCP:
CODEBLOCK2
Instalar addon en Blender:
- - Descargar de https://github.com/ahujasid/blender-mcp
- Blender: Edit → Preferences → Add-ons → Install
- Presionar N en viewport → BlenderMCP → Connect
Opción B: Remoto (Diferente Computadora)
En computadora con Blender:
CODEBLOCK3
En OpenClaw:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"],
"env": {
"BLENDER_HOST": "X.tcp.eu.ngrok.io",
"BLENDER_PORT": "PORT"
}
}
}
}
Step 3: Verificar Conexión
CODEBLOCK5
Output esperado:
✅ Conexión TCP: OK
✅ MCP inicializado
✅ CUBO CREADO - TEST_CUBE_CONNECTION
✅ VERIFICACIÓN COMPLETADA
Step 4: Inspeccionar Escena
CODEBLOCK7
Muestra: total objetos, lista con nombres, ubicaciones (X,Y,Z).
🔧 Troubleshooting
Error: "Connection refused"
Fix: Verificar ngrok corriendo y addon conectado en Blender.
Error: "Invalid request parameters"
Fix: Usar formato
tools/call correcto:
CODEBLOCK8
Error: Objetos en ubicación incorrecta
Fix: Usar coordenadas relativas al padre, no absolutas.
Error: Materiales no visibles
Fix: Decir usuario "Presiona Z → Material Preview".
📚 Recursos Incluidos
- -
scripts/verify_blender_connection.py - Test de conexión - INLINECODE2 - Info de escena
- INLINECODE3 - Coordenadas Blender
- INLINECODE4 - 10 errores + soluciones
🎯 Mejores Prácticas
- - ✅ Usar coordenadas relativas (parent-based)
- ✅ Aplicar parenting para objetos relacionados
- ✅ Verificar después de cada creación
- ✅ Usar Subdivision Surface para orgánicos
- ✅ Guardar frecuentemente (.blend)
📐 Referencia Rápida de Coordenadas
Ejes Blender: X (Derecha/+), Y (Frente/+), Z (Arriba/+)
Personaje en origen:
- - Pies: Z 0-3
- Rodillas: Z 5-8
- Caderas: Z 8-10
- Torso: Z 10-13
- Hombros: Z 13-14, X ±1.5
- Cabeza: Z 14-17
- Ojos: Z 16, Y 1.5
Estilo Pixar:
- - Radio cabeza: 1.4-1.6 (vs 1.0 realista)
- Radio ojos: 0.4 (vs 0.2 realista)
Versión: 1.0.0 | 2026-04-01 | Basado en 4 ciclos de desarrollo (~90 min)OpenClaw 3D Blender MCP 技能
使用 OpenClaw 安装、配置和使用 Blender MCP 的完整技能。包含开始创建 3D 角色所需的一切。
⚠️ 第 0 步：学习资源（安装之前）
先学习这 3 个资源（约 40 分钟）：
- 1. blender-mcp 官方仓库 - https://github.com/ahujasid/blender-mcp（约 15 分钟）
- 官方安装方法、支持的工具、配置说明
- 2. blender-orchestrator - https://github.com/mlolson/blender-orchestrator（约 15 分钟）
- 空间推理、真实世界尺寸（55+ 个对象）
- 3. 视频：I Made Claude Use Blender - https://www.youtube.com/watch?v=dxlyCPGCvy8（约 10 分钟）
- 完整设置、现场演示、实际案例
为什么要先学习？ 避免定位错误，学习相对坐标，查看成功案例。
第 1 步：检查前置条件
bash
python3 --version # 需要 3.10 或更高版本
which uv # 安装：brew install uv（macOS）
第 2 步：选择设置类型
选项 A：本地（同一台电脑）
bash
uvx blender-mcp
配置 MCP：
json
{
mcpServers: {
blender: {
command: uvx,
args: [blender-mcp],
env: {
BLENDER_HOST: localhost,
BLENDER_PORT: 9876,
DISABLE_TELEMETRY: true
}
}
}
}
在 Blender 中安装插件：
- - 从 https://github.com/ahujasid/blender-mcp 下载
- Blender：编辑 → 偏好设置 → 插件 → 安装
- 在视口中按 N → BlenderMCP → 连接
选项 B：远程（不同电脑）
在装有 Blender 的电脑上：
bash
ngrok tcp 9876
保存 URL：tcp://X.tcp.eu.ngrok.io:PORT
在 OpenClaw 中：
json
{
mcpServers: {
blender: {
command: uvx,
args: [blender-mcp],
env: {
BLENDER_HOST: X.tcp.eu.ngrok.io,
BLENDER_PORT: PORT
}
}
}
}
第 3 步：验证连接
bash
python3 scripts/verifyblenderconnection.py
预期输出：
✅ TCP 连接：正常
✅ MCP 已初始化
✅ 已创建立方体 - TESTCUBECONNECTION
✅ 验证完成
第 4 步：检查场景
bash
python3 scripts/getsceneinfo.py
显示：对象总数、名称列表、位置（X,Y,Z）。
🔧 故障排除
错误：Connection refused
解决方法： 检查 ngrok 是否运行，以及 Blender 中的插件是否已连接。
错误：Invalid request parameters
解决方法： 使用正确的 tools/call 格式：
python
send(tools/call, {
name: execute
blendercode,
arguments: {user_prompt: 描述, code: ...}
})
错误：对象位置不正确
解决方法： 使用相对于父级的坐标，而非绝对坐标。
错误：材质不可见
解决方法： 告诉用户按 Z → 材质预览。
📚 包含的资源
- - scripts/verifyblenderconnection.py - 连接测试
- scripts/getsceneinfo.py - 场景信息
- references/coordinatesystem.md - Blender 坐标系统
- references/commonerrors.md - 10 个常见错误及解决方案
🎯 最佳实践
- - ✅ 使用相对坐标（基于父级）
- ✅ 对相关对象应用父子关系
- ✅ 每次创建后进行检查
- ✅ 对有机模型使用细分曲面
- ✅ 经常保存（.blend 文件）
📐 快速坐标参考
Blender 轴： X（右/+），Y（前/+），Z（上/+）
角色在原点：
- - 脚部：Z 0-3
- 膝盖：Z 5-8
- 臀部：Z 8-10
- 躯干：Z 10-13
- 肩膀：Z 13-14，X ±1.5
- 头部：Z 14-17
- 眼睛：Z 16，Y 1.5
皮克斯风格：
- - 头部半径：1.4-1.6（真实风格为 1.0）
- 眼睛半径：0.4（真实风格为 0.2）
版本：1.0.0 | 2026-04-01 | 基于 4 个开发周期（约 90 分钟）
