Meshy skill cho OpenClaw là gì?

Meshy 3D Agent là skill Meshy trên ClawHub. Nó cho phép agent OpenClaw tạo mô hình 3D, texture, rigging, và hoạt hình, cũng như chuẩn bị mô hình cho việc in 3D, bằng cách chạy Meshy CLI.

Làm thế nào để cài đặt skill Meshy trong OpenClaw?

Chạy lệnh openclaw skills install @arlieeee/meshy-3d-agent. Bạn cũng cần Node.js 22.12 trở lên cùng npm. Trang Skills của OpenClaw có thể đề nghị cài đặt Meshy CLI từ npm.

Tôi có cần khóa API Meshy không?

Không. Skill đăng nhập thông qua trình duyệt của bạn bằng mã dùng một lần, và Meshy CLI sẽ lưu trữ phiên đăng nhập đó. Bạn không cần MESHY_API_KEY, nhưng nếu biến này được thiết lập, Meshy CLI sẽ dùng nó thay vào đó.

Skill này có hoạt động khi OpenClaw chạy trên máy chủ không?

Có. Màn hình đăng nhập hiển thị một liên kết và mã mà bạn có thể phê duyệt từ bất kỳ trình duyệt nào, vì vậy OpenClaw có thể chạy trên máy tính từ xa hoặc trong container.

Skill Meshy có miễn phí không?

Việc cài đặt skill là miễn phí. Việc tạo mô hình 3D yêu cầu gói Meshy trả phí và 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í.

Tôi đã dùng skill Meshy OpenClaw dựa trên Python cũ hơn. Các tác vụ của tôi có còn hoạt động không?

Có. Skill đã chuyển sang Meshy CLI từ phiên bản 0.6.0, và bạn vẫn có thể dùng ID tác vụ từ skill cũ với CLI.

Meshy skill cho OpenClaw

Thêm skill Meshy vào OpenClaw để agent của bạn có thể tạo mô hình 3D, texture và hoạt hình, cũng như chuẩn bị bản in 3D, ngay từ cuộc trò chuyện.

Tổng quan

Skill Meshy có trên ClawHub với tên Meshy 3D Agent. Một skill duy nhất này bao phủ cả hai luồng công việc:

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

Skill này chạy Meshy CLI, chính là gói meshy-cli trên npm. Bạn đăng nhập một lần trên trình duyệt, và không cần khóa API.

Trước khi bắt đầu

Bạn cần có OpenClaw.
Bạn cần Node.js 22.12 trở lên, cùng với npm, trên máy tính chạy OpenClaw. OpenClaw sẽ kích hoạt skill khi meshy hoặc npm có trong PATH.
Để tạo mô hình, bạn cần gói Meshy trả phí. 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. Để biết chi phí của từng tác vụ, xem Giá. Phân tích khả năng in là miễn phí, và các bước in cục bộ, như đổi tỷ lệ 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 skill

Để cài đặt skill từ ClawHub, chạy lệnh sau:

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

Nếu chưa cài Meshy CLI, trang Skills của OpenClaw có thể đề nghị cài đặt nó từ npm. Bạn không cần cài đặt toàn cục. Nếu không có, skill sẽ chạy CLI thông qua npm exec, và việc cài đặt toàn cục chỉ giúp khởi động nhanh hơn.

Để OpenClaw tự thực hiện toàn bộ quá trình cài đặt, hãy dán đoạn văn bản sau vào cuộc trò chuyện:

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

Một phiên đang mở sẽ nhận skill này ở lượt tiếp theo. Nếu bạn cài Node.js hoặc Meshy CLI trong khi phiên đang mở, hãy bắt đầu phiên mới để OpenClaw có thể nhận diện chúng.

Lần đầu tiên bạn yêu cầu tạo mô hình, OpenClaw sẽ khởi động quá trình đăng nhập Meshy CLI và gửi cho bạn một liên kết cùng mã dùng một lần.

Để đăng nhập, hãy làm theo các bước sau:

Mở liên kết trên bất kỳ thiết bị nào.
Nếu trang yêu cầu nhập mã, hãy nhập mã vào ô Device code đúng như OpenClaw hiển thị, sau đó nhấp Continue.
Nếu Meshy yêu cầu đăng nhập, hãy đăng nhập vào tài khoản Meshy của bạn.
Trên trang Connect Meshy CLI, nhấp Connect. Trang sẽ hiển thị Meshy CLI authorized.
Quay lại cuộc trò chuyện. OpenClaw sẽ tiếp tục yêu cầu mà bạn đã đưa ra.

Mã sẽ hết hạn sau 10 phút. Nếu hết hạn, hãy yêu cầu OpenClaw cấp mã mới. Bạn có thể phê duyệt đăng nhập từ bất kỳ trình duyệt nào, vì vậy nó cũng hoạt động khi OpenClaw chạy trên máy chủ hoặc trong container.

Bạn không cần MESHY_API_KEY. Nếu biến này được thiết lập, CLI sẽ dùng khóa API đó thay vì phiên đăng nhập trình duyệt.

Ví dụ về prompt

Mô tả công việc theo cách của bạn. Ví dụ:

