OpenClaw를 위한 Meshy 스킬

OpenClaw를 위한 공식 Meshy 스킬을 사용하면 에이전트가 채팅만으로 3D 모델, 텍스처, 애니메이션을 생성하고 3D 프린팅을 준비할 수 있습니다.

개요

이제 Meshy는 ClawHub에서 Meshy 3D Agent라는 하나의 스킬로 제공되며, 다음과 같은 기능을 포괄합니다:

  • 3D 생성: 텍스트로 3D, 이미지로 3D, 멀티뷰로 3D, AI 텍스처링 및 재텍스처링, 폴리곤 예산에 맞춘 리메시, UV 언래핑, 휴머노이드 캐릭터를 위한 자동 리깅 및 애니메이션, GLB, FBX, OBJ, STL 또는 USDZ로 내보내기.
  • 3D 프린팅: 프린팅 가능성 분석 및 복구, 단색 및 다색 3MF, 실제 치수에 맞춘 크기 조정, Creative Lab 제품(피규어, 조명, 키링, 냉장고 자석) 및 Bambu Studio, OrcaSlicer, Creality Print 같은 설치된 슬라이서로의 전달.

이 스킬은 Meshy CLI를 기반으로 동작합니다. 브라우저에서 한 번만 로그인하면 되며, API 키는 필요하지 않습니다.

요구 사항

  • OpenClaw.
  • OpenClaw가 실행되는 머신에 npm이 포함된 Node.js 22.12 이상. meshy 또는 npm이 PATH에 있으면 스킬을 사용할 수 있게 됩니다.
  • 생성을 위한 유료 Meshy 플랜. 모든 생성 작업은 API 요금에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료이며, 모델 크기 재조정이나 슬라이서에서 열기와 같은 로컬 프린트 단계는 로그인이 필요하지 않습니다.

설치

ClawHub에서 스킬을 설치합니다:

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

OpenClaw는 아직 설치되어 있지 않은 경우 npm에서 Meshy CLI를 설치할 것을 제안합니다. 전역 설치는 시작 속도를 더 빠르게 할 뿐이며, 설치하지 않아도 스킬은 npm exec을 통해 CLI를 실행합니다.

에이전트에게 전체 설정을 맡길 수도 있습니다. 다음을 OpenClaw에 붙여넣으세요:

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

에이전트가 시작 시에만 스킬을 불러오는 경우, 설치 후 새 세션을 시작하세요.

로그인

모델을 처음 요청하면 에이전트는 Meshy CLI의 기기 로그인을 실행하여 링크와 일회용 코드를 전송합니다:

  1. 아무 기기에서나 링크를 열고 Meshy에 로그인합니다.
  2. 표시된 대로 정확히 코드를 입력한 다음 Connect를 클릭합니다.
  3. 에이전트가 요청하신 작업을 이어서 진행합니다.

Connect Meshy CLI page

코드는 10분 후 만료됩니다. 만료되면 에이전트에게 새 코드를 요청하세요. 기기 흐름은 어떤 브라우저에서도 작동하므로, OpenClaw가 서버나 컨테이너에서 실행되는 경우에도 동일하게 작동합니다. MESHY_API_KEY는 선택 사항이며, 설정되어 있으면 브라우저 세션보다 우선합니다.

예시 프롬프트

  • 아기 허스키의 3D 모델을 만들어서 ./assets에 GLB로 저장해줘.
  • 이 사진을 텍스처가 적용된 3D 모델로 바꿔주되 비율은 유지해줘. (이미지 첨부)
  • 이 휴머노이드 캐릭터를 리깅하고 달리기 애니메이션을 추가한 다음 FBX로 내보내줘.
  • 높이 80mm짜리 작은 드래곤 피규어를 3D 프린트할 수 있게 도와주고 Bambu Studio에서 열어줘.
  • 이 로고를 3D 프린트할 수 있는 키링으로 만들어줘.

후속 요청은 이전 결과를 재사용합니다: 1,500면짜리 LOD로 만들어줘, 이제 FBX로, 150mm로 크기를 조정해줘. 각 유료 단계를 승인하려면 크레딧을 쓰기 전에 먼저 물어봐줘를 추가하세요.

보안 및 데이터

  • 실행되는 항목: meshy 또는 npm exec을 통한 고정 버전 패키지로서의 Meshy CLI뿐입니다. 이 스킬은 Markdown으로만 구성되며, Python, curl 또는 번들 스크립트는 포함되지 않습니다.
  • 자격 증명: CLI는 세션을 모드 0600으로 ~/.config/meshy/credentials.json에 저장하고 갱신합니다. 이 스킬은 토큰, 기기 코드, 키를 읽거나 출력하거나 복사하지 않으며, 채팅에서 이를 요청하지도 않습니다.
  • 네트워크: 프롬프트, 이미지, 작업 요청은 Meshy API(일반적으로 api.meshy.ai)로 전송됩니다. CLI를 설치하거나 임시로 실행할 때 npm에 접속합니다.
  • 파일: 각 작업은 하나의 폴더 내부에만 기록합니다: 사용자가 지정한 폴더 또는 ./meshy_output입니다. 해당 폴더 외부 경로는 거부되며, 요청하지 않는 한 기존 파일을 덮어쓰지 않습니다.

전체 보안 매니페스트는 스킬의 소스에서 확인할 수 있습니다.

문제 해결

증상해결 방법
스킬을 사용할 수 없음npm이 포함된 Node.js 22.12 이상을 설치하거나 npm install -g meshy-cli로 CLI를 설치한 다음 새 세션을 시작하세요.
에이전트가 API 키를 요청함거부하고 대신 브라우저를 통해 로그인하도록 요청하세요. 채팅에는 절대 API 키를 붙여넣지 마세요.
로그인 코드가 만료됨에이전트에게 로그인을 다시 시작하도록 요청하세요. 코드는 10분간 유효합니다.
플랜 또는 크레딧 문제로 생성이 거부됨생성에는 유료 플랜과 충분한 크레딧이 필요합니다. meshy.ai에서 플랜과 잔액을 확인하세요.
잘못된 Meshy 계정으로 로그인됨에이전트에게 meshy auth logout을 실행하도록 요청한 다음 다시 로그인하세요.

FAQ

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.

관련 링크