meshy-dev/meshy-openclaw

Meshy 3D — Geração + Impressão

Use o Meshy CLI 0.8 (0.8.5 ou posterior) para transformar a solicitação do usuário em um ativo entregue: os arquivos solicitados no local solicitado, uma prévia inspecionada quando existir e — para impressões — o tamanho pretendido, resultados de análise/reparo e um envio para o fatiador quando solicitado. Apenas o login ou o envio de tarefa não são considerados conclusão. Escolha a pipeline mais curta adequada e reutilize ativos existentes para acompanhamentos.

MANIFESTO DE SEGURANÇA

Executáveis: o Meshy CLI — meshy, ou o pacote temporário fixado npm exec --yes [email protected] -- meshy — mais npm para instalá-lo, node --version para verificar o runtime. Sem Python, sem curl, sem scripts agrupados.

Credenciais: o login pelo navegador do próprio CLI (fluxo de dispositivo OAuth) armazena e atualiza uma sessão em ~/.config/meshy/credentials.v2.json (modo 0600), criptografada sob uma chave que o SO mantém. Um MESHY_API_KEY existente, ou um --api-key-file explícito, é respeitado e tem precedência. O skill nunca lê, imprime ou copia um token, código de dispositivo ou chave, e nunca solicita um no chat. MESHY_API_KEY é opcional.

Rede: a API do Meshy (api.meshy.ai) e sua página de login (www.meshy.ai), ou api.meshy.cn e meshy.cn no site da China; os hosts de mídia dos ativos sendo baixados ou URLs de entrada sendo verificados, sem a credencial; o registro npm quando o CLI é instalado ou executado como um pacote temporário.

Arquivos: escreve apenas dentro de um espaço de trabalho por trabalho — o diretório que o usuário nomeou, ou ./meshy_output — e o CLI recusa caminhos que escapem dele, inclusive através de links simbólicos. Arquivos existentes não são sobrescritos a menos que o usuário tenha solicitado. Lê os arquivos de entrada que o usuário apontou e suas próprias saídas no espaço de trabalho (prévias, arquivos auxiliares). O envio para o fatiador inicia um aplicativo fatiador já instalado.

Dados saindo desta máquina: prompts, imagens/modelos de entrada e solicitações de tarefas enviadas ao Meshy.

Leia o que esta solicitação precisa

Necessidade	Referência
Executor do CLI, login ou local de saída	Configuração
Ativos digitais: geração e os modelos a serem pareados para um projeto, texturização, remalhagem, conversão, imagens	Pipelines
Rigging, animação ou movimento gerado	Animação
Impressões físicas: preparação local, geração de impressão, análise/reparo, fatiadores	Receitas de impressão
Produtos Creative Lab (figuras, luminárias, chaveiros, ímãs, keycaps, brinquedos de dedo)	Creative Lab
Custo, espera, prévia, entrega ou encontrar um modelo anterior	Entrega
Operação com falha ou incerta	Solução de problemas

Leia a seção relevante quando necessário; as receitas são exemplos para adaptar, não etapas a serem executadas por completo. Um modelo sem textura pula a texturização; um GLB existente não precisa de conversão. Use o comando --help quando os parâmetros forem incertos.

Ativo digital ou impressão física

Qualquer coisa destinada a ser impressa — uma impressão, fatiador, 3MF, STL, Bambu/Orca/Prusa/Cura, multicolorido, um brinquedo de mesa ou uma figura física — segue Receitas de impressão a partir do primeiro comando, para que os parâmetros de geração se ajustem à impressão. Todo o resto segue Pipelines.

Solicitação de impressão	Rota
Escalar, orientar ou aterrar um OBJ existente	mesh prepare-print local; sem login ou saldo
Abrir um STL ou 3MF existente	slicer detect e slicer open local; sem login ou saldo
Modelo branco a partir de uma foto, um esboço ou texto	Foto: image-to-3d. Caso contrário, recomendar uma imagem de referência primeiro (vistas múltiplas quando profundidade ou lados importarem), com text-to-3d como a alternativa mais rápida; geometria sem texturas; analisar/reparar conforme necessário; preparar o arquivo
Modelo multicolorido	Gerar/reutilizar geometria; analisar/reparar conforme necessário; texturizar; multi-color-print
Imprimir em partes separadas (plate de construção, cores por parte, menos suportes)	Gerar/reutilizar geometria; dividir automaticamente; fatiar as partes
Verificar ou corrigir um modelo existente (buracos, paredes finas), qualquer formato	analyze-printability gratuito por ID de tarefa ou --model-url; reparar apenas se necessário
Redimensionar um STL, 3MF ou GLB existente	Escalar no fatiador; apenas um OBJ é redimensionado localmente
Figura Creative Lab (um colecionável estilizado a partir de uma foto), figura de vinil, figura de blocos, luminária, chaveiro, ímã de geladeira, keycap ou placa fidget pixel	Protótipo → revisão → construção → selecionar artefatos do produto
Fidget colapsável Creative Lab	Uma criação a partir da foto → STL