Tạo một mô hình 3D chú chó husky con và lưu dưới dạng GLB vào ./assets.
Biến bức ảnh này thành 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 hình người này, thêm hoạt hình chạy, và xuất 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ó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 đó, ví dụ tạo một LOD 1.500 mặt, bây giờ dưới dạng FBX, hoặc đổi tỷ lệ thành 150 mm. Để tự phê duyệt từng bước tốn phí, hãy thêm hỏi tôi trước khi tiêu tín dụng vào yêu cầu của bạn.

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

Danh sách sau đây tóm tắt cách skill xử lý lệnh, thông tin xác thực, truy cập mạng và file:

Những gì nó chạy: Chỉ Meshy CLI, dưới dạng meshy hoặc dưới dạng 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 xác thực: CLI lưu trữ và làm mới phiên đăng nhập tại ~/.config/meshy/credentials.json với chế độ 0600. Skill không bao giờ đọc, in ra, hoặc sao chép token, mã thiết bị, hoặc khóa, và không bao giờ hỏi xin chúng trong cuộc trò chuyện.
Mạng: CLI gửi prompt, hình ảnh, và yêu cầu tác vụ đến Meshy API, thường là api.meshy.ai. npm sẽ liên hệ với registry của nó khi cài đặt CLI hoặc chạy nó như một gói tạm thời.
File: Mỗi tác vụ chỉ ghi vào một thư mục duy nhất, thư mục bạn đã đặt tên hoặc ./meshy_output. CLI từ chối các đường dẫn nằm ngoài thư mục đó, và không ghi đè file hiện có trừ khi bạn yêu cầu.

Để xem bản khai báo bảo mật đầy đủ, xem meshy-openclaw trên GitHub.

Khắc phục sự cố

Bảng sau đây liệt kê các sự cố thường gặp, nguyên nhân, và cách khắc phục.

Sự cố	Nguyên nhân	Cách khắc phục
Skill không khả dụng trong OpenClaw	Cả `meshy` lẫn `npm` đều không có trong `PATH`.	Cài đặt Node.js 22.12 trở lên cùng npm, sau đó khởi động phiên mới.
OpenClaw yêu cầu khóa API	Skill không cần khóa API. Nó đăng nhập thông qua trình duyệt của bạn.	Từ chối, và yêu cầu OpenClaw đă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ạn	Mã chỉ có hiệu lực trong 10 phút.	Yêu cầu OpenClaw bắt đầu lại quá trình đăng nhập.
OpenClaw không thể tạo mô hình do gói đăng ký hoặc tín dụng của bạn	Việc tạo mô hình cần gói trả phí và đủ tín dụng.	Kiểm tra gói và số dư của bạn trên trang Subscription trong ứng dụng web Meshy.
Bạn đang đăng nhập nhầm tài khoản Meshy	Meshy CLI tái sử dụng phiên đăng nhập đã lưu trên máy tính của bạn.	Yêu cầu OpenClaw chạy `meshy auth logout`, sau đó đăng nhập lại.

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

Meshy skill cho OpenClaw là gì?: Meshy 3D Agent là skill Meshy trên ClawHub. Nó cho phép agent OpenClaw tạo mô hình 3D, texture, rigging, và hoạt hình, cũng như chuẩn bị mô hình cho việc in 3D, bằng cách chạy Meshy CLI.
Làm thế nào để cài đặt skill Meshy trong OpenClaw?: Chạy lệnh openclaw skills install @arlieeee/meshy-3d-agent. Bạn cũng cần Node.js 22.12 trở lên cùng npm. Trang Skills của OpenClaw có thể đề nghị cài đặt Meshy CLI từ npm.
Tôi có cần khóa API Meshy không?: Không. Skill đăng nhập thông qua trình duyệt của bạn bằng mã dùng một lần, và Meshy CLI sẽ lưu trữ phiên đăng nhập đó. Bạn không cần MESHY_API_KEY, nhưng nếu biến này được thiết lập, Meshy CLI sẽ dùng nó thay vào đó.
Skill này có hoạt động khi OpenClaw chạy trên máy chủ không?: Có. Màn hình đăng nhập hiển thị một liên kết và mã mà bạn có thể phê duyệt từ bất kỳ trình duyệt nào, vì vậy OpenClaw có thể chạy trên máy tính từ xa hoặc trong container.
Skill Meshy có miễn phí không?: Việc cài đặt skill là miễn phí. Việc tạo mô hình 3D yêu cầu gói Meshy trả phí và 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í.
Tôi đã dùng skill Meshy OpenClaw dựa trên Python cũ hơn. Các tác vụ của tôi có còn hoạt động không?: Có. Skill đã chuyển sang Meshy CLI từ phiên bản 0.6.0, và bạn vẫn có thể dùng ID tác vụ từ skill cũ với CLI.

Để sử dụng cùng các luồng công việc này trong Codex, xem Meshy plugin cho Codex.
Để sử dụng cùng các luồng công việc này trong Hermes Agent, xem Meshy skills cho Hermes Agent.
Để gọi Meshy API từ một AI agent bằng khóa API của riêng bạn, xem Tích hợp AI.