Skill Meshy per OpenClaw

La skill Meshy ufficiale per OpenClaw permette al tuo agente di generare modelli 3D, texture e animazioni e di preparare stampe 3D, tutto da una chat.


Panoramica

Meshy è ora disponibile su ClawHub come Meshy 3D Agent, una singola skill che copre:

  • Generazione 3D: testo in 3D, immagine in 3D e multi-vista in 3D, texturing e ritexturing con IA, remesh a un budget di poligoni, UV unwrapping, rigging automatico e animazione per personaggi umanoidi, ed esportazione in GLB, FBX, OBJ, STL o USDZ.
  • Stampa 3D: analisi e riparazione della stampabilità, 3MF monocolore e multicolore, dimensionamento in base a misure reali, prodotti Creative Lab (statuette, lampade, portachiavi, calamite da frigo) e passaggio a uno slicer installato come Bambu Studio, OrcaSlicer o Creality Print.

La skill utilizza il Meshy CLI. Effettui l'accesso una sola volta nel browser; non è necessaria alcuna chiave API.


Requisiti

  • OpenClaw.
  • Node.js 22.12 o versione successiva, con npm, sulla macchina su cui gira OpenClaw. La skill diventa idonea quando meshy o npm è presente nel PATH.
  • Un piano Meshy a pagamento per la generazione. Ogni attività di generazione consuma crediti Meshy secondo le tariffe API. L'analisi di stampabilità è gratuita, e i passaggi di stampa locali, come il ridimensionamento di un modello o la sua apertura in uno slicer, non richiedono l'accesso.

Installazione

Installa la skill da ClawHub:

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

OpenClaw propone di installare il Meshy CLI da npm se non è ancora installato. Un'installazione globale rende solo l'avvio più veloce; senza di essa, la skill esegue il CLI tramite npm exec.

Puoi anche lasciare che sia l'agente a occuparsi dell'intera configurazione. Incolla questo testo in 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 il tuo agente carica le skill solo all'avvio, avvia una nuova sessione dopo l'installazione.


Accesso

La prima volta che richiedi un modello, l'agente esegue l'accesso tramite dispositivo del Meshy CLI e ti invia un link e un codice monouso:

  1. Apri il link su qualsiasi dispositivo ed effettua l'accesso a Meshy.
  2. Inserisci il codice esattamente come mostrato, poi clicca su Connect.
  3. L'agente prosegue con la richiesta che hai fatto.

Pagina di connessione del Meshy CLI

Il codice scade dopo 10 minuti; chiedine uno nuovo all'agente se succede. Poiché il flusso tramite dispositivo funziona da qualsiasi browser, questo funziona anche quando OpenClaw gira su un server o in un container. MESHY_API_KEY è opzionale: se impostata, ha la priorità rispetto alla sessione del browser.


Esempi di Prompt

  • Crea un modello 3D di un cucciolo di husky e salvalo come GLB in ./assets.
  • Trasforma questa foto in un modello 3D con texture e mantieni le sue proporzioni. (allega l'immagine)
  • Applica il rigging a questo personaggio umanoide, aggiungi un'animazione di corsa, ed esportalo come FBX.
  • Aiutami a stampare in 3D una piccola statuetta di drago, alta 80 mm, e aprila in Bambu Studio.
  • Trasforma questo logo in un portachiavi che posso stampare in 3D.

Le richieste successive riutilizzano il risultato precedente: crea un LOD da 1.500 facce, ora come FBX, scalalo a 150 mm. Aggiungi chiedimi conferma prima di spendere crediti per approvare ogni passaggio a pagamento.


Sicurezza e Dati

  • Cosa esegue: solo il Meshy CLI, come meshy o il pacchetto fissato tramite npm exec. La skill è solo Markdown, senza Python, curl o script inclusi.
  • Credenziali: il CLI memorizza e aggiorna la sessione in ~/.config/meshy/credentials.json con modalità 0600. La skill non legge, stampa o copia mai un token, un codice dispositivo o una chiave, e non ne richiede mai uno in chat.
  • Rete: prompt, immagini e richieste di attività vengono inviati all'API Meshy (normalmente api.meshy.ai). npm viene contattato quando il CLI viene installato o eseguito temporaneamente.
  • File: ogni lavoro scrive all'interno di un'unica cartella: quella che hai specificato, oppure ./meshy_output. I percorsi esterni vengono rifiutati, e i file esistenti non vengono sovrascritti a meno che tu non lo richieda.

Il manifesto di sicurezza completo si trova nel codice sorgente della skill.


Risoluzione dei problemi

SintomoSoluzione
La skill non è idoneaInstalla Node.js 22.12 o versione successiva con npm, oppure installa il CLI con npm install -g meshy-cli, poi avvia una nuova sessione.
L'agente chiede una chiave APIRifiuta e chiedigli di accedere invece tramite il browser. Non incollare mai una chiave API in una chat.
Il codice di accesso è scadutoChiedi all'agente di avviare nuovamente l'accesso. I codici sono validi per 10 minuti.
La generazione viene rifiutata per il piano o i creditiLa generazione richiede un piano a pagamento e crediti sufficienti. Controlla il tuo piano e il saldo su meshy.ai.
Accesso effettuato con l'account Meshy sbagliatoChiedi all'agente di eseguire meshy auth logout, poi accedi di nuovo.

FAQ

Cos'è la skill Meshy per OpenClaw?
Meshy 3D Agent è la skill Meshy ufficiale su ClawHub. Permette a un agente OpenClaw di generare modelli 3D, texture, rigging e animazioni, e di preparare modelli per la stampa 3D, pilotando il Meshy CLI.
Come installo la skill Meshy in OpenClaw?
Esegui openclaw skills install @arlieeee/meshy-3d-agent. Hai anche bisogno di Node.js 22.12 o versione successiva con npm; OpenClaw propone di installare il Meshy CLI da npm.
Ho bisogno di una chiave API Meshy?
No. La skill effettua l'accesso tramite il tuo browser con un codice monouso, e il Meshy CLI memorizza la sessione. MESHY_API_KEY è opzionale; se impostata, ha la priorità.
La skill funziona quando OpenClaw gira su un server?
Sì. L'accesso tramite dispositivo mostra un link e un codice che puoi approvare da qualsiasi browser, quindi OpenClaw può girare su una macchina remota o in un container.
La skill Meshy è gratuita?
La skill è gratuita da installare. Generare modelli 3D richiede un piano Meshy a pagamento e consuma crediti Meshy secondo le tariffe API. L'analisi di stampabilità è gratuita.
Ho usato la vecchia skill Meshy OpenClaw basata su Python. Le mie attività funzionano ancora?
Sì. La skill è passata al Meshy CLI nella versione 0.6.0, e gli ID delle attività della vecchia skill restano utilizzabili dal CLI.