Skill Meshy pour OpenClaw

Ajoutez le skill Meshy à OpenClaw pour que votre agent puisse générer des modèles 3D, des textures et des animations, et préparer des impressions 3D, directement depuis une conversation.

Vue d'ensemble

Le skill Meshy est disponible sur ClawHub sous le nom Meshy 3D Agent. Ce skill unique couvre deux flux de travail :

  • Génération 3D : Texte en 3D, Image en 3D et Multi-image en 3D, texturation et retexturation par IA, remesh selon un budget de polygones, dépliage UV, rigging automatique et animation pour les personnages humanoïdes, et export vers GLB, FBX, OBJ, STL ou USDZ.
  • Impression 3D : analyse et réparation de l'imprimabilité, 3MF monochrome et multicolore, mise à l'échelle selon des dimensions réelles, produits Creative Lab tels que figurines, lampes, porte-clés et magnets de réfrigérateur, et transfert vers un trancheur installé tel que Bambu Studio, OrcaSlicer ou Creality Print.

Le skill exécute le CLI Meshy, qui correspond au paquet meshy-cli sur npm. Vous vous connectez une seule fois dans votre navigateur, sans avoir besoin de clé API.

Avant de commencer

  • Vous devez disposer d'OpenClaw.

  • Vous avez besoin de Node.js 22.12 ou version ultérieure, avec npm, sur l'ordinateur qui exécute OpenClaw. OpenClaw rend le skill disponible lorsque meshy ou npm se trouve dans le PATH.

  • Pour générer des modèles, vous avez besoin d'un plan Meshy payant. Chaque tâche de génération consomme des crédits Meshy aux tarifs de l'API. Pour connaître le coût de chaque tâche, consultez la Tarification. L'analyse de l'imprimabilité est gratuite, et les étapes d'impression locales, comme le redimensionnement d'un modèle ou son ouverture dans un trancheur, ne nécessitent pas de connexion.

Installer le skill

Pour installer le skill depuis ClawHub, exécutez la commande suivante :

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

Si le CLI Meshy n'est pas installé, la page Skills d'OpenClaw peut proposer de l'installer depuis npm. Une installation globale n'est pas nécessaire. Sans elle, le skill exécute le CLI via npm exec, et une installation globale ne fait qu'accélérer le démarrage.

Pour laisser OpenClaw effectuer toute l'installation à votre place, collez le texte suivant dans une conversation :

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

Une session déjà ouverte prend en compte le skill dès son prochain tour. Si vous avez installé Node.js ou le CLI Meshy pendant qu'une session était ouverte, démarrez une nouvelle session afin qu'OpenClaw les détecte.

Connexion

La première fois que vous demandez un modèle, OpenClaw lance la connexion du CLI Meshy et vous envoie un lien ainsi qu'un code à usage unique.

Pour vous connecter, suivez ces étapes :

  1. Ouvrez le lien sur n'importe quel appareil.

  2. Si la page demande un code, saisissez-le dans Device code exactement comme OpenClaw l'affiche, puis cliquez sur Continue.

  3. Si Meshy vous demande de vous connecter, connectez-vous à votre compte Meshy.

  4. Sur la page Connect Meshy CLI, cliquez sur Connect. La page affiche Meshy CLI authorized.

    Page Connect Meshy CLI avec le compte connecté, les accès obtenus par le CLI, et les boutons Cancel et Connect

  5. Retournez à la conversation. OpenClaw poursuit la demande que vous avez formulée.

Le code expire au bout de 10 minutes. S'il a expiré, demandez-en un nouveau à OpenClaw. Vous pouvez approuver la connexion depuis n'importe quel navigateur, ce qui fonctionne également lorsque OpenClaw s'exécute sur un serveur ou dans un conteneur.

Vous n'avez pas besoin de MESHY_API_KEY. Si elle est définie, le CLI utilise cette clé API à la place.

Exemples de prompts

