meshy-dev/meshy-openclaw

Meshy 3D — Generación + Impresión

Usa la CLI de Meshy 0.8 (0.8.5 o posterior) para convertir la solicitud del usuario en un activo entregado: los archivos solicitados en la ubicación solicitada, una vista previa inspeccionada cuando exista y, para impresiones, el tamaño previsto, los resultados de análisis/ reparación y una transferencia al slicer cuando se solicite. El inicio de sesión o el envío de tareas por sí solos no constituyen finalización. Elige la canalización más corta adecuada y reutiliza los activos existentes para seguimientos.

MANIFIESTO DE SEGURIDAD

Ejecutables: la CLI de Meshy — meshy, o el paquete temporal fijado npm exec --yes [email protected] -- meshy — además de npm para instalarlo, node --version para comprobar el entorno de ejecución. Sin Python, sin curl, sin scripts empaquetados.

Credenciales: el inicio de sesión propio del navegador de la CLI (flujo de dispositivo OAuth) almacena y actualiza una sesión en ~/.config/meshy/credentials.v2.json (modo 0600), cifrada bajo una clave que el sistema operativo mantiene. Se respeta una MESHY_API_KEY existente, o un --api-key-file explícito, y tiene prioridad. La skill nunca lee, imprime ni copia un token, código de dispositivo o clave, y nunca solicita uno en el chat. MESHY_API_KEY es opcional.

Red: la API de Meshy (api.meshy.ai) y su página de inicio de sesión (www.meshy.ai), o api.meshy.cn y meshy.cn en el sitio de China; los hosts de medios de los activos que se descargan o de las URL de entrada que se verifican, sin la credencial; el registro npm cuando la CLI se instala o ejecuta como paquete temporal.

Archivos: escribe solo dentro de un espacio de trabajo por trabajo — el directorio que el usuario nombró, o ./meshy_output — y la CLI rechaza rutas que escapen de él, incluso a través de enlaces simbólicos. Los archivos existentes no se sobrescriben a menos que el usuario lo solicite. Lee los archivos de entrada que el usuario señaló y sus propias salidas en el espacio de trabajo (vistas previas, archivos auxiliares). La transferencia al slicer inicia una aplicación de slicer ya instalada.

Datos que salen de esta máquina: indicaciones, imágenes/modelos de entrada y solicitudes de tareas enviadas a Meshy.

Lee lo que esta solicitud necesita

Necesidad	Referencia
Ejecutor de CLI, inicio de sesión o ubicación de salida	Configuración
Activos digitales: generación y los modelos para emparejar en un proyecto, texturizado, remallado, conversión, imágenes	Canalizaciones
Rigging, animación o movimiento generado	Animación
Impresiones físicas: preparación local, generación de impresión, análisis/reparación, slicers	Recetas de impresión
Productos de Creative Lab (figuras, lámparas, llaveros, imanes, keycaps, fidgets)	Creative Lab
Costo, espera, vista previa, entrega o búsqueda de un modelo anterior	Entrega
Operación fallida o incierta	Solución de problemas

Lee la sección relevante cuando sea necesario; las recetas son ejemplos para adaptar, no etapas para ejecutar por completo. Un modelo sin texturizar omite el texturizado; un GLB existente no necesita conversión. Usa --help del comando cuando los parámetros sean inciertos.

Activo digital o impresión física

Cualquier cosa destinada a imprimirse — una impresión, slicer, 3MF, STL, Bambu/Orca/Prusa/Cura, multicolor, un juguete de escritorio o una figura física — sigue las Recetas de impresión desde el primer comando, para que los parámetros de generación se ajusten a la impresión. Todo lo demás sigue Canalizaciones.

Solicitud de impresión	Ruta
Escalar, orientar o enrasar un OBJ existente	mesh prepare-print local; sin inicio de sesión ni saldo
Abrir un STL o 3MF existente	slicer detect y slicer open locales; sin inicio de sesión ni saldo
Modelo blanco a partir de una foto, un boceto o texto	Foto: image-to-3d. De lo contrario, recomendar primero una imagen de referencia (vista múltiple cuando la profundidad o los lados importen), con text-to-3d como alternativa más rápida; geometría sin texturas; analizar/reparar según sea necesario; preparar el archivo
Modelo multicolor	Generar/reutilizar geometría; analizar/reparar según sea necesario; texturizar; multi-color-print
Imprimir en partes separadas (placa de construcción, colores por parte, menos soportes)	Generar/reutilizar geometría; división automática; cortar las partes
Verificar o arreglar un modelo existente (agujeros, paredes delgadas), cualquier formato	analyze-printability gratuito por ID de tarea o --model-url; reparar solo si es necesario
Redimensionar un STL, 3MF o GLB existente	Escalarlo en el slicer; solo un OBJ se redimensiona localmente
Figura de Creative Lab (un coleccionable estilizado a partir de una foto), figura de vinilo, figura de ladrillos, lámpara, llavero, imán para nevera, keycap o tablero fidget de píxeles	Prototipo → revisión → construcción → seleccionar artefactos del producto
Fidget plegable de Creative Lab	Una creación a partir de la foto → STL

