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

Додайте навичку Meshy до OpenClaw, щоб ваш агент міг генерувати 3D-моделі, текстури й анімації та готувати 3D-друк просто з чату.


Огляд

Навичка Meshy доступна на ClawHub як Meshy 3D Agent. Ця одна навичка охоплює обидва робочі процеси:

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

Навичка запускає Meshy CLI — пакет meshy-cli з npm. Ви входите один раз у браузері, і вам не потрібен API-ключ.


Перш ніж почати

  • Вам потрібен OpenClaw.

  • Вам потрібен Node.js 22.12 або новіший, з npm, на комп'ютері, на якому працює OpenClaw. OpenClaw робить навичку доступною, коли meshy або npm є в PATH.

  • Щоб генерувати моделі, вам потрібен платний план Meshy. Кожне завдання генерації витрачає кредити Meshy за тарифами API. Вартість кожного завдання див. у розділі Ціни. Аналіз придатності до друку безкоштовний, а локальні кроки друку, такі як зміна масштабу моделі або відкриття її в слайсері, не потребують входу.


Встановлення навички

Щоб встановити навичку з ClawHub, виконайте таку команду:

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

Якщо Meshy CLI не встановлено, сторінка Skills в OpenClaw може запропонувати встановити його з 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

Відкрита сесія підхопить навичку на наступному кроці. Якщо ви встановили Node.js або Meshy CLI, поки сесія була відкрита, почніть нову сесію, щоб OpenClaw їх знайшов.


Вхід

Коли ви вперше запитаєте модель, OpenClaw запускає вхід через Meshy CLI та надсилає вам посилання й одноразовий код.

Щоб увійти, виконайте такі кроки:

  1. Відкрийте посилання на будь-якому пристрої.

  2. Якщо сторінка запитує код, введіть код у поле Device code точно так, як показує OpenClaw, а потім натисніть Continue.

  3. Якщо Meshy просить вас увійти, увійдіть у свій обліковий запис Meshy.

  4. На сторінці Connect Meshy CLI натисніть Connect. Сторінка покаже Meshy CLI authorized.

    Сторінка Connect Meshy CLI з обліковим записом, у якому виконано вхід, доступом, який отримує CLI, та кнопками Cancel і Connect

  5. Поверніться в чат. OpenClaw продовжить виконання вашого запиту.

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

Вам не потрібен MESHY_API_KEY. Якщо його встановлено, CLI використовує цей API-ключ замість сесії браузера.


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

Опишіть завдання своїми словами. Наприклад:

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

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


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

Нижче підсумовано, як навичка обробляє команди, облікові дані, мережевий доступ і файли:

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

Повний маніфест безпеки див. у meshy-openclaw на GitHub.


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

У наведеній нижче таблиці перелічено поширені проблеми, їхні причини та способи усунення.

ПроблемаПричинаВиправлення
Навичка недоступна в OpenClawНі meshy, ні npm немає в PATH.Встановіть Node.js 22.12 або новіший з npm, а потім почніть нову сесію.
OpenClaw запитує API-ключНавичка не потребує ключа. Вона входить через ваш браузер.Відмовтеся та попросіть OpenClaw увійти через браузер замість цього. Ніколи не вставляйте API-ключ у чат.
Код входу закінчивсяКод дійсний 10 хвилин.Попросіть OpenClaw знову почати вхід.
OpenClaw не може генерувати через ваш план або кредитиДля генерації потрібен платний план і достатньо кредитів.Перевірте свій план і баланс на сторінці Subscription у веб-застосунку Meshy.
Ви увійшли не в той обліковий запис MeshyMeshy CLI повторно використовує сесію, збережену на вашому комп'ютері.Попросіть OpenClaw виконати meshy auth logout, а потім увійти знову.

Поширені запитання

Що таке навичка Meshy для OpenClaw?
Meshy 3D Agent — це навичка Meshy на ClawHub. Вона дозволяє агенту OpenClaw генерувати 3D-моделі, текстури, ріггінг та анімацію, а також готувати моделі до 3D-друку, запускаючи Meshy CLI.
Як встановити навичку Meshy в OpenClaw?
Виконайте openclaw skills install @arlieeee/meshy-3d-agent. Вам також потрібен Node.js 22.12 або новіший з npm. Сторінка Skills в OpenClaw може запропонувати встановити Meshy CLI з npm.
Чи потрібен мені API-ключ Meshy?
Ні. Навичка входить через ваш браузер за допомогою одноразового коду, а Meshy CLI зберігає сесію. Вам не потрібен MESHY_API_KEY, але якщо він встановлений, Meshy CLI використовує його замість цього.
Чи працює навичка, коли OpenClaw працює на сервері?
Так. Під час входу показується посилання та код, які можна підтвердити з будь-якого браузера, тож OpenClaw може працювати на віддаленому комп'ютері або в контейнері.
Чи безкоштовна навичка Meshy?
Встановлення навички безкоштовне. Генерація 3D-моделей вимагає платного плану Meshy та витрачає кредити Meshy за тарифами API. Аналіз придатності до друку безкоштовний.
Я користувався старішою навичкою Meshy OpenClaw на основі Python. Чи працюють мої завдання й досі?
Так. Навичка перейшла на Meshy CLI у версії 0.6.0, і ви все ще можете використовувати ідентифікатори завдань зі старої навички разом із CLI.