OpenClaw용 Meshy 스킬이란 무엇인가요?

Meshy 3D Agent는 ClawHub에 있는 Meshy 스킬입니다. Meshy CLI를 실행하여 OpenClaw 에이전트가 3D 모델, 텍스처, 리깅, 애니메이션을 생성하고 3D 프린팅용 모델을 준비할 수 있게 해줍니다.

OpenClaw에 Meshy 스킬을 어떻게 설치하나요?

openclaw skills install @arlieeee/meshy-3d-agent를 실행하세요. Node.js 22.12 이상과 npm도 필요합니다. OpenClaw의 Skills 페이지에서 npm을 통해 Meshy CLI 설치를 제안할 수 있습니다.

Meshy API 키가 필요한가요?

아니요. 이 스킬은 일회용 코드로 브라우저를 통해 로그인하며, Meshy CLI가 세션을 저장합니다. MESHY_API_KEY는 필요하지 않지만, 설정되어 있는 경우 Meshy CLI가 이를 대신 사용합니다.

OpenClaw가 서버에서 실행될 때도 스킬이 동작하나요?

네. 로그인 화면에는 어떤 브라우저에서든 승인할 수 있는 링크와 코드가 표시되므로, OpenClaw가 원격 컴퓨터나 컨테이너에서 실행될 때도 동작합니다.

Meshy 스킬은 무료인가요?

스킬 설치는 무료입니다. 3D 모델 생성에는 유료 Meshy 플랜이 필요하며 API 요금에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료입니다.

이전 Python 기반 Meshy OpenClaw 스킬을 사용했습니다. 제 작업이 계속 동작하나요?

네. 이 스킬은 버전 0.6.0에서 Meshy CLI로 전환되었으며, 이전 스킬의 작업 ID를 CLI에서도 계속 사용할 수 있습니다.

OpenClaw용 Meshy 스킬

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

개요

Meshy 스킬은 ClawHub에서 Meshy 3D Agent라는 이름으로 제공됩니다. 이 하나의 스킬이 두 가지 워크플로를 모두 다룹니다:

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

이 스킬은 npm의 meshy-cli 패키지인 Meshy CLI를 실행합니다. 브라우저에서 한 번 로그인하면 되며, API 키는 필요하지 않습니다.

시작하기 전에

OpenClaw가 필요합니다.
OpenClaw를 실행하는 컴퓨터에 Node.js 22.12 이상과 npm이 필요합니다. OpenClaw는 meshy 또는 npm이 PATH에 있을 때 이 스킬을 사용할 수 있게 합니다.
모델을 생성하려면 유료 Meshy 플랜이 필요합니다. 모든 생성 작업은 API 요금에 따라 Meshy 크레딧을 소비합니다. 각 작업의 비용은 요금을 참고하세요. 프린팅 가능성 분석은 무료이며, 모델 크기 재조정이나 슬라이서에서 열기 같은 로컬 프린팅 단계는 로그인이 필요하지 않습니다.

스킬 설치

ClawHub에서 스킬을 설치하려면 다음 명령어를 실행하세요:

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

Meshy CLI가 설치되어 있지 않으면 OpenClaw의 Skills 페이지에서 npm을 통해 설치할 것을 제안할 수 있습니다. 전역 설치는 필요하지 않습니다. 전역 설치가 없으면 스킬은 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

열려 있는 세션은 다음 턴에서 스킬을 인식합니다. 세션이 열려 있는 동안 Node.js나 Meshy CLI를 설치했다면, OpenClaw가 이를 찾을 수 있도록 새 세션을 시작하세요.

처음 모델을 요청하면 OpenClaw가 Meshy CLI 로그인을 시작하고 링크와 일회용 코드를 보내줍니다.

로그인하려면 다음 단계를 따르세요:

어떤 기기에서든 링크를 엽니다.
페이지에서 코드를 요구하면, OpenClaw가 표시한 코드를 Device code에 정확히 입력한 다음 Continue를 클릭합니다.
Meshy가 로그인을 요청하면 Meshy 계정으로 로그인합니다.
Connect Meshy CLI 페이지에서 Connect를 클릭합니다. 페이지에 Meshy CLI authorized가 표시됩니다.
채팅으로 돌아갑니다. OpenClaw가 요청하신 작업을 이어서 진행합니다.

코드는 10분 후 만료됩니다. 만료되면 OpenClaw에게 새 코드를 요청하세요. 로그인은 어떤 브라우저에서든 승인할 수 있으므로, OpenClaw가 서버나 컨테이너에서 실행되는 경우에도 동작합니다.

