OpenClaw için Meshy Skill'i

OpenClaw için resmi Meshy skill'i, ajanınızın bir sohbetten 3D modeller, dokular ve animasyonlar oluşturmasını ve 3D baskılar hazırlamasını sağlar.


Genel Bakış

Meshy artık ClawHub'da Meshy 3D Agent olarak kullanılabilir; şunları kapsayan tek bir skill:

  • 3D oluşturma: metinden 3D'ye, görselden 3D'ye ve çoklu görünümden 3D'ye, AI dokulandırma ve yeniden dokulandırma, bir poligon bütçesine remesh, UV açma, insansı karakterler için otomatik rigging ve animasyon ve GLB, FBX, OBJ, STL veya USDZ olarak dışa aktarma.
  • 3D baskı: basılabilirlik analizi ve onarımı, tek renkli ve çok renkli 3MF, gerçek dünya boyutlarına ölçeklendirme, Creative Lab ürünleri (figürler, lambalar, anahtarlıklar, buzdolabı mıknatısları) ve Bambu Studio, OrcaSlicer veya Creality Print gibi kurulu bir dilimleyiciye aktarım.

Skill, Meshy CLI'ı kullanır. Tarayıcınızda bir kez oturum açarsınız; API anahtarına gerek yoktur.


Gereksinimler

  • OpenClaw.
  • OpenClaw'un çalıştığı makinede npm ile birlikte Node.js 22.12 veya daha yenisi. meshy veya npm, PATH üzerinde olduğunda skill uygun hale gelir.
  • Oluşturma için ücretli bir Meshy planı. Her oluşturma görevi API oranlarında Meshy kredisi harcar. Basılabilirlik analizi ücretsizdir ve bir modeli yeniden ölçeklendirmek veya bir dilimleyicide açmak gibi yerel baskı adımları için oturum açmaya gerek yoktur.

Kurulum

Skill'i ClawHub'dan yükleyin:

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

OpenClaw, henüz yüklenmemişse Meshy CLI'ı npm'den yüklemeyi teklif eder. Genel bir kurulum yalnızca başlatmayı hızlandırır; bu olmadan skill, CLI'ı npm exec üzerinden çalıştırır.

Tüm kurulumu ajanın yapmasına da izin verebilirsiniz. Bunu OpenClaw'a yapıştırın:

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

Ajanınız skill'leri yalnızca başlangıçta yüklüyorsa, kurulumdan sonra yeni bir oturum başlatın.


Oturum Açma

Bir model istediğinizde ilk kez, ajan Meshy CLI'ın cihaz oturum açma işlemini çalıştırır ve size bir bağlantı ile tek kullanımlık bir kod gönderir:

  1. Bağlantıyı herhangi bir cihazda açın ve Meshy'de oturum açın.
  2. Kodu gösterildiği gibi tam olarak girin, ardından Connect düğmesine tıklayın.
  3. Ajan yaptığınız isteğe devam eder.

Meshy CLI Connect sayfası

Kod 10 dakika sonra sona erer; bu olursa ajandan yeni bir kod isteyin. Cihaz akışı herhangi bir tarayıcıdan çalıştığından, bu OpenClaw bir sunucuda veya bir konteynerde çalıştığında da işe yarar. MESHY_API_KEY isteğe bağlıdır: ayarlanmışsa tarayıcı oturumuna göre önceliklidir.


Örnek İstemler

  • Bir yavru husky köpeğinin 3D modelini yap ve ./assets içine GLB olarak kaydet.
  • Bu fotoğrafı dokulu bir 3D modele dönüştür ve oranlarını koru. (görseli ekleyin)
  • Bu insansı karakteri rigle, bir koşu animasyonu ekle ve FBX olarak dışa aktar.
  • 80 mm boyunda küçük bir ejderha figürü basmama yardım et ve Bambu Studio'da aç.
  • Bu logoyu 3D basabileceğim bir anahtarlığa dönüştür.

Takip istemleri önceki sonucu yeniden kullanır: 1.500 yüzlü bir LOD yap, şimdi FBX olarak, 150 mm'ye ölçeklendir. Her ücretli adımı onaylamak için kredi harcamadan önce bana sor ekleyin.


Güvenlik ve Veri

  • Ne çalıştırır: yalnızca Meshy CLI, meshy olarak veya npm exec üzerinden sabitlenmiş paket olarak. Skill yalnızca Markdown'dır, Python, curl veya paketlenmiş betik içermez.
  • Kimlik bilgileri: CLI, oturumu ~/.config/meshy/credentials.json dosyasında mode 0600 ile depolar ve yeniler. Skill hiçbir zaman bir token, cihaz kodu veya anahtarı okumaz, yazdırmaz veya kopyalamaz ve bunu asla sohbette istemez.
  • Ağ: istemler, görseller ve görev istekleri Meshy API'ye gider (normalde api.meshy.ai). CLI yüklendiğinde veya geçici olarak çalıştırıldığında npm ile iletişim kurulur.
  • Dosyalar: her iş tek bir klasöre yazar: adlandırdığınız klasör veya ./meshy_output. Bunun dışındaki yollar reddedilir ve siz istemediğiniz sürece mevcut dosyaların üzerine yazılmaz.

Tam güvenlik beyanı skill'in kaynağında yer alır.


Sorun giderme

BelirtiÇözüm
Skill uygun değilNode.js 22.12 veya daha yenisini npm ile birlikte yükleyin ya da CLI'ı npm install -g meshy-cli ile yükleyin, ardından yeni bir oturum başlatın.
Ajan bir API anahtarı istiyorReddedin ve bunun yerine tarayıcı üzerinden oturum açmasını isteyin. Asla bir API anahtarını sohbete yapıştırmayın.
Oturum açma kodu süresi dolduAjandan oturum açmayı tekrar başlatmasını isteyin. Kodlar 10 dakika geçerlidir.
Plan veya kredi nedeniyle oluşturma reddedildiOluşturma için ücretli bir plan ve yeterli kredi gerekir. Planınızı ve bakiyenizi meshy.ai üzerinde kontrol edin.
Yanlış Meshy hesabıyla oturum açıldıAjandan meshy auth logout komutunu çalıştırmasını isteyin, ardından yeniden oturum açın.

SSS

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.