Скилл Meshy для OpenClaw
Добавьте скилл Meshy в OpenClaw, чтобы ваш агент мог создавать 3D-модели, текстуры и анимации, а также готовить модели к 3D-печати прямо из чата.
Обзор
Скилл Meshy размещён на ClawHub как Meshy 3D Agent. Этот единственный скилл охватывает оба рабочих процесса:
- 3D-генерация: Текст в 3D, Изображение в 3D и Мульти-изображение в 3D, ИИ-текстурирование и ретекстурирование, remesh с учётом бюджета полигонов, UV-развёртка, авто-rigging и анимация для гуманоидных персонажей, а также экспорт в 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 и присылает вам ссылку и одноразовый код.
Чтобы войти в систему, выполните следующие шаги:
-
Откройте ссылку на любом устройстве.
-
Если страница запрашивает код, введите код в поле Device code точно так, как его показывает OpenClaw, а затем нажмите Continue.
-
Если Meshy предлагает войти в систему, войдите в свою учётную запись Meshy.
-
На странице Connect Meshy CLI нажмите Connect. Страница покажет Meshy CLI authorized.

-
Вернитесь в чат. OpenClaw продолжит выполнение вашего запроса.
Код действителен 10 минут. Если он истёк, попросите OpenClaw выдать новый. Подтвердить вход можно из любого браузера, поэтому это также работает, когда OpenClaw запущен на сервере или в контейнере.
Переменная MESHY_API_KEY вам не нужна. Если она задана, CLI использует этот API-ключ вместо сеанса браузера.
Примеры запросов
Опишите задачу своими словами. Например:
- Сделай 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. Скилл никогда не читает, не выводит и не копирует токен, device code или ключ, и никогда не запрашивает их в чате. - Сеть: 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. |
| Вход выполнен не под той учётной записью Meshy | Meshy CLI повторно использует сеанс, сохранённый на вашем компьютере. | Попросите OpenClaw выполнить meshy auth logout, а затем войдите заново. |
FAQ
- Что такое скилл Meshy для OpenClaw?
- Meshy 3D Agent — это скилл Meshy на ClawHub. Он позволяет агенту OpenClaw создавать 3D-модели, текстуры, rigging и анимацию, а также готовить модели к 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. Будут ли мои задачи по-прежнему работать?
- Да. В версии 0.6.0 скилл перешёл на Meshy CLI, и вы по-прежнему можете использовать идентификаторы задач из старого скилла с CLI.
Дальнейшие шаги
-
Чтобы использовать те же рабочие процессы в Codex, см. Плагин Meshy для Codex.
-
Чтобы использовать те же рабочие процессы в Hermes Agent, см. Скиллы Meshy для Hermes Agent.
-
Чтобы вызывать Meshy API из ИИ-агента с собственным API-ключом, см. Интеграция с ИИ.