Skill Meshy para o OpenClaw

Adicione a skill Meshy ao OpenClaw para que seu agente possa gerar modelos 3D, texturas e animações, e preparar impressões 3D, a partir de um chat.


Visão geral

A skill Meshy está no ClawHub como Meshy 3D Agent. Essa única skill cobre os dois fluxos de trabalho:

  • Geração 3D: Texto para 3D, Imagem para 3D e Multi-imagem para 3D, texturização e retexturização com IA, remesh para um orçamento de polígonos, desdobramento de UV (UV unwrapping), rigging e animação automáticos para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • Impressão 3D: análise e reparo de imprimibilidade, 3MF de cor única e multicolor, ajuste de tamanho para dimensões do mundo real, produtos do Creative Lab como estatuetas, luminárias, chaveiros e ímãs de geladeira, e transferência para um fatiador instalado, como Bambu Studio, OrcaSlicer ou Creality Print.

A skill executa a Meshy CLI, que é o pacote meshy-cli no npm. Você entra uma vez no navegador e não precisa de uma chave de API.


Antes de começar

  • Você precisa do OpenClaw.

  • Você precisa do Node.js 22.12 ou posterior, com o npm, no computador que executa o OpenClaw. O OpenClaw disponibiliza a skill quando meshy ou npm está no PATH.

  • Para gerar modelos, você precisa de um plano pago da Meshy. Cada tarefa de geração gasta créditos da Meshy nas taxas da API. Para o custo de cada tarefa, consulte Preços. 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.


Instalar a skill

Para instalar a skill pelo ClawHub, execute o seguinte comando:

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

Se a Meshy CLI não estiver instalada, a página de Skills do OpenClaw pode oferecer a instalação dela pelo npm. Você não precisa de uma instalação global. Sem ela, a skill executa a CLI por meio de npm exec, e uma instalação global apenas torna a inicialização mais rápida.

Para deixar o OpenClaw fazer toda a configuração, cole o seguinte texto em um chat:

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

Uma sessão aberta reconhece a skill no próximo turno. Se você instalou o Node.js ou a Meshy CLI enquanto uma sessão estava aberta, inicie uma nova sessão para que o OpenClaw os encontre.


Entrar

Na primeira vez que você solicitar um modelo, o OpenClaw inicia o login da Meshy CLI e envia a você um link e um código de uso único.

Para fazer login, siga estas etapas:

  1. Abra o link em qualquer dispositivo.

  2. Se a página pedir um código, digite o código em Device code exatamente como o OpenClaw o exibe e, em seguida, clique em Continue.

  3. Se a Meshy pedir que você faça login, entre na sua conta Meshy.

  4. Na página Connect Meshy CLI, clique em Connect. A página mostra Meshy CLI authorized.

    Página Connect Meshy CLI com a conta conectada, o acesso que a CLI obtém e os botões Cancel e Connect

  5. Volte ao chat. O OpenClaw continua a solicitação que você fez.

O código expira em 10 minutos. Se ele expirar, peça ao OpenClaw um novo código. Você pode aprovar o login em qualquer navegador, então isso também funciona quando o OpenClaw é executado em um servidor ou em um contêiner.

Você não precisa de MESHY_API_KEY. Se estiver definida, a CLI usa essa chave de API em vez da sessão do navegador.


Exemplos de prompts

Descreva a tarefa com suas próprias palavras. Por exemplo:

  • Make a 3D model of a baby husky and save it as GLB in ./assets.
  • Turn this photo into a textured 3D model and keep its proportions. (anexe a imagem)
  • Rig this humanoid character, add a running animation, and export it as FBX.
  • Help me 3D print a small dragon figurine, 80 mm tall, and open it in Bambu Studio.
  • Turn this logo into a keychain I can 3D print.

Solicitações de acompanhamento reutilizam o resultado anterior, por exemplo make a 1,500-face LOD, now as FBX ou scale it to 150 mm. Para aprovar cada etapa paga você mesmo, adicione ask me before spending credits à sua solicitação.


Segurança e dados

A lista a seguir resume como a skill lida com comandos, credenciais, acesso à rede e arquivos:

  • O que ela executa: Apenas a Meshy CLI, como meshy ou como o pacote fixado por meio de npm exec. A skill é somente Markdown, sem Python, curl ou scripts incluídos.
  • Credenciais: A CLI armazena e atualiza a sessão em ~/.config/meshy/credentials.json com permissão 0600. A skill nunca lê, exibe ou copia um token, código de dispositivo ou chave, e nunca pede um deles no chat.
  • Rede: A CLI envia prompts, imagens e solicitações de tarefas para a API da Meshy, normalmente api.meshy.ai. O npm contata seu registro ao instalar a CLI ou executá-la como um pacote temporário.
  • Arquivos: Cada tarefa grava apenas dentro de uma pasta, a que você nomeou ou ./meshy_output. A CLI recusa caminhos fora dessa pasta e não substitui arquivos existentes, a menos que você solicite.

Para o manifesto de segurança completo, consulte meshy-openclaw no GitHub.


Solução de problemas

A tabela a seguir lista problemas comuns, suas causas e como corrigi-los.

ProblemaCausaCorreção
A skill não está disponível no OpenClawNem meshy nem npm estão no PATH.Instale o Node.js 22.12 ou posterior com o npm e, em seguida, inicie uma nova sessão.
O OpenClaw pede uma chave de APIA skill não precisa de uma. Ela faz login pelo seu navegador.Recuse e peça ao OpenClaw para fazer login pelo navegador em vez disso. Nunca cole uma chave de API em um chat.
O código de login expirouUm código é válido por 10 minutos.Peça ao OpenClaw para iniciar o login novamente.
O OpenClaw não consegue gerar por causa do seu plano ou créditosA geração exige um plano pago e créditos suficientes.Verifique seu plano e saldo na página Subscription no aplicativo web da Meshy.
Você está conectado à conta Meshy erradaA Meshy CLI reutiliza a sessão que armazenou no seu computador.Peça ao OpenClaw para executar meshy auth logout e, em seguida, faça login novamente.

FAQ

O que é a skill Meshy para o OpenClaw?
O Meshy 3D Agent é a skill Meshy no ClawHub. Ele permite que um agente do OpenClaw gere modelos 3D, texturas, rigging e animação, e prepare modelos para impressão 3D, executando a Meshy CLI.
Como instalo a skill Meshy no OpenClaw?
Execute openclaw skills install @arlieeee/meshy-3d-agent. Você também precisa do Node.js 22.12 ou posterior com o npm. A página de Skills do OpenClaw pode oferecer a instalação da Meshy CLI pelo 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. Você não precisa de MESHY_API_KEY, mas, se ela estiver definida, a Meshy CLI a usa em vez disso.
A skill funciona quando o OpenClaw é executado em um servidor?
Sim. O login exibe um link e um código que você pode aprovar em qualquer navegador, então o OpenClaw pode ser executado em um computador remoto ou em um contêiner.
A skill Meshy é gratuita?
A skill é gratuita para instalar. Gerar modelos 3D exige um plano pago da Meshy e gasta créditos da Meshy nas taxas da API. A análise de imprimibilidade é gratuita.
Eu usava a skill Meshy OpenClaw mais antiga baseada em Python. Minhas tarefas ainda funcionam?
Sim. A skill migrou para a Meshy CLI na versão 0.6.0, e você ainda pode usar os IDs de tarefas da skill antiga com a CLI.