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 meshy ou npm estão no PATH.

  • 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:

  1. Abra a ligação em qualquer dispositivo.

  2. 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.

  3. Se o Meshy pedir que inicie sessão, inicie sessão na sua conta Meshy.

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

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

  5. 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 meshy ou como o pacote fixado através do npm exec. A skill é apenas Markdown, sem Python, curl ou scripts incluídos.
  • Credenciais: O CLI armazena e renova a sessão em ~/.config/meshy/credentials.json com o mode 0600. 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.

ProblemaCausaSoluçã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 npm e, em seguida, inicie uma nova sessão.
O OpenClaw pede uma chave de APIA 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 expirouUm 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éditosA 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 erradaO 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.