Dovednost Meshy pro OpenClaw

Přidejte dovednost Meshy do OpenClaw, aby váš agent mohl z chatu generovat 3D modely, textury a animace a připravovat 3D tisky.

Přehled

Dovednost Meshy je na ClawHub k dispozici jako Meshy 3D Agent. Tato jediná dovednost pokrývá oba pracovní postupy:

  • 3D generování: Text na 3D, Obrázek na 3D a Více obrázků na 3D, AI texturování a přetexturování, remesh na stanovený počet polygonů, UV rozbalení, automatický rigging a animace pro humanoidní postavy a export do GLB, FBX, OBJ, STL nebo USDZ.
  • 3D tisk: analýza tisknutelnosti a oprava, jednobarevný i vícebarevný 3MF, přizpůsobení skutečným rozměrům, produkty Creative Lab, jako jsou figurky, lampy, klíčenky a magnetky na lednici, a předání nainstalovanému slicer, jako je Bambu Studio, OrcaSlicer nebo Creality Print.

Dovednost spouští Meshy CLI, což je balíček meshy-cli na npm. Přihlásíte se jednou ve svém prohlížeči a nepotřebujete API klíč.

Než začnete

  • Potřebujete OpenClaw.

  • Na počítači, na kterém běží OpenClaw, potřebujete Node.js 22.12 nebo novější, spolu s npm. OpenClaw zpřístupní dovednost, pokud je meshy nebo npm dostupné v PATH.

  • Pro generování modelů potřebujete placený plán Meshy. Každá generovací úloha spotřebovává kredity Meshy podle API sazeb. Náklady na jednotlivé úlohy najdete v sekci Ceny. Analýza tisknutelnosti je zdarma a místní kroky tisku, jako je přeškálování modelu nebo jeho otevření ve slicer, nevyžadují přihlášení.

Instalace dovednosti

Pro instalaci dovednosti z ClawHub spusťte následující příkaz:

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

Pokud Meshy CLI není nainstalováno, stránka Skills v OpenClaw může nabídnout jeho instalaci z npm. Globální instalace není nutná. Bez ní dovednost spouští CLI prostřednictvím npm exec, přičemž globální instalace pouze zrychlí spuštění.

Pokud chcete, aby celé nastavení provedl OpenClaw za vás, vložte do chatu následující text:

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

Otevřená relace dovednost převezme při dalším tahu. Pokud jste nainstalovali Node.js nebo Meshy CLI během otevřené relace, spusťte novou relaci, aby je OpenClaw našel.

Přihlášení

Když poprvé požádáte o model, OpenClaw spustí přihlášení přes Meshy CLI a pošle vám odkaz a jednorázový kód.

Při přihlašování postupujte takto:

  1. Otevřete odkaz na libovolném zařízení.

  2. Pokud stránka vyžaduje kód, zadejte jej do pole Device code přesně tak, jak jej zobrazuje OpenClaw, a poté klikněte na Continue.

  3. Pokud vás Meshy vyzve k přihlášení, přihlaste se ke svému účtu Meshy.

  4. Na stránce Connect Meshy CLI klikněte na Connect. Stránka zobrazí Meshy CLI authorized.

    Stránka Connect Meshy CLI s přihlášeným účtem, přístupem, který CLI získá, a tlačítky Cancel a Connect

  5. Vraťte se do chatu. OpenClaw pokračuje v požadavku, který jste zadali.

Platnost kódu vyprší po 10 minutách. Pokud vyprší, požádejte OpenClaw o nový. Přihlášení můžete schválit z libovolného prohlížeče, takže to funguje i v případě, že OpenClaw běží na serveru nebo v kontejneru.

Nepotřebujete MESHY_API_KEY. Pokud je nastaven, CLI použije tento API klíč místo relace prohlížeče.

Příklady promptů

Popište úkol vlastními slovy. Například:

  • 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 vytisknout malou figurku draka na 3D tiskárně, vysokou 80 mm, a otevři ji v Bambu Studio.
  • Proměň toto logo v klíčenku, kterou mohu vytisknout na 3D tiskárně.

Navazující požadavky využívají předchozí výsledek, například vytvoř LOD s 1 500 polygony, nyní jako FBX nebo zvětši to na 150 mm. Pokud chcete schvalovat každý placený krok sami, přidejte do požadavku zeptej se mě před útratou kreditů.

Bezpečnost a data

Následující seznam shrnuje, jak dovednost pracuje s příkazy, přihlašovacími údaji, síťovým přístupem a soubory:

  • Co spouští: Pouze Meshy CLI, buď jako meshy, nebo jako zafixovaný balíček prostřednictvím npm exec. Dovednost je pouze ve formátu Markdown, bez Pythonu, curl nebo přibalených skriptů.
  • Přihlašovací údaje: CLI ukládá a obnovuje relaci v souboru ~/.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 nežádá v chatu.
  • Síť: CLI odesílá prompty, obrázky a požadavky na úlohy do Meshy API, obvykle na api.meshy.ai. npm kontaktuje svůj registr při instalaci CLI nebo při jeho spuštění jako dočasného balíčku.
  • Soubory: Každá úloha zapisuje pouze do jedné složky — té, kterou jste pojmenovali, nebo do ./meshy_output. CLI odmítá cesty mimo tuto složku a nepřepisuje existující soubory, pokud o to nepožádáte.

Úplný bezpečnostní manifest najdete v meshy-openclaw na GitHubu.

Řešení problémů

Následující tabulka uvádí běžné problémy, jejich příčiny a způsob jejich řešení.

ProblémPříčinaŘešení
Dovednost není v OpenClaw dostupnáV PATH není ani meshy, ani npm.Nainstalujte Node.js 22.12 nebo novější spolu s npm a poté spusťte novou relaci.
OpenClaw žádá o API klíčDovednost jej nepotřebuje. Přihlašuje se přes váš prohlížeč.Odmítněte a požádejte OpenClaw, aby se přihlásil přes prohlížeč. Nikdy nevkládejte API klíč do chatu.
Platnost přihlašovacího kódu vypršelaKód je platný 10 minut.Požádejte OpenClaw, aby přihlášení spustil znovu.
OpenClaw nemůže generovat kvůli vašemu plánu nebo kreditůmGenerování vyžaduje placený plán a dostatek kreditů.Zkontrolujte svůj plán a zůstatek na stránce Subscription ve webové aplikaci Meshy.
Jste přihlášeni k nesprávnému účtu MeshyMeshy CLI znovu používá relaci uloženou na vašem počítači.Požádejte OpenClaw, aby spustil meshy auth logout, a poté se znovu přihlaste.

Časté dotazy

Co je dovednost Meshy pro OpenClaw?
Meshy 3D Agent je dovednost Meshy na ClawHub. Umožňuje agentovi OpenClaw generovat 3D modely, textury, rigging a animace a připravovat modely pro 3D tisk pomocí spouštění Meshy CLI.
Jak nainstaluji dovednost Meshy v OpenClaw?
Spusťte openclaw skills install @arlieeee/meshy-3d-agent. Také potřebujete Node.js 22.12 nebo novější s npm. Stránka Skills v OpenClaw může nabídnout 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 uloží relaci. MESHY_API_KEY nepotřebujete, ale pokud je nastaven, Meshy CLI jej místo toho použije.
Funguje dovednost, když OpenClaw běží na serveru?
Ano. Přihlášení zobrazí odkaz a kód, které můžete schválit z libovolného prohlížeče, takže OpenClaw může běžet na vzdáleném počítači 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 můžete s CLI stále používat.

Další kroky