Skill Meshy per OpenClaw

Aggiungi la skill Meshy a OpenClaw in modo che il tuo agente possa generare modelli 3D, texture e animazioni, e preparare stampe 3D, direttamente da una chat.

Panoramica

La skill Meshy è disponibile su ClawHub come Meshy 3D Agent. Questa unica skill copre entrambi i flussi di lavoro:

  • Generazione 3D: Testo in 3D, Immagine in 3D e Multi-immagine in 3D, texturing e ritexturing con AI, remesh fino 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 a colore singolo e multicolore, dimensionamento secondo misure reali, prodotti Creative Lab come statuette, lampade, portachiavi e calamite da frigorifero, e passaggio a uno slicer installato come Bambu Studio, OrcaSlicer o Creality Print.

La skill esegue la Meshy CLI, che è il pacchetto meshy-cli su npm. L'accesso avviene una sola volta nel browser e non è necessaria alcuna chiave API.

Prima di iniziare

  • Serve OpenClaw.

  • Serve Node.js 22.12 o versione successiva, con npm, sul computer che esegue OpenClaw. OpenClaw rende disponibile la skill quando meshy o npm sono nel PATH.

  • Per generare modelli, è necessario un piano Meshy a pagamento. Ogni attività di generazione consuma crediti Meshy alle tariffe dell'API. Per il costo di ciascuna attività, consulta Prezzi. L'analisi della 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.

Installa la skill

Per installare la skill da ClawHub, esegui il seguente comando:

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

Se la Meshy CLI non è installata, la pagina Skills di OpenClaw può offrire di installarla da npm. Non è necessaria un'installazione globale. Senza di essa, la skill esegue la CLI tramite npm exec, e un'installazione globale rende solo l'avvio più veloce.

Per lasciare che sia OpenClaw a occuparsi dell'intera configurazione, incolla il seguente testo in una chat:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Una sessione già aperta rileva la skill al turno successivo. Se hai installato Node.js o la Meshy CLI mentre una sessione era aperta, avvia una nuova sessione affinché OpenClaw li trovi.

Accedi

La prima volta che richiedi un modello, OpenClaw avvia l'accesso tramite la Meshy CLI e ti invia un link e un codice monouso.

Per accedere, segui questi passaggi:

  1. Apri il link su qualsiasi dispositivo.

  2. Se la pagina richiede un codice, inserisci il codice in Device code esattamente come mostrato da OpenClaw, quindi fai clic su Continue.

  3. Se Meshy ti chiede di accedere, accedi al tuo account Meshy.

  4. Nella pagina Connect Meshy CLI, fai clic su Connect. La pagina mostrerà Meshy CLI authorized.

    Pagina Connect Meshy CLI con l'account connesso, l'accesso che ottiene la CLI e i pulsanti Cancel e Connect

  5. Torna alla chat. OpenClaw proseguirà con la richiesta che hai fatto.

Il codice scade dopo 10 minuti. Se scade, chiedi a OpenClaw di generarne uno nuovo. Puoi approvare l'accesso da qualsiasi browser, quindi funziona anche quando OpenClaw viene eseguito su un server o in un container.

Non è necessaria MESHY_API_KEY. Se è impostata, la CLI usa quella chiave API al posto della sessione del browser.

Esempi di prompt

Descrivi il lavoro con parole tue. Ad esempio:

  • Crea un modello 3D di un cucciolo di husky e salvalo come GLB in ./assets.
  • Trasforma questa foto in un modello 3D texturizzato e mantieni le sue proporzioni. (allega l'immagine)
  • Fai il rig di 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, ad esempio crea un LOD da 1.500 facce, ora come FBX, oppure scalalo a 150 mm. Per approvare personalmente ogni passaggio a pagamento, aggiungi chiedimi conferma prima di spendere crediti alla tua richiesta.

Sicurezza e dati

Il seguente elenco riassume come la skill gestisce comandi, credenziali, accesso alla rete e file:

  • Cosa esegue: Solo la Meshy CLI, come meshy oppure come pacchetto fissato tramite npm exec. La skill è composta solo da Markdown, senza Python, curl o script inclusi.
  • Credenziali: La CLI memorizza e aggiorna la sessione in ~/.config/meshy/credentials.json con mode 0600. La skill non legge, non stampa e non copia mai un token, un device code o una chiave, e non ne richiede mai uno in chat.
  • Rete: La CLI invia prompt, immagini e richieste di attività all'API Meshy, normalmente api.meshy.ai. npm contatta il proprio registro quando installa la CLI o la esegue come pacchetto temporaneo.
  • File: Ogni lavoro scrive solo all'interno di una cartella, quella da te indicata oppure ./meshy_output. La CLI rifiuta percorsi al di fuori di quella cartella e non sovrascrive i file esistenti a meno che tu non lo richieda.

Per il manifesto di sicurezza completo, consulta meshy-openclaw su GitHub.

Risoluzione dei problemi

La seguente tabella elenca i problemi comuni, le loro cause e come risolverli.

ProblemaCausaSoluzione
La skill non è disponibile in OpenClawNé meshy né npm sono nel PATH.Installa Node.js 22.12 o versione successiva con npm, quindi avvia una nuova sessione.
OpenClaw richiede una chiave APILa skill non ne ha bisogno. L'accesso avviene tramite il browser.Rifiuta e chiedi a OpenClaw di accedere tramite il browser. Non incollare mai una chiave API in una chat.
Il codice di accesso è scadutoUn codice è valido per 10 minuti.Chiedi a OpenClaw di avviare nuovamente l'accesso.
OpenClaw non può generare a causa del piano o dei creditiLa generazione richiede un piano a pagamento e crediti sufficienti.Controlla il tuo piano e il saldo nella pagina Subscription nell'app web di Meshy.
Hai effettuato l'accesso con l'account Meshy sbagliatoLa Meshy CLI riutilizza la sessione memorizzata sul tuo computer.Chiedi a OpenClaw di eseguire meshy auth logout, quindi accedi di nuovo.

FAQ

Cos'è la skill Meshy per OpenClaw?
Meshy 3D Agent è la skill Meshy su ClawHub. Permette a un agente OpenClaw di generare modelli 3D, texture, rigging e animazioni, e di preparare modelli per la stampa 3D, eseguendo la Meshy CLI.
Come installo la skill Meshy in OpenClaw?
Esegui openclaw skills install @arlieeee/meshy-3d-agent. Serve anche Node.js 22.12 o versione successiva con npm. La pagina Skills di OpenClaw può offrire di installare la Meshy CLI da npm.
Ho bisogno di una chiave API Meshy?
No. La skill effettua l'accesso tramite il browser con un codice monouso, e la Meshy CLI memorizza la sessione. Non è necessaria MESHY_API_KEY, ma se è impostata, la Meshy CLI la utilizza al suo posto.
La skill funziona quando OpenClaw viene eseguito su un server?
Sì. L'accesso mostra un link e un codice che puoi approvare da qualsiasi browser, quindi OpenClaw può essere eseguito su un computer remoto o in un container.
La skill Meshy è gratuita?
L'installazione della skill è gratuita. Generare modelli 3D richiede un piano Meshy a pagamento e consuma crediti Meshy alle tariffe dell'API. L'analisi della stampabilità è gratuita.
Ho usato la precedente skill Meshy OpenClaw basata su Python. Le mie attività funzionano ancora?
Sì. La skill è passata alla Meshy CLI nella versione 0.6.0, e puoi comunque usare gli ID delle attività della vecchia skill con la CLI.

Prossimi passi