OpenClaw向けMeshyスキル

OpenClaw向けの公式Meshyスキルを使えば、あなたのエージェントがチャットだけで3Dモデル、テクスチャ、アニメーションを生成し、3Dプリントの準備を行うことができます。


Overview

Meshyは現在、ClawHub上でMeshy 3D Agentとして提供されており、1つのスキルで以下をカバーしています。

  • 3D生成: テキストから3D、画像から3D、マルチビューから3D、AIテクスチャリングおよびリテクスチャリング、ポリゴン数の予算に合わせたリメッシュ、UV展開、ヒューマノイドキャラクター向けの自動リギングとアニメーション、そしてGLB、FBX、OBJ、STL、USDZへのエクスポート。
  • 3Dプリント: プリント可能性の解析と修復、単色および多色3MF、実寸サイズへのスケーリング、Creative Lab製品(フィギュア、ランプ、キーホルダー、冷蔵庫用マグネット)、そしてBambu Studio、OrcaSlicer、Creality Printなどインストール済みのスライサーへの引き渡し。

このスキルはMeshy CLIを操作します。ブラウザで一度サインインすれば、APIキーは不要です。


Requirements

  • OpenClaw。
  • OpenClawが動作するマシン上に、npmを含むNode.js 22.12以降。meshyまたはnpmがPATH上にあると、このスキルが有効になります。
  • 生成には有料のMeshyプランが必要です。生成タスクを実行するたびにAPIレートに基づいてMeshyクレジットが消費されます。プリント可能性の解析は無料で、モデルの再スケーリングやスライサーでの表示などローカルでのプリント作業にはサインインは不要です。

Installation

ClawHubからスキルをインストールします。

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

OpenClawは、まだインストールされていない場合、npmからMeshy CLIをインストールするよう提案します。グローバルインストールは起動を速くするだけのもので、インストールしなくても、スキルは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

エージェントが起動時にのみスキルを読み込む場合は、インストール後に新しいセッションを開始してください。


Sign In

モデルを初めて依頼すると、エージェントはMeshy CLIのデバイスサインインを実行し、リンクとワンタイムコードを送ってきます。

  1. 任意のデバイスでそのリンクを開き、Meshyにログインします。
  2. 表示された通りにコードを入力し、Connectをクリックします。
  3. エージェントがあなたのリクエストの処理を続行します。

Connect Meshy CLI page

コードは10分で期限切れになります。期限切れの場合は、エージェントに新しいコードを依頼してください。デバイスフローはどのブラウザからでも動作するため、OpenClawがサーバーやコンテナ上で動いている場合でも利用できます。MESHY_API_KEYは任意設定です。設定されている場合は、ブラウザセッションより優先されます。


Example Prompts

  • 赤ちゃんハスキー犬の3Dモデルを作って、./assetsにGLBとして保存して。
  • この写真をテクスチャ付きの3Dモデルに変換して、プロポーションはそのまま維持して。(画像を添付)
  • このヒューマノイドキャラクターにリグを付けて、ランニングアニメーションを追加し、FBXでエクスポートして。
  • 小さなドラゴンのフィギュアを高さ80mmで3Dプリントしたいので手伝って。それをBambu Studioで開いて。
  • このロゴを3Dプリントできるキーホルダーにして。

フォローアップでは前回の結果を再利用します。例:1,500面のLODにして、今度はFBXで、150mmにスケーリングして。各有料ステップを承認してほしい場合はクレジットを使う前に確認してと付け加えてください。


Security and Data

  • 実行されるもの: Meshy CLIのみ、meshyとして、またはnpm exec経由でピン留めされたパッケージとして実行されます。このスキルはMarkdownのみで構成されており、Python、curl、同梱スクリプトは含まれません。
  • 認証情報: CLIはセッションを~/.config/meshy/credentials.jsonにモード0600で保存・更新します。スキルはトークン、デバイスコード、キーを読み取ったり、出力したり、コピーしたりすることは一切なく、チャット上でそれらを尋ねることもありません。
  • ネットワーク: プロンプト、画像、タスクリクエストはMeshy API(通常はapi.meshy.ai)に送信されます。npmには、CLIのインストール時や一時的な実行時に接続されます。
  • ファイル: 各ジョブは1つのフォルダ内にのみ書き込みます。指定したフォルダ、または./meshy_outputです。それ以外のパスへの書き込みは拒否され、既存のファイルは指示がない限り上書きされません。

完全なセキュリティマニフェストはスキルのソースにあります。


Troubleshooting

症状対処法
スキルが有効にならないNode.js 22.12以降をnpm付きでインストールするか、npm install -g meshy-cliで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.