Meshy Skill for OpenClaw

The official Meshy skill for OpenClaw lets your agent generate 3D models, textures and animations and prepare 3D prints, all from a chat.

Overview

Meshy is now available on ClawHub as Meshy 3D Agent, one skill covering:

  • 3D generation: text to 3D, image to 3D and multi-view to 3D, AI texturing and retexturing, remeshing to a polygon budget, UV unwrapping, auto-rigging and animation for humanoid characters, and export to GLB, FBX, OBJ, STL or USDZ.
  • 3D printing: printability analysis and repair, single-color and multicolor 3MF, sizing to real-world dimensions, Creative Lab products (figurines, lamps, keychains, fridge magnets) and handoff to an installed slicer such as Bambu Studio, OrcaSlicer or Creality Print.

The skill drives the Meshy CLI. You sign in once in your browser; no API key is needed.

Requirements

  • OpenClaw.
  • Node.js 22.12 or newer, with npm, on the machine OpenClaw runs on. The skill becomes eligible when meshy or npm is on PATH.
  • A paid Meshy plan for generation. Every generation task spends Meshy credits at API rates. Printability analysis is free, and local print steps, such as rescaling a model or opening it in a slicer, need no sign-in.

Installation

Install the skill from ClawHub:

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

OpenClaw offers to install the Meshy CLI from npm if it isn't installed yet. A global install only makes startup faster; without one, the skill runs the CLI through npm exec.

You can also let the agent do the whole setup. Paste this into OpenClaw:

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

If your agent loads skills only at startup, start a new session after installing.

Sign In

The first time you ask for a model, the agent runs the Meshy CLI's device sign-in and sends you a link and a one-time code:

  1. Open the link on any device and log in to Meshy.
  2. Enter the code exactly as shown, then click Connect.
  3. The agent continues the request you made.

Connect Meshy CLI page

The code expires after 10 minutes; ask the agent for a new one if it does. Because the device flow works from any browser, this also works when OpenClaw runs on a server or in a container. MESHY_API_KEY is optional: if it's set, it takes priority over the browser session.

Example Prompts

  • 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. (attach the 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.

Follow-ups reuse the previous result: make a 1,500-face LOD, now as FBX, scale it to 150 mm. Add ask me before spending credits to approve each paid step.

Security and Data

  • What it runs: only the Meshy CLI, as meshy or the pinned package through npm exec. The skill is Markdown only, with no Python, curl or bundled scripts.
  • Credentials: the CLI stores and refreshes the session in ~/.config/meshy/credentials.json with mode 0600. The skill never reads, prints or copies a token, device code or key, and never asks for one in chat.
  • Network: prompts, images and task requests go to the Meshy API (normally api.meshy.ai). npm is contacted when the CLI is installed or run temporarily.
  • Files: each job writes inside one folder: the one you named, or ./meshy_output. Paths outside it are refused, and existing files are not overwritten unless you ask.

The full security manifest is in the skill's source.

Troubleshooting

SymptomFix
The skill isn't eligibleInstall Node.js 22.12 or newer with npm, or install the CLI with npm install -g meshy-cli, then start a new session.
The agent asks for an API keyDecline and ask it to sign in through the browser instead. Never paste an API key into a chat.
The sign-in code expiredAsk the agent to start the sign-in again. Codes are valid for 10 minutes.
Generation is refused for plan or creditsGeneration needs a paid plan and enough credits. Check your plan and balance on meshy.ai.
Signed in to the wrong Meshy accountAsk the agent to run meshy auth logout, then sign in again.

FAQ

What is the Meshy skill for OpenClaw?
Meshy 3D Agent is the official Meshy skill on ClawHub. It lets an OpenClaw agent generate 3D models, textures, rigging and animation, and prepare models for 3D printing, by driving the Meshy CLI.
How do I install the Meshy skill in OpenClaw?
Run openclaw skills install @arlieeee/meshy-3d-agent. You also need Node.js 22.12 or newer with npm; OpenClaw offers to install the Meshy CLI from npm.
Do I need a Meshy API key?
No. The skill signs in through your browser with a one-time code, and the Meshy CLI stores the session. MESHY_API_KEY is optional; if it is set, it takes priority.
Does the skill work when OpenClaw runs on a server?
Yes. The device sign-in shows a link and a code that you can approve from any browser, so OpenClaw can run on a remote machine or in a container.
Is the Meshy skill free?
The skill is free to install. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free.
I used the older Python-based Meshy OpenClaw skill. Do my tasks still work?
Yes. The skill moved to the Meshy CLI in version 0.6.0, and task IDs from the old skill remain usable from the CLI.

Related Links