Skill Meshy para OpenClaw
Adicione a skill Meshy ao OpenClaw para que o 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á disponível no ClawHub como Meshy 3D Agent. Esta única skill abrange ambos os 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 UV, auto-rigging e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
- Impressão 3D: análise e reparação de imprimibilidade, 3MF monocromático e multicolor, dimensionamento para medidas reais, produtos Creative Lab como figuras, candeeiros, porta-chaves e ímanes de frigorífico, e transferência para um software de corte instalado, como o Bambu Studio, o OrcaSlicer ou o Creality Print.
A skill executa o CLI do Meshy, que é o pacote meshy-cli no npm. Inicia sessão uma vez no seu navegador e não precisa de uma chave de API.
Antes de começar
-
Precisa do OpenClaw.
-
Precisa do Node.js 22.12 ou posterior, com npm, no computador que executa o OpenClaw. O OpenClaw disponibiliza a skill quando
meshyounpmestão noPATH. -
Para gerar modelos, precisa de um plano Meshy pago. Cada tarefa de geração gasta créditos Meshy a taxas de API. Para o custo de cada tarefa, consulte Preços. A análise de imprimibilidade é gratuita, e os passos locais de impressão, como redimensionar um modelo ou abri-lo num software de corte, não requerem início de sessão.
Instalar a skill
Para instalar a skill a partir do ClawHub, execute o seguinte comando:
openclaw skills install @arlieeee/meshy-3d-agent
Se o CLI do Meshy não estiver instalado, a página Skills do OpenClaw pode propor instalá-lo a partir do npm. Não precisa de uma instalação global. Sem ela, a skill executa o CLI através do npm exec, e uma instalação global apenas torna o arranque mais rápido.
Para deixar o OpenClaw fazer toda a configuração, cole o seguinte texto num 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 recebe a skill na sua próxima interação. Se instalou o Node.js ou o CLI do Meshy enquanto uma sessão estava aberta, inicie uma nova sessão para que o OpenClaw os encontre.
Iniciar sessão
Da primeira vez que pedir um modelo, o OpenClaw inicia o processo de início de sessão do CLI do Meshy e envia-lhe uma ligação e um código de utilização única.
Para iniciar sessão, siga estes passos:
-
Abra a ligação em qualquer dispositivo.
-
Se a página pedir um código, introduza o código em Device code exatamente como o OpenClaw o apresenta e, em seguida, clique em Continue.
-
Se o Meshy pedir que inicie sessão, inicie sessão na sua conta Meshy.
-
Na página Connect Meshy CLI, clique em Connect. A página apresenta Meshy CLI authorized.

