Meshy 3D — 生成 + プリント
Meshy CLI 0.8（0.8.5以降）を使用して、ユーザーのリクエストを成果物に変換します。要求されたファイルを指定された場所に配置し、プレビューが存在する場合はそれを検査し、プリントの場合は意図したサイズ、解析/修復結果、および要求に応じてスライサーへの引き渡しを行います。ログインまたはタスク送信だけでは完了とは見なされません。最も短い適切なパイプラインを選択し、フォローアップでは既存のアセットを再利用します。
セキュリティマニフェスト
実行可能ファイル: Meshy CLI — meshy、または固定された一時パッケージ npm exec --yes [email protected] -- meshy — に加え、インストール用の npm、ランタイム確認用の node --version。Python、curl、バンドルスクリプトは使用しません。
認証情報: CLI自身のブラウザサインイン（OAuthデバイスフロー）は、~/.config/meshy/credentials.v2.json（モード0600）に暗号化されたセッションを保存および更新し、そのキーはOSが管理します。既存の MESHY_API_KEY、または明示的な --api-key-file が指定されている場合はそれが優先されます。このスキルはトークン、デバイスコード、キーを決して読み取らず、出力もコピーもせず、チャットで要求することもありません。MESHY_API_KEY はオプションです。
ネットワーク: Meshy API（api.meshy.ai）とそのサインインページ（www.meshy.ai）、または中国サイトの場合は api.meshy.cn と meshy.cn。ダウンロードされるアセットのメディアホスト、またはチェックされる入力URL（認証情報は含みません）。CLIがインストールされるか一時パッケージとして実行される場合のnpmレジストリ。
ファイル: ジョブごとに1つのワークスペース（ユーザーが指定したディレクトリ、または ./meshy_output）内にのみ書き込み、CLIはシンボリックリンクを含むエスケープを拒否します。既存のファイルは、ユーザーが要求した場合を除き上書きされません。ユーザーが指定した入力ファイルと、ワークスペース内の自身の出力（プレビュー、サイドカー）を読み取ります。スライサー連携は、すでにインストールされているスライサーアプリケーションを起動します。
このマシンから送信されるデータ: Meshyに送信されるプロンプト、入力画像/モデル、およびタスクリクエスト。
このリクエストに必要なものを読む
| 必要なもの | 参照先 |
|---|---|
| CLIの実行、サインイン、または出力場所 | セットアップ |
| デジタルアセット：生成とプロジェクトでペアリングするモデル、テクスチャリング、リメッシング、変換、画像 | パイプライン |
| リギング、アニメーション、または生成されたモーション | アニメーション |
| 物理プリント：ローカル準備、プリント生成、解析/修復、スライサー | プリントレシピ |
| Creative Lab製品（フィギュア、ランプ、キーチェーン、マグネット、キーキャップ、フィジェット） | Creative Lab |
| コスト、待機、プレビュー、配信、または以前のモデルの検索 | 配信 |
| 失敗した、または不確かな操作 | トラブルシューティング |
必要に応じて関連セクションを読んでください。レシピは適応するための例であり、すべてを実行する段階ではありません。テクスチャのないモデルはテクスチャリングをスキップします。既存のGLBは変換を必要としません。パラメータが不明な場合は、コマンド --help を使用してください。
デジタルアセットまたは物理プリント
プリントを意図したもの（プリント、スライサー、3MF、STL、Bambu/Orca/Prusa/Cura、マルチカラー、デスクのおもちゃ、物理フィギュア）は、最初のコマンドから プリントレシピ に従い、生成パラメータがプリントに適合するようにします。それ以外はすべて パイプライン に従います。
| プリントリクエスト | ルート |
|---|---|
| 既存のOBJのスケーリング、向き調整、または地面への配置 | ローカル mesh prepare-print。サインインや残高は不要 |
| 既存のSTLまたは3MFを開く | ローカル slicer detect および slicer open。サインインや残高は不要 |
| 写真、スケッチ、またはテキストからの白モデル | 写真：image-to-3d。それ以外は、まず参照画像を推奨（奥行きや側面が重要な場合はマルチビュー）、text-to-3dはより迅速な代替手段として。ジオメトリのみ（テクスチャなし）。必要に応じて解析/修復。ファイルを準備 |
| マルチカラーモデル | ジオメトリを生成/再利用。必要に応じて解析/修復。テクスチャリング。マルチカラープリント |
| 別々の部品でプリント（ビルドプレート、部品ごとの色、サポート削減） | ジオメトリを生成/再利用。自動分割。部品をスライス |
| 既存モデルの確認または修正（穴、薄い壁）、任意の形式 | タスクIDまたは --model-url による無料の印刷性解析。必要な場合のみ修復 |
| 既存のSTL、3MF、GLBのサイズ変更 | スライサーでスケーリング。ローカルでサイズ変更するのはOBJのみ |
| Creative Labフィギュア（写真からスタイライズドコレクタブル）、ビニールフィギュア、ブリックフィギュア、ランプ、キーチェーン、冷蔵庫マグネット、キーキャップ、またはピクセルフィジェットボード | プロトタイプ → レビュー → ビルド → 製品アーティファクトを選択 |
| Creative Lab折りたたみフィジェット | 写真から1回の作成 → STL |
カラールートは異なります：マルチカラーは1つのオブジェクトの表面をマルチマテリアルプリンター用にペイントします。分割はそれを部品に切り分け、各フィラメントごとに1つの部品とし、テクスチャを削除します（分割は修復の前に行います。この2つは連鎖しません）。ピクセルフィジェットボードは独自の製品です。
フィギュア単体ではCreative Labを意味しません。サイズ、色、スタイルについての質問は、選択肢が結果を実質的に変える場合にのみ行ってください。
OpenClawでの初回使用とサインイン
最初のコマンドの前に meshy --version を実行してください。尋ねる必要はありません。meshy がない場合、またはバージョンが0.8.5より古い場合は、npm install -g [email protected] で最新の0.8.xをインストールし、その旨を1行で伝えてください。セットアップでは、インストールが拒否された場合とCLIが0.9以降の場合について説明しています。ローカルのみのプリント作業はそこで停止します。それ以外の場合は、確認済みの auth status セッションを再利用します。セッションがない場合のみ、サインインを行います。
meshy auth login --device --format json --no-update-checkを開始します（中国本土のユーザーの場合は--region cnを追加：同じアカウントとクレジットがグローバルサイトとして使用されます）。execと短いyieldMs（約3000）、timeoutSeconds: 900を使用して、バックグラウンドで実行を継続させ、sessionIdを返します。- CLIは数秒以内にstderrに
Enter code … at https://www.meshy.ai/deviceを出力します。最初の出力にnpm通知のみが含まれる場合は、同じsessionIdでprocess pollを実行します。ユーザーにURLをリンクとして、コードをそのまま、そして何をすべきか（開く、Meshyへのサインインを求められたらサインイン、コードを入力、承認）を送信します。チャットに返信を送り返す必要はありません。 - 2回目のログインを開始したり、セッションを強制終了したり、HTTPを自分でポーリングしたりしないでください。CLIは承認を待機します。CLIが終了すると、OpenClawがこのセッションを起動します。
process pollで結果を収集します（サブエージェントは、起動を受け取らないため、yieldの前にポーリングします）。その後、auth statusを確認し、すでに提供された入力、パス、予算を使用して元のリクエストを続行します。
バックグラウンドセッションは & や nohup でデタッチしてはいけません。期限切れまたは拒否されたコードは、同じログインを再度実行することを意味します。有料タスクを再実行する正当な理由にはなりません。長時間の wait コマンドも同様に動作します。exec でバックグラウンド実行し、完了の起動から再開するようにします。再送信や sleep のループは避けてください。
CLIのみが設定ディレクトリに触れます。サンドボックスによってログインがブロックされた場合は、セットアップのセクション3に従ってください。
実行の境界
- API、アップロード、ダウンロード、メッシュ操作はすべてCLIを通じて実行します。ローカル入力は50 MiBの制限があり、ローカルモデルはGLBまたはglTFである必要があります（リギング、UVアンラップ、マルチカラーはGLB）。その他の場合は、サポートされているURL入力ルートを使用します。
- すべてのコマンドは
--format json --no-update-checkを使用し、1つのmeshy.cli/v1エンベロープ（認証情報を含む）を出力します。ユーザーの出力パスからWORKSPACEを解決し、すべての書き込みに渡します。 - 最初の有料作成の前に、モデルの用途を把握してください：ゲームアセット、リギングするキャラクター、レンダリング、3Dプリント。ユーザーが明言していない場合は、一度尋ねてください。その答えがルートとモデルを決定します（パイプライン）。ゲームアセットまたはポリゴン数予算がある場合は、標準モデルをリメッシュダウンするのではなく、スマートトポロジーを使用します。
create --asyncで1回だけ送信し、所有するリソースとタスクIDを保持し、そのタスクでwaitします。タイムアウトと不明な送信はトラブルシューティングに従います。これらが別の有料作成を許可することは決してありません。- 使用可能な写真がない場合は、最初に参照画像を作成し、そこからモデルを構築することを推奨します。text-to-3dはより迅速な代替手段です（パイプライン、画像から開始、プリント：プリントレシピ、セクション1）。
- 承認された範囲と予算内で作業します。支出前に追加の有料ステージや再実行を提案します。ローカル準備と印刷性解析は無料です。配信は見積もりをカバーします。
- 修復はジオメトリを変更し、テクスチャを削除します。修復されたジオメトリをダウンストリームで使用し、マルチカラー出力の前に再テクスチャリングします。Y-upのOBJを新しいファイルとして一度だけ準備します。その変換をSTL、3MF、またはレリーフ製品出力に適用しないでください。
配信
必要なアセットのみをダウンロードします。利用可能なレンダリングプレビューを画像としてユーザーに送信します。プレビューがない場合は明示的に述べ、暗示してはなりません。レンダリングされたPNGは3Dビューアではありません。ファイルパス、フォローアップ用のタスクID、および実際の請求額を報告します。プリントの場合は、寸法と解析/修復ステータスも報告します。要求された場合のみ、検出されたスライサーを起動し、launch_requested はモデルがインポートされたことを証明しないことに注意してください。サポートや壁の厚さなど、関連する残りのチェックについて言及しますが、テストされていないモデルを印刷可能と保証することは避けてください。