Meshy Skill dla OpenClaw

Oficjalna umiejętność Meshy dla OpenClaw pozwala Twojemu agentowi generować modele 3D, tekstury i animacje oraz przygotowywać druki 3D — wszystko z poziomu czatu.

Przegląd

Meshy jest teraz dostępne na ClawHub jako Meshy 3D Agent — jedna umiejętność obejmująca:

  • Generowanie 3D: tekst na 3D, obraz na 3D i wiele widoków na 3D, teksturowanie i retekstur AI, remesh do zadanego budżetu wielokątów, rozkładanie UV, automatyczne rigowanie i animację dla postaci humanoidalnych oraz eksport do GLB, FBX, OBJ, STL lub USDZ.
  • Druk 3D: analizę i naprawę drukowalności, jednokolorowe i wielokolorowe 3MF, dopasowanie do rzeczywistych wymiarów, produkty Creative Lab (figurki, lampy, breloki, magnesy na lodówkę) oraz przekazanie do zainstalowanego slicera, takiego jak Bambu Studio, OrcaSlicer czy Creality Print.

Ta umiejętność napędza Meshy CLI. Logujesz się raz w przeglądarce; klucz API nie jest potrzebny.

Wymagania

  • OpenClaw.
  • Node.js w wersji 22.12 lub nowszej, wraz z npm, na maszynie, na której działa OpenClaw. Umiejętność staje się dostępna, gdy meshy lub npm znajduje się w PATH.
  • Płatny plan Meshy do generowania. Każde zadanie generowania wykorzystuje kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna, a lokalne kroki druku, takie jak przeskalowanie modelu lub otwarcie go w slicerze, nie wymagają logowania.

Instalacja

Zainstaluj umiejętność z ClawHub:

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

OpenClaw zaproponuje instalację Meshy CLI z npm, jeśli nie jest ono jeszcze zainstalowane. Globalna instalacja tylko przyspiesza uruchamianie; bez niej umiejętność uruchamia CLI przez npm exec.

Możesz też pozwolić agentowi wykonać całą konfigurację. Wklej to 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

Jeśli Twój agent wczytuje umiejętności tylko przy starcie, rozpocznij nową sesję po instalacji.

Logowanie

Przy pierwszej prośbie o model agent uruchamia logowanie urządzenia w Meshy CLI i wysyła Ci link oraz jednorazowy kod:

  1. Otwórz link na dowolnym urządzeniu i zaloguj się do Meshy.
  2. Wprowadź kod dokładnie tak, jak jest pokazany, a następnie kliknij Connect.
  3. Agent kontynuuje realizację Twojego żądania.

Strona łączenia Meshy CLI

Kod wygasa po 10 minutach; jeśli tak się stanie, poproś agenta o nowy. Ponieważ logowanie urządzenia działa z dowolnej przeglądarki, działa to również wtedy, gdy OpenClaw działa na serwerze lub w kontenerze. MESHY_API_KEY jest opcjonalny: jeśli jest ustawiony, ma pierwszeństwo przed sesją przeglądarki.

Przykładowe polecenia

  • Zrób model 3D szczeniaka husky i zapisz go jako GLB w ./assets.
  • Zamień to zdjęcie na teksturowany model 3D i zachowaj jego proporcje. (dołącz obraz)
  • Zrigguj tę postać humanoidalną, dodaj animację biegu i wyeksportuj ją jako FBX.
  • Pomóż mi wydrukować w 3D małą figurkę smoka o wysokości 80 mm i otwórz ją w Bambu Studio.
  • Zamień to logo w brelok, który mogę wydrukować w 3D.

Kolejne polecenia wykorzystują poprzedni wynik: zrób LOD na 1500 ścian, teraz jako FBX, przeskaluj do 150 mm. Dodaj zapytaj mnie przed wydaniem kredytów, aby zatwierdzać każdy płatny krok.

Bezpieczeństwo i dane

  • Co jest uruchamiane: tylko Meshy CLI, jako meshy lub przypięty pakiet przez npm exec. Umiejętność jest wyłącznie w formacie Markdown, bez Pythona, curl ani dołączonych skryptów.
  • Dane uwierzytelniające: CLI przechowuje i odświeża sesję w ~/.config/meshy/credentials.json z trybem 0600. Umiejętność nigdy nie odczytuje, nie wyświetla ani nie kopiuje tokena, kodu urządzenia ani klucza, i nigdy nie prosi o nie w czacie.
  • Sieć: polecenia, obrazy i żądania zadań trafiają do API Meshy (zazwyczaj api.meshy.ai). npm jest kontaktowany podczas instalacji lub tymczasowego uruchamiania CLI.
  • Pliki: każde zadanie zapisuje dane w jednym folderze: tym, który podałeś, lub ./meshy_output. Ścieżki poza nim są odrzucane, a istniejące pliki nie są nadpisywane, chyba że o to poprosisz.

Pełny manifest bezpieczeństwa znajduje się w źródle umiejętności.

Rozwiązywanie problemów

ObjawRozwiązanie
Umiejętność nie jest dostępnaZainstaluj Node.js w wersji 22.12 lub nowszej wraz z npm, lub zainstaluj CLI poleceniem npm install -g meshy-cli, a następnie rozpocznij nową sesję.
Agent prosi o klucz APIOdmów i poproś go, aby zamiast tego zalogował się przez przeglądarkę. Nigdy nie wklejaj klucza API na czacie.
Kod logowania wygasłPoproś agenta o ponowne rozpoczęcie logowania. Kody są ważne przez 10 minut.
Generowanie zostało odrzucone z powodu planu lub kredytówGenerowanie wymaga płatnego planu i wystarczającej liczby kredytów. Sprawdź swój plan i saldo na meshy.ai.
Zalogowano na niewłaściwe konto MeshyPoproś agenta o uruchomienie meshy auth logout, a następnie zaloguj się ponownie.

FAQ

Czym jest umiejętność Meshy dla OpenClaw?
Meshy 3D Agent to oficjalna umiejętność Meshy na ClawHub. Pozwala agentowi OpenClaw generować modele 3D, tekstury, rigging i animacje oraz przygotowywać modele do druku 3D poprzez sterowanie Meshy CLI.
Jak zainstalować umiejętność Meshy w OpenClaw?
Uruchom openclaw skills install @arlieeee/meshy-3d-agent. Potrzebujesz również Node.js w wersji 22.12 lub nowszej wraz z npm; OpenClaw zaproponuje instalację Meshy CLI z npm.
Czy potrzebuję klucza API Meshy?
Nie. Umiejętność loguje się przez przeglądarkę za pomocą jednorazowego kodu, a Meshy CLI przechowuje sesję. MESHY_API_KEY jest opcjonalny; jeśli jest ustawiony, ma pierwszeństwo.
Czy ta umiejętność działa, gdy OpenClaw działa na serwerze?
Tak. Logowanie urządzenia wyświetla link i kod, które można zatwierdzić z dowolnej przeglądarki, dzięki czemu OpenClaw może działać na zdalnej maszynie lub w kontenerze.
Czy umiejętność Meshy jest bezpłatna?
Instalacja umiejętności jest bezpłatna. Generowanie modeli 3D wymaga płatnego planu Meshy i wykorzystuje kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna.
Korzystałem/am ze starszej, opartej na Pythonie umiejętności Meshy OpenClaw. Czy moje zadania nadal działają?
Tak. Umiejętność przeszła na Meshy CLI w wersji 0.6.0, a identyfikatory zadań ze starej umiejętności nadal są używalne z poziomu CLI.

Powiązane linki