Décrivez la tâche avec vos propres mots. Par exemple :

  • Make a 3D model of a baby husky and save it as GLB in ./assets.
  • Turn this photo into a textured 3D model and keep its proportions. (joignez l'image)
  • Rig this humanoid character, add a running animation, and export it as FBX.
  • Help me 3D print a small dragon figurine, 80 mm tall, and open it in Bambu Studio.
  • Turn this logo into a keychain I can 3D print.

Les demandes de suivi réutilisent le résultat précédent, par exemple make a 1,500-face LOD, now as FBX, ou scale it to 150 mm. Pour approuver vous-même chaque étape payante, ajoutez ask me before spending credits à votre demande.

Sécurité et données

La liste suivante résume la manière dont le skill gère les commandes, les identifiants, l'accès réseau et les fichiers :

  • Ce qu'il exécute : uniquement le CLI Meshy, soit en tant que meshy, soit en tant que paquet épinglé via npm exec. Le skill est uniquement du Markdown, sans Python, curl, ni script intégré.
  • Identifiants : le CLI stocke et actualise la session dans ~/.config/meshy/credentials.json avec le mode 0600. Le skill ne lit, n'affiche ni ne copie jamais de jeton, de code d'appareil ou de clé, et n'en demande jamais dans la conversation.
  • Réseau : le CLI envoie les prompts, les images et les requêtes de tâches à l'API Meshy, normalement api.meshy.ai. npm contacte son registre lors de l'installation du CLI ou de son exécution en tant que paquet temporaire.
  • Fichiers : chaque tâche écrit uniquement dans un dossier, celui que vous avez nommé ou ./meshy_output. Le CLI refuse les chemins en dehors de ce dossier, et n'écrase pas les fichiers existants sauf si vous le demandez.

Pour le manifeste de sécurité complet, consultez meshy-openclaw sur GitHub.

Dépannage

Le tableau suivant répertorie les problèmes courants, leurs causes et leurs solutions.

ProblèmeCauseSolution
Le skill n'est pas disponible dans OpenClawNi meshy ni npm ne se trouvent dans le PATH.Installez Node.js 22.12 ou version ultérieure avec npm, puis démarrez une nouvelle session.
OpenClaw demande une clé APILe skill n'en a pas besoin. Il se connecte via votre navigateur.Refusez, et demandez à OpenClaw de se connecter via le navigateur à la place. Ne collez jamais de clé API dans une conversation.
Le code de connexion a expiréUn code est valable 10 minutes.Demandez à OpenClaw de relancer la connexion.
OpenClaw ne peut pas générer en raison de votre plan ou de vos créditsLa génération nécessite un plan payant et suffisamment de crédits.Vérifiez votre plan et votre solde sur la page Subscription de l'application web Meshy.
Vous êtes connecté au mauvais compte MeshyLe CLI Meshy réutilise la session stockée sur votre ordinateur.Demandez à OpenClaw d'exécuter meshy auth logout, puis reconnectez-vous.

FAQ

Qu'est-ce que le skill Meshy pour OpenClaw ?
Meshy 3D Agent est le skill Meshy disponible sur ClawHub. Il permet à un agent OpenClaw de générer des modèles 3D, des textures, du rigging et des animations, et de préparer des modèles pour l'impression 3D, en exécutant le CLI Meshy.
Comment installer le skill Meshy dans OpenClaw ?
Exécutez openclaw skills install @arlieeee/meshy-3d-agent. Vous avez également besoin de Node.js 22.12 ou version ultérieure avec npm. La page Skills d'OpenClaw peut proposer d'installer le CLI Meshy depuis npm.
Ai-je besoin d'une clé API Meshy ?
Non. Le skill se connecte via votre navigateur grâce à un code à usage unique, et le CLI Meshy stocke la session. Vous n'avez pas besoin de MESHY_API_KEY, mais si elle est définie, le CLI Meshy l'utilise à la place.
Le skill fonctionne-t-il lorsque OpenClaw s'exécute sur un serveur ?
Oui. La connexion affiche un lien et un code que vous pouvez approuver depuis n'importe quel navigateur, ce qui permet à OpenClaw de s'exécuter sur un ordinateur distant ou dans un conteneur.
Le skill Meshy est-il gratuit ?
Le skill est gratuit à installer. La génération de modèles 3D nécessite un plan Meshy payant et consomme des crédits Meshy aux tarifs de l'API. L'analyse de l'imprimabilité est gratuite.
J'utilisais l'ancien skill Meshy OpenClaw basé sur Python. Mes tâches fonctionnent-elles toujours ?
Oui. Le skill est passé au CLI Meshy à partir de la version 0.6.0, et vous pouvez toujours utiliser les identifiants de tâches de l'ancien skill avec le CLI.

Étapes suivantes