MESHY_API_KEY는 필요하지 않습니다. 설정되어 있는 경우, CLI는 브라우저 세션 대신 해당 API 키를 사용합니다.

예시 프롬프트

작업 내용을 자신의 말로 설명하세요. 예를 들면:

Make a 3D model of a baby husky and save it as GLB in ./assets.
Turn this photo into a textured 3D model and keep its proportions. (이미지 첨부)
Rig this humanoid character, add a running animation, and export it as FBX.
Help me 3D print a small dragon figurine, 80 mm tall, and open it in Bambu Studio.
Turn this logo into a keychain I can 3D print.

후속 요청은 이전 결과를 재사용합니다. 예를 들어 make a 1,500-face LOD, now as FBX, scale it to 150 mm 등입니다. 각 유료 단계를 직접 승인하려면 요청에 ask me before spending credits를 추가하세요.

보안 및 데이터

다음 목록은 이 스킬이 명령어, 자격 증명, 네트워크 접근, 파일을 어떻게 처리하는지 요약합니다:

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

전체 보안 매니페스트는 GitHub의 meshy-openclaw를 참고하세요.

문제 해결

다음 표는 흔한 문제와 원인, 해결 방법을 정리한 것입니다.

문제	원인	해결 방법
OpenClaw에서 스킬을 사용할 수 없음	`meshy`와 `npm` 모두 `PATH`에 없습니다.	Node.js 22.12 이상을 npm과 함께 설치한 다음 새 세션을 시작하세요.
OpenClaw가 API 키를 요청함	이 스킬은 API 키가 필요하지 않습니다. 브라우저를 통해 로그인합니다.	요청을 거부하고 OpenClaw에게 대신 브라우저를 통해 로그인하도록 요청하세요. 채팅에는 절대 API 키를 붙여넣지 마세요.
로그인 코드가 만료됨	코드는 10분간 유효합니다.	OpenClaw에게 로그인을 다시 시작하도록 요청하세요.
플랜이나 크레딧 문제로 OpenClaw가 생성할 수 없음	생성에는 유료 플랜과 충분한 크레딧이 필요합니다.	Meshy 웹 앱의 Subscription 페이지에서 플랜과 잔액을 확인하세요.
잘못된 Meshy 계정으로 로그인됨	Meshy CLI는 컴퓨터에 저장된 세션을 재사용합니다.	OpenClaw에게 `meshy auth logout`을 실행하도록 요청한 다음 다시 로그인하세요.

FAQ

OpenClaw용 Meshy 스킬이란 무엇인가요?: Meshy 3D Agent는 ClawHub에 있는 Meshy 스킬입니다. Meshy CLI를 실행하여 OpenClaw 에이전트가 3D 모델, 텍스처, 리깅, 애니메이션을 생성하고 3D 프린팅용 모델을 준비할 수 있게 해줍니다.
OpenClaw에 Meshy 스킬을 어떻게 설치하나요?: openclaw skills install @arlieeee/meshy-3d-agent를 실행하세요. Node.js 22.12 이상과 npm도 필요합니다. OpenClaw의 Skills 페이지에서 npm을 통해 Meshy CLI 설치를 제안할 수 있습니다.
Meshy API 키가 필요한가요?: 아니요. 이 스킬은 일회용 코드로 브라우저를 통해 로그인하며, Meshy CLI가 세션을 저장합니다. MESHY_API_KEY는 필요하지 않지만, 설정되어 있는 경우 Meshy CLI가 이를 대신 사용합니다.
OpenClaw가 서버에서 실행될 때도 스킬이 동작하나요?: 네. 로그인 화면에는 어떤 브라우저에서든 승인할 수 있는 링크와 코드가 표시되므로, OpenClaw가 원격 컴퓨터나 컨테이너에서 실행될 때도 동작합니다.
Meshy 스킬은 무료인가요?: 스킬 설치는 무료입니다. 3D 모델 생성에는 유료 Meshy 플랜이 필요하며 API 요금에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료입니다.
이전 Python 기반 Meshy OpenClaw 스킬을 사용했습니다. 제 작업이 계속 동작하나요?: 네. 이 스킬은 버전 0.6.0에서 Meshy CLI로 전환되었으며, 이전 스킬의 작업 ID를 CLI에서도 계속 사용할 수 있습니다.

Codex에서 동일한 워크플로를 사용하려면 Codex용 Meshy 플러그인을 참고하세요.
Hermes Agent에서 동일한 워크플로를 사용하려면 Hermes Agent용 Meshy 스킬을 참고하세요.
직접 API 키를 사용해 AI 에이전트에서 Meshy API를 호출하려면 AI 연동을 참고하세요.