功能描述

Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment.

使用说明 (SKILL.md)

Meshy.ai

Name: Meshy AI
Author: sabatesduran

Generate Meshy assets via API and save outputs locally.

Setup

Add env var: MESHY_API_KEY=msy-...
Optional: MESHY_BASE_URL (defaults to https://api.meshy.ai)

Text → 2D (Text to Image)

Use scripts/text_to_image.py.

python3 skills/public/meshy-ai/scripts/text_to_image.py \
  --prompt "a cute robot mascot, flat vector style" \
  --out-dir ./meshy-out

Downloads one or more images (if multi-view) into ./meshy-out/text-to-image_\x3CtaskId>_\x3Cslug>/.

Image → 3D (always save OBJ)

Use scripts/image_to_3d_obj.py.

Local image

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image ./input.png \
  --out-dir ./meshy-out

Public URL

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image-url "https://.../input.png" \
  --out-dir ./meshy-out

Always downloads model.obj (and model.mtl if provided by Meshy) into ./meshy-out/image-to-3d_\x3CtaskId>_\x3Cslug>/.

Notes

Meshy tasks are async: create → poll until status=SUCCEEDED → download URLs.
API reference for this skill: references/api-notes.md.

安全使用建议

This skill appears to do exactly what it claims: it needs your Meshy API key, creates async jobs, polls for completion, and downloads images/OBJ files. Before installing or running: (1) ensure the registry metadata is corrected to list MESHY_API_KEY so you know what credentials are required; (2) only provide an API key you trust Meshy with (use limited-scope keys if available); (3) be aware downloads come from URLs returned by the service — avoid running untrusted binaries and inspect downloaded content before executing anything; (4) if you’ll run the scripts locally, run them in an isolated environment (container or VM) if you have concerns about third-party content. If you need higher assurance, request that the publisher add the required env var to the registry metadata and confirm the package's provenance/homepage.

功能分析

Type: OpenClaw Skill Name: clawdbot-meshyai-skill Version: 0.1.0 The OpenClaw AgentSkills skill bundle for Meshy.ai is classified as benign. The skill's purpose is to interact with the Meshy.ai API to generate and download assets, which it achieves by making API calls and saving outputs to a local directory. It properly handles the `MESHY_API_KEY` via environment variables and uses standard Python libraries (`urllib.request`, `os`) for network communication and file operations. There is no evidence of data exfiltration beyond the necessary API key for authentication, no malicious execution patterns, no persistence mechanisms, and no prompt injection attempts in `SKILL.md` or `README.md`.

能力评估

ℹ Purpose & Capability

The code and SKILL.md implement a Meshy.ai client (text-to-image and image-to-3d) and require MESHY_API_KEY and optional MESHY_BASE_URL — this matches the description. However the registry metadata lists no required env vars/primary credential, which is inconsistent with the code and docs.

✓ Instruction Scope

Runtime instructions are narrow and explicit: set MESHY_API_KEY (optional MESHY_BASE_URL), run the provided Python scripts, create tasks, poll until completion, and download returned URLs. The scripts only read local files you explicitly pass (for data-URI upload) and do network calls to the Meshy API and the returned model/image URLs.

✓ Install Mechanism

No install spec (instruction-only + bundled Python scripts). Nothing is downloaded or executed at install time; risk is limited to running included Python scripts.

ℹ Credentials

The code requires a single API key (MESHY_API_KEY) and optionally MESHY_BASE_URL, which is appropriate for a REST API client. The registry metadata failing to declare this required env var is a discrepancy that should be corrected before trusting the metadata alone.

✓ Persistence & Privilege

The skill does not request permanent presence (always=false) and does not modify other skills or system-wide settings. It can be invoked autonomously by the agent (platform default), which is expected for a callable skill.

版本历史

v0.1.0

Initial release of the meshy-ai skill. - Integrates Meshy.ai REST API for generating assets: text-to-2D images and image-to-3D models. - Supports downloading results locally, always saving OBJ files for 3D outputs. - CLI scripts provided for both generation modes with async polling and output management. - Requires setting MESHY_API_KEY in the environment for authentication.

元数据

Slug clawdbot-meshyai-skill

版本 0.1.0

许可证 —

累计安装 2

当前安装数 2

历史版本数 1

常见问题

Meshy AI 是什么？

Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1975 次。

如何安装 Meshy AI？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawdbot-meshyai-skill」即可一键安装，无需额外配置。

Meshy AI 是免费的吗？

是的，Meshy AI 完全免费（开源免费），可自由下载、安装和使用。

Meshy AI 支持哪些平台？

Meshy AI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Meshy AI？

由 Dídac Sabatés（@sabatesduran）开发并维护，当前版本 v0.1.0。

Meshy AI