Skill Meshy para OpenClaw

A skill oficial da Meshy para OpenClaw permite que o seu agente gere modelos 3D, texturas e animações e prepare impressões 3D, tudo a partir de uma conversa.

Visão geral

A Meshy está agora 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 por IA, remesh para um orçamento de polígonos, desdobramento 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 reparação de imprimibilidade, 3MF monocromático e multicolor, dimensionamento para medidas reais, produtos do Creative Lab (figuras, candeeiros, porta-chaves, ímanes de frigorífico) e transferência para um software de corte instalado, como o Bambu Studio, OrcaSlicer ou Creality Print.

A skill utiliza o Meshy CLI. Inicia sessão uma vez no seu navegador; não é necessária nenhuma chave de API.

Requisitos

  • OpenClaw.
  • Node.js 22.12 ou mais recente, com npm, na máquina onde o OpenClaw é executado. A skill torna-se elegível quando meshy ou npm está no PATH.
  • Um plano Meshy pago para geração. Cada tarefa de geração gasta créditos Meshy às tarifas da API. 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 necessitam de sessão iniciada.

Instalação

Instale a skill a partir do ClawHub:

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

O OpenClaw propõe instalar o Meshy CLI a partir do npm caso ainda não esteja instalado. Uma instalação global apenas torna o arranque mais rápido; sem ela, a skill executa o CLI através de npm exec.

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 só carrega skills no arranque, inicie uma nova sessão após a instalação.

Iniciar sessão

Na primeira vez que pedir um modelo, o agente executa o início de sessão por dispositivo do Meshy CLI e envia-lhe um link e um código de utilização única:

  1. Abra o link em qualquer dispositivo e inicie sessão na Meshy.
  2. Introduza o código exatamente como apresentado e clique em Connect.
  3. O agente continua o pedido que fez.

Página de ligação do Meshy CLI

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

Exemplos de Prompts

  • Cria um modelo 3D de um husky bebé 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 rig deste personagem humanoide, adiciona uma animação de corrida e exporta-o 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 possa imprimir em 3D.

Os pedidos de seguimento reutilizam o resultado anterior: faz um LOD de 1500 faces, agora em FBX, redimensiona para 150 mm. Adicione pergunta-me antes de gastar créditos para aprovar cada passo pago.

Segurança e Dados

  • O que executa: apenas o Meshy CLI, como meshy ou o pacote fixado através de 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 modo 0600. A skill nunca lê, imprime ou copia um token, código de dispositivo ou chave, e nunca os pede numa conversa.
  • Rede: prompts, imagens e pedidos de tarefas vão para a API da Meshy (normalmente api.meshy.ai). O npm é contactado quando o CLI é instalado ou executado temporariamente.
  • Ficheiros: cada tarefa escreve dentro de uma pasta: a que nomeou, ou ./meshy_output. Caminhos fora dela são recusados, e os ficheiros existentes não são substituídos a menos que peça.

O manifesto de segurança completo está disponível na fonte da skill.

Resolução de problemas

SintomaSolução
A skill não é elegívelInstale o Node.js 22.12 ou mais recente com npm, ou instale o CLI com npm install -g meshy-cli, e depois inicie uma nova sessão.
O agente pede uma chave de APIRecuse e peça-lhe que inicie sessão através do navegador. Nunca cole uma chave de API numa conversa.
O código de início de sessão expirouPeça ao agente para reiniciar o início de sessão. Os códigos são válidos durante 10 minutos.
A geração é recusada por plano ou créditosA geração necessita de um plano pago e créditos suficientes. Verifique o seu plano e saldo em meshy.ai.
Sessão iniciada na conta Meshy erradaPeça ao agente para executar meshy auth logout e inicie sessão novamente.

FAQ

O que é a skill Meshy para OpenClaw?
Meshy 3D Agent é a skill oficial da Meshy no ClawHub. Permite que um agente OpenClaw gere modelos 3D, texturas, rigging e animação, e prepare modelos para impressão 3D, utilizando o Meshy CLI.
Como instalo a skill Meshy no OpenClaw?
Execute openclaw skills install @arlieeee/meshy-3d-agent. Também precisa do Node.js 22.12 ou mais recente com npm; o OpenClaw propõe instalar o Meshy CLI a partir do npm.
Preciso de uma chave de API da Meshy?
Não. A skill inicia sessão através do seu navegador com um código de utilização única, e o Meshy CLI armazena a sessão. A MESHY_API_KEY é opcional; se estiver definida, tem prioridade.
A skill funciona quando o OpenClaw é executado num servidor?
Sim. O início de sessão por dispositivo mostra um link e um código que pode aprovar a partir de qualquer navegador, pelo que o OpenClaw pode ser executado numa máquina remota ou num contentor.
A skill Meshy é gratuita?
A instalação da skill é gratuita. Gerar modelos 3D requer um plano Meshy pago e gasta créditos Meshy às tarifas da 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 usar o Meshy CLI na versão 0.6.0, e os IDs de tarefas da skill antiga continuam utilizáveis a partir do CLI.

Links Relacionados