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：技能源码