-
Regresse ao chat. O OpenClaw continua o pedido que fez.
O código expira após 10 minutos. Se expirar, peça ao OpenClaw um novo. Pode aprovar o início de sessão a partir de qualquer navegador, pelo que também funciona quando o OpenClaw é executado num servidor ou num contentor.
Não precisa de MESHY_API_KEY. Se estiver definida, o CLI utiliza essa chave de API em vez da sessão do navegador.
Exemplos de prompts
Descreva o trabalho por suas próprias palavras. Por exemplo:
- Cria um modelo 3D de um cachorro de husky e guarda-o como GLB em ./assets.
- Transforma esta foto num modelo 3D texturizado e mantém as suas proporções. (anexe a imagem)
- Faz o rigging desta personagem humanoide, adiciona uma animação de corrida e exporta-a como FBX.
- Ajuda-me a imprimir em 3D uma pequena figura de dragão, com 80 mm de altura, e abre-a no Bambu Studio.
- Transforma este logótipo num porta-chaves que eu possa imprimir em 3D.
Os pedidos subsequentes reutilizam o resultado anterior, por exemplo faz um LOD de 1500 faces, agora como FBX, ou escala-o para 150 mm. Para aprovar cada passo pago você mesmo, adicione pergunta-me antes de gastar créditos ao seu pedido.
Segurança e dados
A lista seguinte resume como a skill trata comandos, credenciais, acesso à rede e ficheiros:
- O que executa: Apenas o CLI do Meshy, como
meshyou como o pacote fixado através donpm exec. A skill é apenas Markdown, sem Python,curlou scripts incluídos. - Credenciais: O CLI armazena e renova a sessão em
~/.config/meshy/credentials.jsoncom o mode0600. A skill nunca lê, apresenta ou copia um token, código de dispositivo ou chave, e nunca pede um destes no chat. - Rede: O CLI envia prompts, imagens e pedidos de tarefas para a API do Meshy, normalmente
api.meshy.ai. O npm contacta o seu registo quando instala o CLI ou o executa como pacote temporário. - Ficheiros: Cada tarefa escreve apenas dentro de uma pasta, a que nomeou ou
./meshy_output. O CLI recusa caminhos fora dessa pasta e não substitui ficheiros existentes a menos que o peça.
Para o manifesto de segurança completo, consulte meshy-openclaw no GitHub.
Resolução de problemas
A tabela seguinte apresenta problemas comuns, as suas causas e como resolvê-los.
| Problema | Causa | Soluçã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 npm e, em seguida, inicie uma nova sessão. |
| O OpenClaw pede uma chave de API | A skill não precisa de uma. Inicia sessão através do seu navegador. | Recuse e peça ao OpenClaw para iniciar sessão através do navegador. Nunca cole uma chave de API num chat. |
| O código de início de sessão expirou | Um código é válido durante 10 minutos. | Peça ao OpenClaw para iniciar o processo de início de sessão novamente. |
| O OpenClaw não consegue gerar devido ao seu plano ou créditos | A geração requer um plano pago e créditos suficientes. | Verifique o seu plano e saldo na página Subscription na aplicação web do Meshy. |
| Tem sessão iniciada na conta Meshy errada | O CLI do Meshy reutiliza a sessão que armazenou no seu computador. | Peça ao OpenClaw para executar meshy auth logout e, em seguida, inicie sessão novamente. |
Perguntas frequentes
- O que é a skill Meshy para OpenClaw?
- Meshy 3D Agent é a skill Meshy no ClawHub. Permite que um agente OpenClaw gere modelos 3D, texturas, rigging e animação, e prepare modelos para impressão 3D, executando o CLI do Meshy.
- Como instalo a skill Meshy no OpenClaw?
- Execute openclaw skills install @arlieeee/meshy-3d-agent. Também precisa do Node.js 22.12 ou posterior com npm. A página Skills do OpenClaw pode propor instalar o CLI do Meshy a partir do npm.
- Preciso de uma chave de API do Meshy?
- Não. A skill inicia sessão através do seu navegador com um código de utilização única, e o CLI do Meshy armazena a sessão. Não precisa de MESHY_API_KEY, mas se estiver definida, o CLI do Meshy utiliza-a em vez disso.
- A skill funciona quando o OpenClaw é executado num servidor?
- Sim. O início de sessão apresenta uma ligação e um código que pode aprovar a partir de qualquer navegador, pelo que o OpenClaw pode ser executado num computador remoto ou num contentor.
- A skill Meshy é gratuita?
- A skill é gratuita para instalar. Gerar modelos 3D requer um plano Meshy pago e gasta créditos Meshy a taxas de API. A análise de imprimibilidade é gratuita.
- Utilizei a antiga skill Meshy OpenClaw baseada em Python. As minhas tarefas ainda funcionam?
- Sim. A skill passou a utilizar o CLI do Meshy na versão 0.6.0, e ainda pode utilizar IDs de tarefas da skill antiga com o CLI.
Próximos passos
-
Para utilizar os mesmos fluxos de trabalho no Codex, consulte Plugin Meshy para Codex.
-
Para utilizar os mesmos fluxos de trabalho no Hermes Agent, consulte Skills Meshy para Hermes Agent.
-
Para chamar a API do Meshy a partir de um agente de IA com a sua própria chave de API, consulte Integração de IA.