As rotas de cor diferem: multicolorido pinta a superfície de um objeto para uma impressora multimaterial; uma divisão corta o objeto em partes, um filamento cada, e descarta a textura (dividir antes de qualquer reparo; os dois não se encadeiam); a placa fidget pixel é um produto próprio.

Uma figura sozinha não implica Creative Lab. Pergunte sobre tamanho, cor ou estilo apenas quando a escolha faltante alterar materialmente o resultado.

Primeiro uso e login no OpenClaw

Antes do primeiro comando, execute meshy --version; não há necessidade de perguntar. Quando meshy estiver ausente ou mais antigo que 0.8.5, instale o 0.8.x mais recente com npm install -g [email protected] e informe isso em uma linha; a Configuração cobre uma instalação recusada e um CLI 0.9 ou mais novo. O trabalho de impressão apenas local para por aí. Todo o resto reutiliza uma sessão auth status verificada; apenas quando não houver nenhuma, faça o login:

1. Inicie meshy auth login --device --format json --no-update-check (adicione --region cn para um usuário na China continental: a mesma conta e créditos do site global) com exec e um yieldMs curto (cerca de 3000) e timeoutSeconds: 900, para que continue sendo executado em segundo plano e retorne um sessionId.
2. O CLI imprime Enter code … at https://www.meshy.ai/device no stderr em segundos. Se a primeira saída contiver apenas avisos do npm, faça process poll nesse mesmo sessionId. Envie ao usuário a URL como um link e o código textualmente, além do que fazer: abri-la, fazer login no Meshy se solicitado, digitar o código, aprovar. Nada precisa ser enviado de volta no chat.
3. Não inicie um segundo login, mate a sessão ou faça polling HTTP você mesmo; o CLI aguarda a aprovação. Quando ele sair, o OpenClaw ativa esta sessão; colete o resultado com process poll (um subagente, que não recebe ativação, faz polling antes de ceder). Em seguida, verifique auth status e continue a solicitação original com as entradas, caminho e orçamento já fornecidos.

Uma sessão em segundo plano não deve ser destacada com & ou nohup. Um código expirado ou negado significa executar o mesmo login novamente; nunca justifica reexecutar uma tarefa paga. Comandos wait longos se comportam da mesma forma: deixe exec colocá-los em segundo plano e retome a partir da ativação de conclusão, em vez de reenviar ou fazer loop em sleep.

Apenas o CLI toca em seu diretório de configuração; um login bloqueado por uma sandbox segue a Configuração, seção 3.

Limites de execução

• Execute operações de API, upload, download e malha através do CLI. Entradas locais têm um limite de 50 MiB, e um modelo local deve ser GLB ou glTF (rigging, UV unwrap e multicolorido: GLB); use a rota de entrada de URL suportada para qualquer outra coisa.
• Cada comando usa --format json --no-update-check e imprime um envelope meshy.cli/v1, incluindo autenticação. Resolva WORKSPACE a partir do caminho de saída do usuário e passe-o para cada gravação.
• Saiba para que serve o modelo antes da primeira criação paga: um ativo de jogo, um personagem para riggar, uma renderização, uma impressão 3D. Se o usuário não disse, pergunte uma vez; a resposta escolhe a rota e os modelos (Pipelines). Um ativo de jogo ou um orçamento de contagem de faces significa topologia inteligente, não um modelo padrão remalhado para baixo.
• Envie uma vez com create --async, mantenha o recurso proprietário e o ID da tarefa, então wait nessa tarefa. Timeouts e envios desconhecidos seguem Solução de Problemas; eles nunca autorizam outra criação paga.
• Sem uma foto utilizável, recomende criar uma imagem de referência primeiro e construir o modelo a partir dela; text-to-3d é a alternativa mais rápida (Pipelines, Começar de uma imagem; impressões: Receitas de impressão, seção 1).
• Trabalhe dentro do escopo e orçamento aprovados; proponha etapas pagas adicionais ou reexecuções antes de gastar. A preparação local e a análise de impressão são gratuitas; Entrega cobre estimativas.
• Reparo altera a geometria e descarta texturas: use a geometria reparada downstream e retexturize antes da saída multicolorida. Prepare um OBJ Y-up uma vez, como um novo arquivo; nunca aplique essa transformação a saída STL, 3MF ou produto em relevo.

Entregar

Baixe apenas os ativos necessários. Envie ao usuário uma prévia renderizada disponível como imagem; uma prévia ausente é declarada, nunca implícita, e um PNG renderizado não é um visualizador 3D. Informe os caminhos dos arquivos, IDs de tarefa para acompanhamentos e o custo real. Para impressões, informe também as dimensões e status de análise/reparo; inicie um fatiador detectado apenas quando solicitado, e observe que launch_requested não prova que o modelo foi importado. Mencione verificações relevantes restantes, como suportes e espessura de parede, sem chamar um modelo não testado de garantidamente imprimível.