OpenClaw用Meshyスキル

OpenClawにMeshyスキルを追加して、チャットからエージェントが3Dモデル、テクスチャ、アニメーションを生成したり、3Dプリントの準備をしたりできるようにしましょう。


概要

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などのインストール済みスライサーへの受け渡し。

このスキルはnpm上のパッケージmeshy-cliであるMeshy CLIを実行します。ブラウザで一度サインインすれば、APIキーは不要です。


開始する前に

  • OpenClawが必要です。

  • OpenClawを実行するコンピューター上に、npm付きのNode.js 22.12以降が必要です。OpenClawは、meshyまたはnpmがPATH上にあるときにスキルを利用可能にします。

  • モデルを生成するには、Meshyの有料プランが必要です。各生成タスクはAPIレートでMeshyクレジットを消費します。各タスクのコストについては、料金を参照してください。プリント可能性の分析は無料で、モデルのリスケールやスライサーでの開封などのローカルプリント手順にはサインインは不要です。


スキルのインストール

ClawHubからスキルをインストールするには、次のコマンドを実行します。

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

Meshy CLIがインストールされていない場合、OpenClawのSkillsページがnpmからのインストールを提案することがあります。グローバルインストールは不要です。グローバルインストールがなくても、スキルは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

開いているセッションは、次のターンでこのスキルを認識します。セッションを開いたままNode.jsやMeshy CLIをインストールした場合は、新しいセッションを開始して、OpenClawがそれらを見つけられるようにしてください。


サインイン

初めてモデルをリクエストすると、OpenClawはMeshy CLIのサインインを開始し、リンクとワンタイムコードを送信します。

サインインするには、次の手順に従ってください。

  1. 任意のデバイスでリンクを開きます。

  2. ページでコードを求められた場合は、OpenClawが表示した通りにDevice codeにコードを入力し、Continueをクリックします。

  3. Meshyからサインインを求められた場合は、Meshyアカウントにサインインします。

  4. Connect Meshy CLIページで、Connectをクリックします。ページにMeshy CLI authorizedと表示されます。

    サインイン済みアカウント、CLIが取得するアクセス権限、CancelとConnectボタンが表示されたConnect Meshy CLIページ

  5. チャットに戻ります。OpenClawがあなたのリクエストを続行します。

コードは10分で期限切れになります。期限切れになった場合は、OpenClawに新しいコードを求めてください。サインインはどのブラウザからでも承認できるため、OpenClawがサーバーやコンテナ上で実行されている場合にも機能します。

MESHY_API_KEYは不要です。設定されている場合、CLIはブラウザセッションの代わりにそのAPIキーを使用します。


プロンプト例

作業内容を自分の言葉で説明してください。例えば次のようになります。

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

フォローアップのリクエストは前回の結果を再利用します。例えば、1,500面のLODにして、今度はFBXで、150mmにスケールしてなどです。各有料ステップを自分で承認したい場合は、リクエストにクレジットを消費する前に確認してと付け加えてください。


セキュリティとデータ

次のリストは、このスキルがコマンド、認証情報、ネットワークアクセス、ファイルをどのように扱うかをまとめたものです。

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

完全なセキュリティマニフェストについては、GitHubのmeshy-openclawを参照してください。


トラブルシューティング

次の表は、よくある問題とその原因、解決方法を示しています。

問題原因解決方法
OpenClawでスキルが利用できないmeshyもnpmもPATH上にない。npm付きのNode.js 22.12以降をインストールし、新しいセッションを開始してください。
OpenClawがAPIキーを求めてくるこのスキルにはAPIキーは不要です。ブラウザ経由でサインインします。拒否して、代わりにブラウザ経由でサインインするようOpenClawに依頼してください。チャットにAPIキーを貼り付けないでください。
サインインコードが期限切れになったコードの有効期限は10分です。OpenClawにサインインをもう一度開始するよう依頼してください。
プランやクレジットが原因でOpenClawが生成できない生成には有料プランと十分なクレジットが必要です。MeshyウェブアプリのSubscriptionページでプランと残高を確認してください。
間違ったMeshyアカウントでサインインしているMeshy CLIはコンピューターに保存されたセッションを再利用します。OpenClawにmeshy auth logoutを実行するよう依頼し、再度サインインしてください。

FAQ

OpenClaw用Meshyスキルとは何ですか?
Meshy 3D AgentはClawHub上のMeshyスキルです。これにより、OpenClawエージェントはMeshy CLIを実行して、3Dモデル、テクスチャ、リギング、アニメーションを生成し、モデルを3Dプリント用に準備できます。
OpenClawにMeshyスキルをインストールするにはどうすればよいですか?
openclaw skills install @arlieeee/meshy-3d-agentを実行してください。npm付きのNode.js 22.12以降も必要です。OpenClawのSkillsページがnpmからのMeshy CLIのインストールを提案することがあります。
Meshy APIキーは必要ですか?
いいえ。このスキルはワンタイムコードを使ってブラウザ経由でサインインし、Meshy CLIがセッションを保存します。MESHY_API_KEYは不要ですが、設定されている場合はMeshy CLIがそれを代わりに使用します。
OpenClawがサーバー上で実行されている場合でもこのスキルは機能しますか?
はい。サインイン画面にはリンクとコードが表示され、どのブラウザからでも承認できるため、OpenClawはリモートコンピューターやコンテナ上でも実行できます。
Meshyスキルは無料ですか?
スキル自体のインストールは無料です。3Dモデルの生成には有料のMeshyプランが必要で、APIレートでMeshyクレジットを消費します。プリント可能性の分析は無料です。
以前のPythonベースのMeshy OpenClawスキルを使用していました。私のタスクは引き続き機能しますか?
はい。このスキルはバージョン0.6.0でMeshy CLIに移行しましたが、古いスキルのタスクIDをCLIで引き続き使用できます。

  • Codexで同じワークフローを使用するには、Meshy plugin for Codexを参照してください。

  • Hermes Agentで同じワークフローを使用するには、Meshy skills for Hermes Agentを参照してください。

  • 自分のAPIキーを使ってAIエージェントからMeshy APIを呼び出すには、AI連携を参照してください。