meshy-openclaw

Meshy 3D — 生成とプリント

Meshy CLI 0.4.3 を使用して、ユーザーのリクエストを納品可能なアセットにします。指定された場所に指定されたファイルを保存し、プレビューがある場合は内容を確認して、プリントの場合は指定サイズ、分析・修復の結果、および求められた場合はスライサーへの引き渡しまで行います。ログインやタスクの送信だけでは完了ではありません。適切な最短のパイプラインを選び、追加の依頼では既存のアセットを再利用します。

セキュリティマニフェスト

実行可能ファイル： Meshy CLI のみです。meshy、またはバージョンを固定した一時パッケージ npm exec --yes [email protected] -- meshy を使用します。Python、curl、同梱スクリプトは使用しません。

認証情報： CLI 独自のブラウザーサインイン（OAuth デバイスフロー）により、セッションが ~/.config/meshy/credentials.json（モード 0600）に保存され、更新されます。既存の MESHY_API_KEY または明示的に指定した --api-key-file がある場合は、それが優先されます。このスキルがトークン、デバイスコード、キーを読み取ったり、表示またはコピーしたりすることはありません。また、チャットでそれらを尋ねることもありません。MESHY_API_KEY は任意です。

ネットワーク： Meshy API（api.meshy.ai）とサインインページ（www.meshy.ai）、ダウンロードするアセットのメディアホストおよび認証情報を含まない入力 URL の確認先、CLI のインストール時または一時パッケージとしての実行時に使用する npm レジストリです。

ファイル： ジョブごとに 1 つのワークスペース内、つまりユーザーが指定したディレクトリまたは ./meshy_output にのみ書き込みます。シンボリックリンク経由も含め、ワークスペース外へのパスは CLI が拒否します。ユーザーから依頼がない限り、既存ファイルを上書きしません。ユーザーが指定した入力ファイルのみを読み込みます。スライサーへの引き渡しでは、インストール済みのスライサーアプリケーションを起動します。

このマシンから送信されるデータ： プロンプト、入力画像・モデル、および Meshy に送信されるタスクリクエストです。

リクエストに必要な内容を確認する

必要な内容	リファレンス
CLI の実行、サインイン、または出力先	セットアップ
デジタルアセット：生成、テクスチャリング、リギング、アニメーション、変換、画像	パイプライン
物理プリント：ローカルでの準備、プリント生成、Creative Lab、スライサー	プリントのレシピ
コスト、待機、プレビュー、納品、以前のモデルの検索	納品
失敗した操作、または結果が不確かな操作	トラブルシューティング

必要に応じて関連するセクションを確認してください。レシピは調整して使う例であり、すべての工程を実行するものではありません。テクスチャのないモデルではテクスチャリングを省略し、既存の GLB には変換が不要です。パラメーターが不確かな場合は、コマンドの --help を使用してください。

デジタルアセットか物理プリントか

プリントを目的とするもの――プリント、スライサー、3MF、STL、Bambu／Orca／Prusa／Cura、マルチカラー、デスクトイ、物理的なフィギュアなど――は、プリント向けの生成パラメーターを適用できるよう、最初のコマンドからプリントのレシピに従います。それ以外はパイプラインに従います。

プリントのリクエスト	手順
既存の OBJ の拡大縮小、向きの変更、または接地	ローカルの mesh prepare-print。サインインや残高は不要
既存の STL または 3MF を開く	ローカルの slicer detect と slicer open。サインインや残高は不要
テキストまたは写真から白色モデルを作成	テクスチャなしで形状を生成し、必要に応じて分析・修復して、ファイルを準備
マルチカラーモデル	形状を生成・再利用し、必要に応じて分析・修復して、テクスチャリングし、multi-color-print を実行
パーツを分けてプリント（ビルドプレート、パーツごとの色、サポートの削減）	形状を生成・再利用し、自動分割して、パーツをスライス
Creative Lab のフィギュア、ビニールフィギュア、ブリックフィギュア、ランプ、キーチェーン、冷蔵庫用マグネット、キーキャップ、ピクセルフィジェットボード	プロトタイプの作成 → 確認 → 構築 → 製品アーティファクトを選択
Creative Lab の折りたたみ式フィジェット	写真から作成を 1 回実行 → STL

