Навичка Meshy для OpenClaw

Офіційна навичка Meshy для OpenClaw дозволяє вашому агенту генерувати 3D-моделі, текстури та анімації, а також готувати файли для 3D-друку — усе прямо з чату.

Огляд

Meshy тепер доступний на ClawHub як Meshy 3D Agent — одна навичка, що охоплює:

  • 3D-генерацію: текст у 3D, зображення у 3D та мультивид у 3D, AI-текстурування та перетекстурування, remesh до заданого бюджету полігонів, розгортку UV, авто-rigging та анімацію для гуманоїдних персонажів, а також експорт у GLB, FBX, OBJ, STL або USDZ.
  • 3D-друк: аналіз та виправлення придатності до друку, одноколірний та багатоколірний 3MF, масштабування до реальних розмірів, продукти Creative Lab (фігурки, лампи, брелоки, магніти на холодильник) та передачу даних у встановлений слайсер, наприклад Bambu Studio, OrcaSlicer або Creality Print.

Навичка керує Meshy CLI. Ви входите один раз у браузері; API-ключ не потрібен.

Вимоги

  • OpenClaw.
  • Node.js 22.12 або новіший, з npm, на машині, де працює OpenClaw. Навичка стає доступною, коли meshy або npm є в PATH.
  • Платний план Meshy для генерації. Кожне завдання генерації витрачає кредити Meshy за тарифами API. Аналіз придатності до друку безкоштовний, а локальні кроки друку, такі як зміна масштабу моделі або відкриття її в слайсері, не потребують входу в обліковий запис.

Встановлення

Встановіть навичку з ClawHub:

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

OpenClaw пропонує встановити Meshy CLI з npm, якщо він ще не встановлений. Глобальне встановлення лише пришвидшує запуск; без нього навичка запускає CLI через npm exec.

Ви також можете доручити агенту все налаштування. Вставте це в 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. Агент продовжує виконувати ваш запит.

Сторінка підключення Meshy CLI

Код діє 10 хвилин; попросіть агента надати новий, якщо термін дії минув. Оскільки процес входу через пристрій працює з будь-якого браузера, це також працює, коли OpenClaw запущено на сервері або в контейнері. MESHY_API_KEY є необов'язковим: якщо його встановлено, він має пріоритет над сесією браузера.

Приклади запитів

  • Створи 3D-модель цуценяти хаскі та збережи її як GLB у ./assets.
  • Перетвори це фото на текстуровану 3D-модель, зберігши пропорції. (додайте зображення)
  • Зроби rig для цього гуманоїдного персонажа, додай анімацію бігу та експортуй у FBX.
  • Допоможи мені надрукувати на 3D-принтері маленьку фігурку дракона, 80 мм заввишки, і відкрий її в Bambu Studio.
  • Перетвори цей логотип на брелок, який можна надрукувати на 3D-принтері.

Наступні запити використовують попередній результат: зроби LOD на 1500 граней, тепер у FBX, масштабуй до 150 мм. Додайте запитай мене перед витратою кредитів, щоб підтверджувати кожен платний крок.

Безпека та дані

  • Що виконується: лише Meshy CLI, як meshy або закріплений пакет через npm exec. Навичка складається лише з Markdown, без Python, curl чи вбудованих скриптів.
  • Облікові дані: CLI зберігає та оновлює сесію в ~/.config/meshy/credentials.json з правами доступу 0600. Навичка ніколи не читає, не виводить і не копіює токен, код пристрою чи ключ, і ніколи не запитує їх у чаті.
  • Мережа: запити, зображення та завдання надсилаються до Meshy API (зазвичай api.meshy.ai). З npm встановлюється тимчасове з'єднання під час встановлення або запуску CLI.
  • Файли: кожне завдання записує дані в одну папку: ту, яку ви вказали, або ./meshy_output. Шляхи за її межами відхиляються, а наявні файли не перезаписуються, якщо ви не попросите про це.

Повний маніфест безпеки доступний у джерельному коді навички.

Усунення несправностей

СимптомВирішення
Навичка недоступнаВстановіть Node.js 22.12 або новіший з npm, або встановіть CLI командою npm install -g meshy-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.

Пов'язані посилання