Skill Meshy dla OpenClaw

Dodaj skill Meshy do OpenClaw, aby Twój agent mógł generować modele 3D, tekstury i animacje oraz przygotowywać modele do druku 3D bezpośrednio z czatu.

Przegląd

Skill Meshy jest dostępny na ClawHub jako Meshy 3D Agent. Ten jeden skill obejmuje oba przepływy pracy:

  • Generowanie 3D: Tekst na 3D, Obraz na 3D i Wiele obrazów na 3D, teksturowanie i retexturing z użyciem AI, remesh do zadanego budżetu wielokątów, UV unwrapping, automatyczny rigging i animacja postaci humanoidalnych oraz eksport do GLB, FBX, OBJ, STL lub USDZ.
  • Druk 3D: analiza i naprawa drukowalności, jednokolorowe i wielokolorowe pliki 3MF, dopasowanie do rzeczywistych wymiarów, produkty Creative Lab, takie jak figurki, lampy, breloki i magnesy na lodówkę, a także przekazanie do zainstalowanego slicera, takiego jak Bambu Studio, OrcaSlicer lub Creality Print.

Skill uruchamia Meshy CLI, czyli pakiet meshy-cli dostępny w npm. Logujesz się raz w przeglądarce i nie potrzebujesz klucza API.

Zanim zaczniesz

  • Potrzebujesz OpenClaw.

  • Potrzebujesz Node.js w wersji 22.12 lub nowszej, wraz z npm, na komputerze, na którym uruchamiany jest OpenClaw. OpenClaw udostępnia skill, gdy meshy lub npm znajdują się w PATH.

  • Aby generować modele, potrzebujesz płatnego planu Meshy. Każde zadanie generowania zużywa kredyty Meshy według stawek API. Koszt każdego zadania znajdziesz w sekcji Cennik. Analiza drukowalności jest bezpłatna, a lokalne kroki druku, takie jak przeskalowanie modelu lub otwarcie go w slicerze, nie wymagają logowania.

Instalacja skilla

Aby zainstalować skill z ClawHub, uruchom następujące polecenie:

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

Jeśli Meshy CLI nie jest zainstalowane, strona Skills w OpenClaw może zaproponować jego instalację z npm. Nie musisz instalować go globalnie. Bez instalacji globalnej skill uruchamia CLI przez npm exec, a instalacja globalna jedynie przyspiesza start.

Aby zlecić OpenClaw całą konfigurację, wklej następujący tekst na czacie:

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

Otwarta sesja wykryje skill przy następnej turze. Jeśli zainstalowałeś Node.js lub Meshy CLI podczas trwania sesji, rozpocznij nową sesję, aby OpenClaw mógł je znaleźć.

Logowanie

Przy pierwszym poproszeniu o model, OpenClaw uruchamia logowanie w Meshy CLI i wysyła Ci link oraz jednorazowy kod.

Aby się zalogować, wykonaj następujące kroki:

  1. Otwórz link na dowolnym urządzeniu.

  2. Jeśli strona poprosi o kod, wpisz go w polu Device code dokładnie tak, jak pokazuje OpenClaw, a następnie kliknij Continue.

  3. Jeśli Meshy poprosi Cię o zalogowanie, zaloguj się na swoje konto Meshy.

  4. Na stronie Connect Meshy CLI kliknij Connect. Strona wyświetli komunikat Meshy CLI authorized.

    Strona Connect Meshy CLI z zalogowanym kontem, zakresem dostępu, jaki otrzymuje CLI, oraz przyciskami Cancel i Connect

  5. Wróć do czatu. OpenClaw kontynuuje realizację Twojego żądania.

Kod wygasa po 10 minutach. Jeśli wygaśnie, poproś OpenClaw o nowy. Logowanie możesz zatwierdzić z dowolnej przeglądarki, więc działa to również wtedy, gdy OpenClaw działa na serwerze lub w kontenerze.

Nie potrzebujesz MESHY_API_KEY. Jeśli jest ustawiony, CLI używa tego klucza API zamiast sesji w przeglądarce.

Przykładowe polecenia

Opisz zadanie własnymi słowami. Na przykład:

  • Stwórz model 3D szczeniaka husky i zapisz go jako GLB w ./assets.
  • Zamień to zdjęcie w teksturowany model 3D, zachowując proporcje. (dołącz obraz)
  • Dodaj rig tej postaci humanoidalnej, dodaj animację biegu i wyeksportuj 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 żądania wykorzystują poprzedni wynik, na przykład zrób LOD na 1500 ścian, teraz jako FBX lub przeskaluj do 150 mm. Aby samodzielnie zatwierdzać każdy płatny krok, dodaj do żądania zapytaj mnie przed wydaniem kredytów.

