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
meshyounpmestá noPATH. -
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:
-
Abra o link em qualquer dispositivo.
-
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.
-
Se a Meshy pedir que você faça login, entre na sua conta Meshy.
-
Na página Connect Meshy CLI, clique em Connect. A página mostra Meshy CLI authorized.

-
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
meshyou como o pacote fixado por meio denpm exec. A skill é somente Markdown, sem Python,curlou scripts incluídos. - Credenciais: A CLI armazena e atualiza a sessão em
~/.config/meshy/credentials.jsoncom permissão0600. 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.
| Problema | Causa | Correção |
|---|---|---|
| A skill não está disponível no OpenClaw | Nem 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 API | A 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 expirou | Um 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éditos | A 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 errada | A 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.
Próximos passos
-
Para usar os mesmos fluxos de trabalho no Codex, consulte Plugin Meshy para o Codex.
-
Para usar os mesmos fluxos de trabalho no Hermes Agent, consulte Skills Meshy para o Hermes Agent.
-
Para chamar a Meshy API a partir de um agente de IA com sua própria chave de API, consulte Integração de IA.