Dovednost Meshy pro OpenClaw

Oficiální dovednost Meshy pro OpenClaw umožňuje vašemu agentovi generovat 3D modely, textury a animace a připravovat podklady pro 3D tisk, a to vše z chatu.

Přehled

Meshy je nyní dostupné na ClawHub jako Meshy 3D Agent, jedna dovednost pokrývající:

  • 3D generování: text na 3D, obrázek na 3D a více pohledů na 3D, AI texturování a retexturování, remeshing na zadaný rozpočet polygonů, rozbalení UV, automatický rigging a animaci pro humanoidní postavy a export do GLB, FBX, OBJ, STL nebo USDZ.
  • 3D tisk: analýza a oprava tisknutelnosti, jednobarevný a vícebarevný 3MF, přizpůsobení skutečným rozměrům, produkty Creative Lab (figurky, lampy, klíčenky, magnetky na lednici) a předání do nainstalovaného slicera, jako je Bambu Studio, OrcaSlicer nebo Creality Print.

Dovednost pohání Meshy CLI. Přihlásíte se jednou ve svém prohlížeči; API klíč není potřeba.

Požadavky

  • OpenClaw.
  • Node.js 22.12 nebo novější, s npm, na stroji, na kterém běží OpenClaw. Dovednost se stane dostupnou, jakmile je meshy nebo npm v PATH.
  • Placený plán Meshy pro generování. Každá generovací úloha spotřebovává kredity Meshy podle API sazeb. Analýza tisknutelnosti je zdarma a lokální kroky tisku, jako je přeškálování modelu nebo jeho otevření ve sliceru, nevyžadují přihlášení.

Instalace

Nainstalujte dovednost z ClawHub:

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

OpenClaw nabídne instalaci Meshy CLI z npm, pokud ještě není nainstalováno. Globální instalace pouze zrychlí spuštění; bez ní dovednost spouští CLI přes npm exec.

Můžete také nechat celou instalaci provést agenta. Vložte toto do OpenClaw:

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

Pokud váš agent načítá dovednosti pouze při spuštění, po instalaci zahajte novou relaci.

Přihlášení

Při prvním požadavku na model agent spustí přihlášení zařízení přes Meshy CLI a pošle vám odkaz a jednorázový kód:

  1. Otevřete odkaz na libovolném zařízení a přihlaste se do Meshy.
  2. Zadejte kód přesně tak, jak je zobrazen, a poté klikněte na Connect.
  3. Agent pokračuje v požadavku, který jste zadali.

Stránka připojení Meshy CLI

Platnost kódu vyprší po 10 minutách; pokud k tomu dojde, požádejte agenta o nový. Protože proces přihlášení zařízení funguje z jakéhokoli prohlížeče, funguje to i tehdy, když OpenClaw běží na serveru nebo v kontejneru. MESHY_API_KEY je volitelný: pokud je nastaven, má přednost před relací v prohlížeči.

Příklady promptů

  • Vytvoř 3D model štěněte husky a ulož ho jako GLB do ./assets.
  • Proměň tuto fotografii v texturovaný 3D model a zachovej jeho proporce. (přiložte obrázek)
  • Vytvoř rig pro tuto humanoidní postavu, přidej animaci běhu a exportuj ji jako FBX.
  • Pomoz mi 3D vytisknout malou figurku draka, 80 mm vysokou, a otevři ji v Bambu Studio.
  • Proměň toto logo v klíčenku, kterou mohu 3D vytisknout.

Navazující požadavky znovu použijí předchozí výsledek: vytvoř LOD s 1 500 plochami, teď jako FBX, zvětši to na 150 mm. Přidejte zeptej se mě, než utratíš kredity, abyste schválili každý placený krok.

Zabezpečení a data

  • Co se spouští: pouze Meshy CLI, buď jako meshy, nebo jako připnutý balíček přes npm exec. Dovednost je pouze v Markdownu, bez Pythonu, curl nebo přibalených skriptů.
  • Přihlašovací údaje: CLI ukládá a obnovuje relaci v ~/.config/meshy/credentials.json s oprávněním 0600. Dovednost nikdy nečte, nevypisuje ani nekopíruje token, kód zařízení nebo klíč a nikdy o něj v chatu nežádá.
  • Síť: prompty, obrázky a požadavky na úlohy jsou odesílány do Meshy API (obvykle api.meshy.ai). npm je kontaktován při instalaci CLI nebo jeho dočasném spuštění.
  • Soubory: každá úloha zapisuje do jedné složky: té, kterou jste pojmenovali, nebo do ./meshy_output. Cesty mimo tuto složku jsou odmítnuty a existující soubory se nepřepisují, pokud o to nepožádáte.

Úplný manifest zabezpečení najdete ve zdrojovém kódu dovednosti.

Řešení problémů

PříznakŘešení
Dovednost není dostupnáNainstalujte Node.js 22.12 nebo novější s npm, nebo nainstalujte CLI pomocí npm install -g meshy-cli a poté zahajte novou relaci.
Agent žádá o API klíčOdmítněte a požádejte ho, aby se místo toho přihlásil přes prohlížeč. Nikdy nevkládejte API klíč do chatu.
Platnost přihlašovacího kódu vypršelaPožádejte agenta, aby znovu zahájil přihlášení. Kódy jsou platné 10 minut.
Generování je odmítnuto kvůli plánu nebo kreditůmGenerování vyžaduje placený plán a dostatek kreditů. Zkontrolujte svůj plán a zůstatek na meshy.ai.
Přihlášení k nesprávnému účtu MeshyPožádejte agenta, aby spustil meshy auth logout, a poté se znovu přihlaste.

FAQ

Co je dovednost Meshy pro OpenClaw?
Meshy 3D Agent je oficiální dovednost Meshy na ClawHub. Umožňuje agentovi OpenClaw generovat 3D modely, textury, rigging a animace a připravovat modely pro 3D tisk, a to pomocí Meshy CLI.
Jak nainstaluji dovednost Meshy v OpenClaw?
Spusťte openclaw skills install @arlieeee/meshy-3d-agent. Budete také potřebovat Node.js 22.12 nebo novější s npm; OpenClaw nabídne instalaci Meshy CLI z npm.
Potřebuji API klíč Meshy?
Ne. Dovednost se přihlašuje přes váš prohlížeč pomocí jednorázového kódu a Meshy CLI ukládá relaci. MESHY_API_KEY je volitelný; pokud je nastaven, má přednost.
Funguje dovednost, když OpenClaw běží na serveru?
Ano. Přihlášení zařízení zobrazí odkaz a kód, které můžete schválit z jakéhokoli prohlížeče, takže OpenClaw může běžet na vzdáleném stroji nebo v kontejneru.
Je dovednost Meshy zdarma?
Instalace dovednosti je zdarma. Generování 3D modelů vyžaduje placený plán Meshy a spotřebovává kredity Meshy podle API sazeb. Analýza tisknutelnosti je zdarma.
Používal jsem starší, na Pythonu založenou dovednost Meshy OpenClaw. Fungují mé úlohy stále?
Ano. Dovednost přešla na Meshy CLI ve verzi 0.6.0 a ID úloh ze staré dovednosti zůstávají v CLI použitelná.

Související odkazy