Навык 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-модель и сохрани её пропорции. (прикрепить изображение)
  • Сделай rigging этого гуманоидного персонажа, добавь анимацию бега и экспортируй его в 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.

Связанные ссылки