OpenClaw 版 Meshy 技能
Meshy 官方 OpenClaw 技能，讓你的智能代理在對話中生成 3D 模型、材質和動畫，並準備 3D 列印檔案。
概述
Meshy 現已上架 ClawHub，名為 Meshy 3D Agent，一個技能涵蓋：
- 3D 生成：文字生成 3D、圖片生成 3D 和多視圖生成 3D，AI 材質生成與重新貼圖，依面數預算重新拓撲，UV 展開，人形角色自動綁定骨骼與動畫，並匯出 GLB、FBX、OBJ、STL 或 USDZ。
- 3D 列印：可列印性分析與修復，單色和多色 3MF，依實際尺寸縮放，Creative Lab 產品（公仔、燈具、鑰匙圈、冰箱貼），以及在已安裝的切片軟體（如 Bambu Studio、OrcaSlicer 或 Creality Print）中開啟。
該技能透過 Meshy CLI 運行。只需在瀏覽器中登入一次，無需 API 金鑰。
使用需求
- OpenClaw。
- 執行 OpenClaw 的機器上需要 Node.js 22.12 或更高版本，並附帶 npm。
PATH中有meshy或npm時，該技能才會變為可用。 - Meshy 付費方案：生成功能需要付費方案，每個生成任務都會依 API 價格 消耗 Meshy 點數。可列印性分析免費，本地列印步驟（例如縮放模型或在切片軟體中開啟）無需登入。
安裝
從 ClawHub 安裝技能：
openclaw skills install @arlieeee/meshy-3d-agent
如果還沒有安裝 Meshy CLI，OpenClaw 會提示你從 npm 安裝。全域安裝只是讓啟動更快；不安裝的話，技能會透過 npm exec 執行 CLI。
也可以讓智能代理完成全部安裝。把下面這段話貼到 OpenClaw：
帮我安装 Meshy CLI 和 meshy-3d-agent 技能：
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md
如果你的智能代理只在啟動時載入技能，安裝後請開啟一個新的工作階段。
登入
第一次請求生成模型時，智能代理會執行 Meshy CLI 的裝置登入流程，並提供你一個連結和一次性驗證碼：
- 在任意裝置上開啟連結並登入 Meshy。
- 按顯示內容準確輸入驗證碼，然後點擊 Connect。
- 智能代理會繼續執行你先前的請求。
驗證碼 10 分鐘後失效，過期了讓智能代理重新產生即可。裝置登入可以在任意瀏覽器中完成，所以 OpenClaw 執行在伺服器或容器中時也能使用。MESHY_API_KEY 是可選的：如果設定了，它會優先於瀏覽器登入。
範例提示詞
- 做一個哈士奇幼犬的 3D 模型，以 GLB 格式儲存到 ./assets。
- 把這張照片轉成帶材質的 3D 模型，保持原有比例。（附上圖片）
- 給這個人形角色綁定骨骼，加入跑步動畫，並匯出為 FBX。
- 幫我 3D 列印一個 80 mm 高的小龍公仔，並在 Bambu Studio 中開啟。
- 把這個 logo 做成可以 3D 列印的鑰匙圈。
後續請求會沿用上一次的結果：做一個 1,500 面的 LOD、換成 FBX、縮放到 150 mm。在請求中加上 花點數前先問我，即可逐一確認付費步驟。
安全與資料
- 執行內容： 只執行 Meshy CLI，即
meshy命令，或透過npm exec執行的固定版本套件。技能本身只有 Markdown，不包含 Python、curl或附帶腳本。 - 憑證： CLI 將登入狀態儲存在
~/.config/meshy/credentials.json（權限 0600）並自動重新整理。技能從不讀取、顯示或複製任何權杖、裝置碼或金鑰，也不會在對話中向你索取。 - 網路： 提示詞、圖片和任務請求會傳送到 Meshy API（通常是
api.meshy.ai）。安裝或臨時執行 CLI 時會存取 npm。 - 檔案： 每個任務只會在一個資料夾內寫入：你指定的資料夾，或
./meshy_output。該資料夾之外的路徑會被拒絕；除非你明確要求，否則不會覆蓋現有檔案。
完整的安全說明請見技能原始碼。
故障排查
| 現象 | 解決方法 |
|---|---|
| 技能顯示為不可用 | 安裝附帶 npm 的 Node.js 22.12 或更高版本，或執行 npm install -g meshy-cli 安裝 CLI，然後開啟一個新的工作階段。 |
| 智能代理要求提供 API 金鑰 | 拒絕，並讓它改用瀏覽器登入。不要在任何對話中貼上 API 金鑰。 |
| 登入驗證碼已過期 | 讓智能代理重新發起登入。驗證碼有效期為 10 分鐘。 |
| 因方案或點數不足無法生成 | 生成需要付費方案和足夠的點數。請在 meshy.ai 查看你的方案和餘額。 |
| 登入了錯誤的 Meshy 帳戶 | 讓智能代理執行 meshy auth logout，然後重新登入。 |
常見問題
- OpenClaw 版 Meshy 技能是什麼？
- Meshy 3D Agent 是 ClawHub 上的 Meshy 官方技能。它透過呼叫 Meshy CLI，讓 OpenClaw 智能代理生成 3D 模型、材質、骨骼綁定和動畫，並為 3D 列印準備模型。
- 如何在 OpenClaw 中安裝 Meshy 技能？
- 執行 openclaw skills install @arlieeee/meshy-3d-agent。你還需要附帶 npm 的 Node.js 22.12 或更高版本；OpenClaw 會提示你從 npm 安裝 Meshy CLI。
- 需要 Meshy API 金鑰嗎？
- 不需要。技能透過瀏覽器和一次性驗證碼登入，Meshy CLI 會儲存登入狀態。MESHY_API_KEY 是可選的；如果設定了，會優先使用它。
- OpenClaw 執行在伺服器上時也能用嗎？
- 可以。裝置登入會給出一個連結和驗證碼，你可以在任意瀏覽器中完成確認，所以 OpenClaw 可以執行在遠端機器或容器中。
- Meshy 技能免費嗎？
- 技能可以免費安裝。生成 3D 模型需要 Meshy 付費方案，並依 API 價格消耗 Meshy 點數。可列印性分析免費。
- 我之前用的是基於 Python 的舊版 Meshy OpenClaw 技能，原來的任務還能用嗎？
- 可以。該技能從 0.6.0 版本起改用 Meshy CLI，舊技能產生的任務 ID 仍然可以在 CLI 中使用。
相關連結
- Codex 版 Meshy 外掛
- Hermes Agent 版 Meshy 技能
- AI 工具：MCP server 與 llms.txt：使用你自己的 API 金鑰，在 AI 智能代理中呼叫 Meshy API
- ClawHub 上的 Meshy 3D Agent
- GitHub 上的 meshy-3d-agent：技能原始碼