フィギュアだけの依頼では、Creative Lab が必要とは限りません。サイズ、色、スタイルについて尋ねるのは、指定がないことで結果が大きく変わる場合に限ります。

OpenClaw の初回利用とサインイン

Setup の説明に従ってランナーを解決します。互換性のある meshy があればそれを使い、なければバージョン固定の一時パッケージを使います。ローカルのみで完結する印刷作業はここで終了です。それ以外の作業では、検証済みの auth status セッションを再利用します。セッションがない場合に限り、サインインします。

1. exec を使って meshy auth login --device --format json --no-update-check を短い yieldMs（約 3000）と timeoutSeconds: 900 を指定して起動します。これによりバックグラウンドで実行が継続し、sessionId が返されます。
2. CLI は数秒以内に stderr に Enter code … at https://www.meshy.ai/device と出力します。最初の出力が npm の通知だけの場合は、同じ sessionId に対して process poll を実行します。URL をリンクとして、コードをそのままユーザーに送り、操作方法を伝えます。ページを開き、求められたら Meshy にサインインしてコードを入力し、承認してください。チャットで返信する必要はありません。
3. 2 回目のサインインを開始したり、セッションを強制終了したり、自分で HTTP をポーリングしたりしないでください。CLI は承認を待機します。終了すると OpenClaw がこのセッションを再開します。process poll で結果を取得してください（再開通知を受け取らないサブエージェントは、処理を返す前にポーリングします）。その後 auth status を確認し、すでに指定されている入力、パス、予算を使って元の依頼を続行します。

バックグラウンドセッションを & や nohup で切り離してはいけません。コードの期限切れや拒否が発生した場合は、同じサインインをもう一度実行します。それを理由に、有料タスクを再実行してはいけません。長時間の wait コマンドも同様です。exec でバックグラウンド実行し、完了通知を受けて再開してください。再送したり、sleep を繰り返したりしないでください。

実行上の境界

• API、アップロード、ダウンロード、メッシュ操作は CLI 経由で実行します。ローカル入力は 50 MiB が上限で、ローカルモデルは GLB または glTF 形式である必要があります（リギングとマルチカラーには GLB を使用）。それ以外は、サポートされている URL 入力経路を使ってください。
• 業務コマンドには --output-schema v1 --format json --no-update-check を指定します。認証には専用の JSON 形式があります。ユーザーの出力パスから WORKSPACE を解決し、すべての書き込みに渡します。
• create --async で一度だけ送信し、対応するリソースとタスク ID を保持してから、そのタスクを wait します。タイムアウトや送信結果が不明な場合は Troubleshooting の手順に従ってください。いずれの場合も、有料の create を再度実行してはいけません。
• 承認された範囲と予算内で作業します。追加の有料工程や再実行を行う場合は、費用を使う前に提案してください。ローカルでの準備と印刷適性の分析は無料です。見積もりは Delivery が担当します。
• 修復ではジオメトリが変更され、テクスチャが削除されます。後続処理には修復後のジオメトリを使い、マルチカラー出力の前に再テクスチャリングしてください。Y-up の OBJ を新しいファイルとして一度だけ準備します。この変換を STL、3MF、またはレリーフ製品の出力に適用してはいけません。

納品

必要なアセットだけをダウンロードします。表示可能なレンダリング済みプレビューがあれば、画像としてユーザーに送ります。プレビューがない場合は、その旨を明記し、あるかのように示してはいけません。レンダリング済み PNG は 3D ビューアーではありません。ファイルパス、後続作業用のタスク ID、実際の請求額を報告します。印刷の場合は、寸法と分析・修復の状態も報告します。ユーザーから依頼があった場合に限り、検出されたスライサーを起動してください。launch_requested はモデルがインポートされたことを示すものではない点も伝えます。サポート材や壁厚など、未確認のモデルを印刷可能と保証することなく、関連する残りの確認事項にも触れてください。