Bezpieczeństwo i dane

Poniższa lista podsumowuje, jak skill obsługuje polecenia, poświadczenia, dostęp do sieci i pliki:

  • Co uruchamia: Wyłącznie Meshy CLI, jako meshy lub jako przypięty pakiet uruchamiany przez npm exec. Skill zawiera wyłącznie Markdown, bez Pythona, curl ani dołączonych skryptów.
  • Poświadczenia: CLI przechowuje i odświeża sesję w pliku ~/.config/meshy/credentials.json z uprawnieniami 0600. Skill nigdy nie odczytuje, nie wyświetla ani nie kopiuje tokenu, kodu urządzenia ani klucza, i nigdy nie prosi o nie na czacie.
  • Sieć: CLI wysyła polecenia, obrazy i żądania zadań do API Meshy, zwykle pod adres api.meshy.ai. npm łączy się ze swoim rejestrem podczas instalacji CLI lub uruchamiania go jako pakietu tymczasowego.
  • Pliki: Każde zadanie zapisuje dane wyłącznie w jednym folderze — tym, który podałeś, lub w ./meshy_output. CLI odmawia zapisu poza tym folderem i nie nadpisuje istniejących plików, chyba że o to poprosisz.

Pełny opis zabezpieczeń znajdziesz w repozytorium meshy-openclaw na GitHub.

Rozwiązywanie problemów

Poniższa tabela zawiera listę typowych problemów, ich przyczyny oraz sposoby ich rozwiązania.

ProblemPrzyczynaRozwiązanie
Skill nie jest dostępny w OpenClawAni meshy, ani npm nie znajdują się w PATH.Zainstaluj Node.js w wersji 22.12 lub nowszej wraz z npm, a następnie rozpocznij nową sesję.
OpenClaw prosi o klucz APISkill go nie potrzebuje. Loguje się przez przeglądarkę.Odmów i poproś OpenClaw, aby zamiast tego zalogował się przez przeglądarkę. Nigdy nie wklejaj klucza API na czacie.
Kod logowania wygasłKod jest ważny przez 10 minut.Poproś OpenClaw o ponowne rozpoczęcie logowania.
OpenClaw nie może wygenerować modelu z powodu planu lub kredytówGenerowanie wymaga płatnego planu i wystarczającej liczby kredytów.Sprawdź swój plan i saldo na stronie Subscription w aplikacji webowej Meshy.
Jesteś zalogowany na niewłaściwe konto MeshyMeshy CLI ponownie wykorzystuje sesję zapisaną na Twoim komputerze.Poproś OpenClaw o uruchomienie meshy auth logout, a następnie zaloguj się ponownie.

FAQ

Czym jest skill Meshy dla OpenClaw?
Meshy 3D Agent to skill Meshy dostępny na ClawHub. Pozwala agentowi OpenClaw generować modele 3D, tekstury, rigging i animacje oraz przygotowywać modele do druku 3D poprzez uruchamianie Meshy CLI.
Jak zainstalować skill Meshy w OpenClaw?
Uruchom polecenie openclaw skills install @arlieeee/meshy-3d-agent. Potrzebujesz również Node.js w wersji 22.12 lub nowszej wraz z npm. Strona Skills w OpenClaw może zaproponować instalację Meshy CLI z npm.
Czy potrzebuję klucza API Meshy?
Nie. Skill loguje się przez przeglądarkę za pomocą jednorazowego kodu, a Meshy CLI przechowuje sesję. Nie potrzebujesz MESHY_API_KEY, ale jeśli jest on ustawiony, Meshy CLI użyje go zamiast tego.
Czy skill działa, gdy OpenClaw uruchomiony jest na serwerze?
Tak. Logowanie wyświetla link i kod, które możesz zatwierdzić z dowolnej przeglądarki, więc OpenClaw może działać na zdalnym komputerze lub w kontenerze.
Czy skill Meshy jest darmowy?
Instalacja skilla jest bezpłatna. Generowanie modeli 3D wymaga płatnego planu Meshy i zużywa kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna.
Korzystałem ze starszego skilla Meshy OpenClaw opartego na Pythonie. Czy moje zadania nadal działają?
Tak. Skill przeszedł na Meshy CLI w wersji 0.6.0, a identyfikatory zadań ze starego skilla nadal można wykorzystywać w CLI.

Następne kroki