Skill da Meshy para o OpenClaw

A skill oficial da Meshy para o OpenClaw permite que seu agente gere modelos 3D, texturas e animações, além de preparar impressões 3D, tudo a partir de um chat.

Visão geral

A Meshy agora está disponível no ClawHub como Meshy 3D Agent, uma skill que abrange:

  • Geração 3D: texto para 3D, imagem para 3D e multivista para 3D, texturização e retexturização com IA, remesh para um orçamento de polígonos, desdobramento de UV, rigging automático e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • Impressão 3D: análise e reparo de imprimibilidade, 3MF em cor única e multicolorido, dimensionamento para medidas do mundo real, produtos do Creative Lab (bonecos, luminárias, chaveiros, ímãs de geladeira) e transferência para um fatiador instalado, como o Bambu Studio, OrcaSlicer ou Creality Print.

A skill opera por meio do Meshy CLI. Você faz login uma vez no navegador; não é necessária uma chave de API.

Requisitos

  • OpenClaw.
  • Node.js 22.12 ou mais recente, com npm, na máquina onde o OpenClaw é executado. A skill se torna elegível quando meshy ou npm está no PATH.
  • Um plano pago da Meshy para geração. Cada tarefa de geração consome créditos da Meshy de acordo com as taxas da API. A análise de imprimibilidade é gratuita, e as etapas locais de impressão, como redimensionar um modelo ou abri-lo em um fatiador, não exigem login.

Instalação

Instale a skill a partir do ClawHub:

openclaw skills install @arlieeee/meshy-3d-agent

O OpenClaw oferece a instalação do Meshy CLI via npm caso ainda não esteja instalado. Uma instalação global apenas torna a inicialização mais rápida; sem ela, a skill executa a CLI por meio do npm exec.

Você também pode deixar o agente fazer toda a configuração. Cole isto no OpenClaw:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Se o seu agente carrega as skills apenas na inicialização, inicie uma nova sessão após a instalação.

Login

Na primeira vez que você solicitar um modelo, o agente executa o login por dispositivo da Meshy CLI e envia a você um link e um código de uso único:

  1. Abra o link em qualquer dispositivo e faça login na Meshy.
  2. Digite o código exatamente como exibido e clique em Connect.
  3. O agente continua a solicitação que você fez.

Página de conexão da Meshy CLI

O código expira após 10 minutos; peça ao agente um novo código caso isso ocorra. Como o fluxo por dispositivo funciona a partir de qualquer navegador, isso também funciona quando o OpenClaw é executado em um servidor ou em um container. MESHY_API_KEY é opcional: se estiver definida, ela tem prioridade sobre a sessão do navegador.

Exemplos de Prompts

  • Crie um modelo 3D de um filhote de husky e salve-o como GLB em ./assets.
  • Transforme esta foto em um modelo 3D texturizado e mantenha suas proporções. (anexe a imagem)
  • Faça o rigging deste personagem humanoide, adicione uma animação de corrida e exporte como FBX.
  • Ajude-me a imprimir em 3D um pequeno boneco de dragão, de 80 mm de altura, e abra-o no Bambu Studio.
  • Transforme este logotipo em um chaveiro que eu possa imprimir em 3D.

As solicitações de acompanhamento reutilizam o resultado anterior: crie um LOD de 1.500 faces, agora como FBX, redimensione para 150 mm. Adicione pergunte-me antes de gastar créditos para aprovar cada etapa paga.

Segurança e Dados

  • O que é executado: apenas a Meshy CLI, como meshy ou o pacote fixado via npm exec. A skill é apenas em Markdown, sem Python, curl ou scripts incluídos.
  • Credenciais: a CLI armazena e atualiza a sessão em ~/.config/meshy/credentials.json com o modo 0600. A skill nunca lê, exibe ou copia um token, código de dispositivo ou chave, e nunca solicita isso no chat.
  • Rede: prompts, imagens e solicitações de tarefas vão para a API da Meshy (normalmente api.meshy.ai). O npm é contatado quando a CLI é instalada ou executada temporariamente.
  • Arquivos: cada tarefa grava dentro de uma pasta: a que você nomeou, ou ./meshy_output. Caminhos fora dela são recusados, e arquivos existentes não são sobrescritos a menos que você peça.

O manifesto completo de segurança está no código-fonte da skill.

Solução de problemas

SintomaSolução
A skill não é elegívelInstale o Node.js 22.12 ou mais recente com npm, ou instale a CLI com npm install -g meshy-cli, depois inicie uma nova sessão.
O agente solicita uma chave de APIRecuse e peça para ele fazer login pelo navegador. Nunca cole uma chave de API em um chat.
O código de login expirouPeça ao agente para iniciar o login novamente. Os códigos são válidos por 10 minutos.
A geração é recusada por plano ou créditosA geração exige um plano pago e créditos suficientes. Verifique seu plano e saldo em meshy.ai.
Login feito na conta errada da MeshyPeça ao agente para executar meshy auth logout e fazer login novamente.

Perguntas frequentes

O que é a skill da Meshy para o OpenClaw?
Meshy 3D Agent é a skill oficial da Meshy no ClawHub. Ela permite que um agente do OpenClaw gere modelos 3D, texturas, rigging e animação, e prepare modelos para impressão 3D, operando por meio da Meshy CLI.
Como instalo a skill da Meshy no OpenClaw?
Execute openclaw skills install @arlieeee/meshy-3d-agent. Você também precisa do Node.js 22.12 ou mais recente com npm; o OpenClaw oferece a instalação da Meshy CLI via npm.
Preciso de uma chave de API da Meshy?
Não. A skill faz login pelo seu navegador com um código de uso único, e a Meshy CLI armazena a sessão. MESHY_API_KEY é opcional; se estiver definida, ela tem prioridade.
A skill funciona quando o OpenClaw é executado em um servidor?
Sim. O login por dispositivo exibe um link e um código que você pode aprovar em qualquer navegador, então o OpenClaw pode ser executado em uma máquina remota ou em um container.
A skill da Meshy é gratuita?
A skill é gratuita para instalar. Gerar modelos 3D exige um plano pago da Meshy e consome créditos da Meshy de acordo com as taxas da API. A análise de imprimibilidade é gratuita.
Eu usava a skill antiga do Meshy OpenClaw baseada em Python. Minhas tarefas ainda funcionam?
Sim. A skill migrou para a Meshy CLI na versão 0.6.0, e os IDs de tarefas da skill antiga continuam utilizáveis pela CLI.

Links Relacionados