Compétence Meshy pour OpenClaw

La compétence Meshy officielle pour OpenClaw permet à votre agent de générer des modèles 3D, des textures et des animations, et de préparer des impressions 3D, le tout depuis une conversation.

Vue d'ensemble

Meshy est désormais disponible sur ClawHub sous le nom Meshy 3D Agent, une compétence qui couvre :

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

La compétence pilote le Meshy CLI. Vous vous connectez une seule fois dans votre navigateur ; aucune clé API n'est nécessaire.

Prérequis

  • OpenClaw.
  • Node.js 22.12 ou plus récent, avec npm, sur la machine où OpenClaw s'exécute. La compétence devient éligible dès que meshy ou npm est présent dans le PATH.
  • Un abonnement Meshy payant pour la génération. Chaque tâche de génération consomme des crédits Meshy selon les tarifs de l'API. L'analyse de l'imprimabilité est gratuite, et les étapes d'impression locales, comme la remise à l'échelle d'un modèle ou son ouverture dans un trancheur, ne nécessitent pas de connexion.

Installation

Installez la compétence depuis ClawHub :

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

OpenClaw propose d'installer le Meshy CLI depuis npm s'il n'est pas encore installé. Une installation globale ne fait qu'accélérer le démarrage ; sans elle, la compétence exécute le CLI via npm exec.

Vous pouvez aussi laisser l'agent effectuer toute la configuration. Collez ceci dans OpenClaw :

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

Si votre agent ne charge les compétences qu'au démarrage, démarrez une nouvelle session après l'installation.

Connexion

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

  1. Ouvrez le lien sur n'importe quel appareil et connectez-vous à Meshy.
  2. Saisissez le code exactement comme indiqué, puis cliquez sur Connect.
  3. L'agent poursuit la demande que vous avez effectuée.

Page de connexion du Meshy CLI

Le code expire au bout de 10 minutes ; demandez-en un nouveau à l'agent si c'est le cas. Comme la connexion par appareil fonctionne depuis n'importe quel navigateur, cela fonctionne aussi lorsque OpenClaw s'exécute sur un serveur ou dans un conteneur. MESHY_API_KEY est optionnel : s'il est défini, il prend la priorité sur la session du navigateur.

Exemples de prompts

  • Crée un modèle 3D d'un bébé husky et enregistre-le au format GLB dans ./assets.
  • Transforme cette photo en modèle 3D texturé en conservant ses proportions. (joindre l'image)
  • Rigge ce personnage humanoïde, ajoute une animation de course, et exporte-le en FBX.
  • Aide-moi à imprimer en 3D une petite figurine de dragon de 80 mm de haut, et ouvre-la dans Bambu Studio.
  • Transforme ce logo en porte-clés imprimable en 3D.

Les demandes de suivi réutilisent le résultat précédent : fais un LOD à 1 500 faces, maintenant en FBX, mets-le à l'échelle de 150 mm. Ajoutez demande-moi avant de dépenser des crédits pour approuver chaque étape payante.

Sécurité et données

  • Ce qui est exécuté : uniquement le Meshy CLI, en tant que meshy ou le paquet épinglé via npm exec. La compétence est uniquement du Markdown, sans Python, curl ni script embarqué.
  • Identifiants : le CLI stocke et rafraîchit la session dans ~/.config/meshy/credentials.json avec le mode 0600. La compétence ne lit, n'affiche ni ne copie jamais un jeton, un code d'appareil ou une clé, et n'en demande jamais dans la conversation.
  • Réseau : les prompts, images et demandes de tâches sont envoyés à l'API Meshy (normalement api.meshy.ai). npm est contacté lors de l'installation ou de l'exécution temporaire du CLI.
  • Fichiers : chaque tâche écrit dans un seul dossier : celui que vous avez nommé, ou ./meshy_output. Les chemins en dehors sont refusés, et les fichiers existants ne sont pas écrasés sauf si vous le demandez.

Le manifeste de sécurité complet se trouve dans le code source de la compétence.

Dépannage

SymptômeSolution
La compétence n'est pas éligibleInstallez Node.js 22.12 ou plus récent avec npm, ou installez le CLI avec npm install -g meshy-cli, puis démarrez une nouvelle session.
L'agent demande une clé APIRefusez et demandez-lui de se connecter via le navigateur à la place. Ne collez jamais de clé API dans une conversation.
Le code de connexion a expiréDemandez à l'agent de relancer la connexion. Les codes sont valides 10 minutes.
La génération est refusée pour une question d'abonnement ou de créditsLa génération nécessite un abonnement payant et suffisamment de crédits. Vérifiez votre abonnement et votre solde sur meshy.ai.
Connecté au mauvais compte MeshyDemandez à l'agent d'exécuter meshy auth logout, puis reconnectez-vous.

FAQ

Qu'est-ce que la compétence Meshy pour OpenClaw ?
Meshy 3D Agent est la compétence Meshy officielle sur ClawHub. Elle permet à un agent OpenClaw de générer des modèles 3D, des textures, un rigging et des animations, et de préparer des modèles pour l'impression 3D, en pilotant le Meshy CLI.
Comment installer la compétence Meshy dans OpenClaw ?
Exécutez openclaw skills install @arlieeee/meshy-3d-agent. Vous avez aussi besoin de Node.js 22.12 ou plus récent avec npm ; OpenClaw propose d'installer le Meshy CLI depuis npm.
Ai-je besoin d'une clé API Meshy ?
Non. La compétence se connecte via votre navigateur avec un code à usage unique, et le Meshy CLI stocke la session. MESHY_API_KEY est optionnel ; s'il est défini, il prend la priorité.
La compétence fonctionne-t-elle lorsque OpenClaw s'exécute sur un serveur ?
Oui. La connexion par appareil affiche un lien et un code que vous pouvez approuver depuis n'importe quel navigateur, de sorte qu'OpenClaw peut s'exécuter sur une machine distante ou dans un conteneur.
La compétence Meshy est-elle gratuite ?
La compétence est gratuite à installer. La génération de modèles 3D nécessite un abonnement Meshy payant et consomme des crédits Meshy selon les tarifs de l'API. L'analyse de l'imprimabilité est gratuite.
J'utilisais l'ancienne compétence Meshy OpenClaw basée sur Python. Mes tâches fonctionnent-elles toujours ?
Oui. La compétence est passée au Meshy CLI en version 0.6.0, et les ID de tâches de l'ancienne compétence restent utilisables depuis le CLI.

Liens associés