Las rutas de color difieren: multicolor pinta la superficie de un objeto para una impresora de múltiples materiales; una división lo corta en partes, un filamento cada una, y elimina la textura (dividir antes de cualquier reparación; los dos no se encadenan); el tablero fidget de píxeles es un producto propio.

Una figura por sí sola no implica Creative Lab. Pregunta sobre tamaño, color o estilo solo cuando la elección faltante cambie materialmente el resultado.

Primer uso e inicio de sesión en OpenClaw

Antes del primer comando ejecuta meshy --version; no es necesario preguntar. Cuando meshy falte o sea anterior a 0.8.5, instala la última versión 0.8.x con npm install -g [email protected] e indícalo en una línea; la Configuración cubre una instalación rechazada y una CLI 0.9 o superior. El trabajo de impresión solo local se detiene ahí. Todo lo demás reutiliza una sesión auth status verificada; solo cuando no hay ninguna, inicia sesión:

1. Inicia meshy auth login --device --format json --no-update-check (agrega --region cn para un usuario en China continental: la misma cuenta y créditos que el sitio global) con exec y un yieldMs corto (aproximadamente 3000) y timeoutSeconds: 900, para que se ejecute en segundo plano y devuelva un sessionId.
2. La CLI imprime Enter code … at https://www.meshy.ai/device en stderr en segundos. Si la primera salida contiene solo avisos de npm, process poll ese mismo sessionId. Envía al usuario la URL como enlace y el código textualmente, además de qué hacer: abrirla, iniciar sesión en Meshy si se solicita, escribir el código y aprobar. No es necesario enviar nada de vuelta en el chat.
3. No inicies un segundo inicio de sesión, finalices la sesión ni hagas polling HTTP tú mismo; la CLI espera la aprobación. Cuando termine, OpenClaw activa esta sesión; recoge el resultado con process poll (un subagente, que no recibe activación, hace polling antes de ceder). Luego verifica auth status y continúa la solicitud original con las entradas, la ruta y el presupuesto ya dados.

Una sesión en segundo plano no debe separarse con & o nohup. Un código caducado o denegado significa ejecutar el mismo inicio de sesión nuevamente; nunca justifica re-ejecutar una tarea paga. Los comandos wait largos se comportan de la misma manera: deja que exec los ejecute en segundo plano y reanuda desde la activación de finalización, en lugar de reenviar o hacer bucles con sleep.

Solo la CLI toca su directorio de configuración; un inicio de sesión bloqueado por un sandbox sigue la Configuración, sección 3.

Límites de ejecución

• Ejecuta operaciones de API, carga, descarga y malla a través de la CLI. Las entradas locales tienen un límite de 50 MiB, y un modelo local debe ser GLB o glTF (rigging, UV unwrap y multicolor: GLB); usa la ruta de entrada de URL admitida para cualquier otra cosa.
• Cada comando usa --format json --no-update-check e imprime un sobre meshy.cli/v1, incluida la autenticación. Resuelve WORKSPACE desde la ruta de salida del usuario y pásalo a cada escritura.
• Sepa para qué es el modelo antes de la primera creación paga: un activo de juego, un personaje para riggear, un render, una impresión 3D. Si el usuario no lo ha dicho, pregunta una vez; la respuesta elige la ruta y los modelos (Canalizaciones). Un activo de juego o un presupuesto de conteo de caras significa topología inteligente, no un modelo estándar remallado hacia abajo.
• Envía una vez con create --async, conserva el recurso propietario y el ID de tarea, luego wait en esa tarea. Los tiempos de espera y los envíos desconocidos siguen la Solución de problemas; nunca autorizan otra creación paga.
• Sin una foto utilizable, recomienda crear primero una imagen de referencia y construir el modelo a partir de ella; text-to-3d es la alternativa más rápida (Canalizaciones, Comenzar desde una imagen; impresiones: Recetas de impresión, sección 1).
• Trabaja dentro del alcance y presupuesto aprobados; propón etapas pagas adicionales o re-ejecuciones antes de gastar. La preparación local y el análisis de imprimibilidad son gratuitos; la Entrega cubre estimaciones.
• La reparación cambia la geometría y elimina texturas: usa la geometría reparada aguas abajo y vuelve a texturizar antes de la salida multicolor. Prepara un OBJ con Y hacia arriba una vez, como un archivo nuevo; nunca apliques esa transformación a salidas STL, 3MF o de producto en relieve.

Entregar

Descarga solo los activos necesarios. Envía al usuario una vista previa renderizada disponible como imagen; una vista previa faltante se indica, nunca se implica, y un PNG renderizado no es un visor 3D. Informa las rutas de archivo, los ID de tarea para seguimientos y el costo real. Para impresiones, informa también las dimensiones y el estado de análisis/reparación; inicia un slicer detectado solo cuando se solicite, y señala que launch_requested no prueba que el modelo se haya importado. Menciona las comprobaciones relevantes restantes, como soportes y grosor de pared, sin declarar que un modelo no probado es imprimible garantizado.