Meshy Skill cho OpenClaw

Meshy skill chính thức dành cho OpenClaw cho phép agent của bạn tạo mô hình 3D, texture và hoạt hình, đồng thời chuẩn bị bản in 3D, tất cả chỉ từ một cuộc trò chuyện.

Tổng quan

Meshy hiện đã có mặt trên ClawHub với tên Meshy 3D Agent, một skill duy nhất bao gồm:

  • Tạo mô hình 3D: văn bản sang 3D, ảnh sang 3D và đa góc nhìn sang 3D, tạo và tái tạo texture bằng AI, remesh theo ngân sách đa giác, trải UV, tự động rigging và tạo hoạt hình cho nhân vật dạng người, cùng khả năng xuất sang GLB, FBX, OBJ, STL hoặc USDZ.
  • In 3D: phân tích và sửa chữa khả năng in, 3MF đơn sắc và đa sắc, điều chỉnh kích thước theo kích thước thực tế, các sản phẩm Creative Lab (tượng nhỏ, đèn, móc khóa, nam châm tủ lạnh) và chuyển giao cho phần mềm cắt lớp đã cài đặt như Bambu Studio, OrcaSlicer hoặc Creality Print.

Skill này vận hành thông qua Meshy CLI. Bạn chỉ cần đăng nhập một lần trên trình duyệt; không cần khóa API.

Yêu cầu

  • OpenClaw.
  • Node.js 22.12 trở lên, cùng với npm, trên máy chạy OpenClaw. Skill này sẽ đủ điều kiện sử dụng khi meshy hoặc npm có mặt trong PATH.
  • Một gói Meshy trả phí để tạo mô hình. Mỗi tác vụ tạo mô hình sẽ tiêu tốn tín dụng Meshy theo mức giá API. Phân tích khả năng in là miễn phí, và các bước in cục bộ, chẳng hạn như thay đổi kích thước mô hình hoặc mở nó trong phần mềm cắt lớp, không cần đăng nhập.

Cài đặt

Cài đặt skill từ ClawHub:

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

OpenClaw sẽ đề nghị cài đặt Meshy CLI từ npm nếu chưa được cài đặt. Việc cài đặt toàn cục chỉ giúp khởi động nhanh hơn; nếu không có, skill sẽ chạy CLI thông qua npm exec.

Bạn cũng có thể để agent thực hiện toàn bộ quá trình thiết lập. Dán nội dung sau vào OpenClaw:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Nếu agent của bạn chỉ tải skill khi khởi động, hãy bắt đầu một phiên mới sau khi cài đặt.

Đăng nhập

Lần đầu tiên bạn yêu cầu một mô hình, agent sẽ chạy quy trình đăng nhập thiết bị của Meshy CLI và gửi cho bạn một liên kết cùng một mã dùng một lần:

  1. Mở liên kết trên bất kỳ thiết bị nào và đăng nhập vào Meshy.
  2. Nhập mã chính xác như hiển thị, sau đó nhấp vào Connect.
  3. Agent sẽ tiếp tục thực hiện yêu cầu mà bạn đã đưa ra.

Trang kết nối Meshy CLI

Mã sẽ hết hạn sau 10 phút; hãy yêu cầu agent cấp mã mới nếu điều đó xảy ra. Vì quy trình đăng nhập thiết bị hoạt động từ bất kỳ trình duyệt nào, điều này cũng hoạt động khi OpenClaw chạy trên server hoặc trong container. MESHY_API_KEY là tùy chọn: nếu được thiết lập, nó sẽ được ưu tiên hơn phiên đăng nhập trình duyệt.

Ví dụ về câu lệnh

  • Tạo một mô hình 3D của một chú chó husky con và lưu nó dưới dạng GLB vào ./assets.
  • Biến bức ảnh này thành một mô hình 3D có texture và giữ nguyên tỷ lệ của nó. (đính kèm hình ảnh)
  • Rig nhân vật dạng người này, thêm hoạt hình chạy, và xuất nó dưới dạng FBX.
  • Giúp tôi in 3D một tượng rồng nhỏ, cao 80 mm, và mở nó trong Bambu Studio.
  • Biến logo này thành một móc khóa mà tôi có thể in 3D.

Các yêu cầu tiếp theo sẽ tái sử dụng kết quả trước đó: tạo một LOD 1.500 mặt, bây giờ dưới dạng FBX, phóng to lên 150 mm. Thêm hỏi tôi trước khi tiêu tốn tín dụng để phê duyệt từng bước trả phí.

Bảo mật và Dữ liệu

  • Những gì nó chạy: chỉ có Meshy CLI, dưới dạng meshy hoặc gói đã ghim thông qua npm exec. Skill chỉ ở dạng Markdown, không có Python, curl hay script đi kèm.
  • Thông tin đăng nhập: CLI lưu trữ và làm mới phiên đăng nhập trong ~/.config/meshy/credentials.json với mode 0600. Skill không bao giờ đọc, in ra hoặc sao chép token, mã thiết bị hay khóa, và không bao giờ yêu cầu những thông tin này trong cuộc trò chuyện.
  • Mạng: câu lệnh, hình ảnh và yêu cầu tác vụ được gửi đến Meshy API (thường là api.meshy.ai). npm được liên hệ khi CLI được cài đặt hoặc chạy tạm thời.
  • Tệp: mỗi tác vụ ghi vào trong một thư mục duy nhất: thư mục bạn đặt tên, hoặc ./meshy_output. Các đường dẫn bên ngoài thư mục này sẽ bị từ chối, và các tệp hiện có sẽ không bị ghi đè trừ khi bạn yêu cầu.

Toàn bộ tài liệu bảo mật có trong mã nguồn của skill.

Khắc phục sự cố

Triệu chứngCách khắc phục
Skill không đủ điều kiệnCài đặt Node.js 22.12 trở lên cùng với npm, hoặc cài đặt CLI bằng npm install -g meshy-cli, sau đó bắt đầu một phiên mới.
Agent yêu cầu khóa APITừ chối và yêu cầu nó đăng nhập qua trình duyệt thay vào đó. Không bao giờ dán khóa API vào cuộc trò chuyện.
Mã đăng nhập đã hết hạnYêu cầu agent bắt đầu lại quá trình đăng nhập. Mã có hiệu lực trong 10 phút.
Việc tạo mô hình bị từ chối do gói hoặc tín dụngViệc tạo mô hình cần một gói trả phí và đủ tín dụng. Kiểm tra gói và số dư của bạn tại meshy.ai.
Đăng nhập nhầm tài khoản MeshyYêu cầu agent chạy meshy auth logout, sau đó đăng nhập lại.

Câu hỏi thường gặp

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.

Liên kết liên quan