Hermes Agent 版 Meshy 技能
将 Meshy 技能 添加到 Hermes Agent,让你的智能体在对话中生成 3D 模型、纹理和动画,并准备 3D 打印。
概述
Meshy 为 Hermes Agent 提供两个技能:
meshy-3d-generation:文生 3D、图生 3D 和多图生 3D,AI 纹理生成与重新贴图,按面数预算重拓扑,UV 展开,人形角色自动绑定骨骼与动画,并导出 GLB、FBX、OBJ、STL 或 USDZ。meshy-3d-printing:可打印性分析与修复,单色和多色 3MF,按真实尺寸缩放,Creative Lab 产品(例如手办、灯具、钥匙扣和冰箱贴),以及交给已安装的切片软件。
两个技能可以分别安装,如果只需要打印技能,只装它即可。两个技能都运行 Meshy CLI,也就是 npm 上的 meshy-cli 包。你只需在浏览器中登录一次,无需 API 密钥。
这些技能在 GitHub 上的 meshy-3d-agent 仓库中开源。
开始之前
-
你需要 Hermes Agent。如需下载 macOS 或 Windows 桌面应用,或获取在终端中安装它的命令,请前往 Hermes Agent 官网。
-
运行 Hermes 的电脑上需要 Node.js 22.12 或更高版本,并带有 npm。
-
生成模型需要 Meshy 付费套餐。每个生成任务都会按 API 价格消耗 Meshy 积分。各任务的费用请参阅价格。可打印性分析免费,本地打印步骤(例如缩放模型或在切片软件中打开模型)无需登录。
安装技能
如果想让 Hermes 完成安装,把下面这段文字粘贴到对话中:
Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md
Hermes 会检查 Node.js,安装 Meshy CLI 和两个技能,然后引导你完成登录。
如果想自己安装技能,可以用 Hermes 从 GitHub 添加:
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing
也可以用 skills 安装器安装两个技能:
npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent
你不需要全局运行 npm install -g meshy-cli。不全局安装时,技能会通过 npm exec 运行 CLI。全局安装只是让启动更快。
如果在安装时已打开的对话中,Hermes 没有使用这些技能,请开启一个新会话。
登录
第一次请求生成模型时,Hermes 会启动 Meshy CLI 登录,并发给你一个链接和一次性验证码。
按以下步骤登录:
-
在任意设备上打开链接。
-
如果页面要求输入验证码,在 设备代码 中按 Hermes 显示的内容准确输入,然后点击 继续。
-
如果 Meshy 要求登录,登录你的 Meshy 账户。
-
在 连接 Meshy CLI 页面上,点击 连接。页面会显示 已授权 Meshy CLI。

-
回到对话。Hermes 会继续执行你之前的请求。
验证码 10 分钟后失效。如果过期,让 Hermes 重新生成一个。你可以在任意浏览器中确认登录,所以 Hermes 运行在服务器上或通过 SSH 使用时也能登录。
Meshy CLI 将登录状态保存在 ~/.config/meshy/credentials.json 中。在这台电脑上以同一用户运行的所有智能体共用该登录状态。如果设置了 MESHY_API_KEY,CLI 会改用该 API 密钥,而不是浏览器登录状态。
示例提示词
用你自己的话描述任务。例如:
- 做一个哈士奇幼犬的 3D 模型,以 GLB 格式保存到 ./assets。
- 把这张照片转成带纹理的 3D 模型,保持原有比例。(附上图片)
- 为我的游戏做三个低多边形药水瓶,每个不超过 1,500 个三角面。
- 给这个人形角色绑定骨骼,添加行走动画,并导出为 FBX。
- 帮我 3D 打印一个 80 mm 高的小龙手办,做成多色 3MF。
后续请求会沿用上一次的结果,例如 做一个 1,500 面的 LOD、换成 FBX 或 缩放到 150 mm。如果想自己确认每个付费步骤,在请求中加上 花积分前先问我。
问题排查
下表列出了常见问题、原因及解决方法。
| 问题 | 原因 | 解决方法 |
|---|---|---|
| Hermes 没有使用 Meshy 技能 | Hermes 没有在已打开的对话中加载技能,或没有把你的请求匹配到这些技能。 | 开启一个新会话,或在请求中提到 Meshy。 |
找不到 node 或 npm | 没有安装 Node.js,或 Hermes 找不到它。 | 从 Node.js 官网安装 Node.js 22.12 或更高版本,然后重启 Hermes。 |
| Hermes 要求提供 API 密钥 | 技能不需要 API 密钥,它们通过浏览器登录。 | 拒绝,并让 Hermes 改用浏览器登录。不要在对话中粘贴 API 密钥。 |
| 登录验证码已过期 | 验证码有效期为 10 分钟。 | 让 Hermes 重新发起登录。 |
| 因套餐或积分原因,Hermes 无法生成 | 生成需要付费套餐和足够的积分。 | 在 Meshy 网页端的订阅页面查看你的套餐和余额。 |
| 登录了错误的 Meshy 账户 | Meshy CLI 会复用保存在你电脑上的登录状态。 | 让 Hermes 运行 meshy auth logout,然后重新登录。 |
常见问题
- 如何把 Meshy 添加到 Hermes Agent?
- 让 Hermes 按照 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 操作,或者运行 hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation,再用同样的命令安装 meshy-3d-printing。你还需要带 npm 的 Node.js 22.12 或更高版本。
- 需要 Meshy API 密钥吗?
- 不需要。技能通过浏览器和一次性验证码登录,Meshy CLI 会保存登录状态。如果环境中已经设置了 MESHY_API_KEY,Meshy CLI 会改用它。
- 可以只安装 3D 打印技能吗?
- 可以。meshy-3d-printing 可以单独安装和使用,包括打印所需的生成步骤。
- Hermes 运行在远程服务器上时也能用吗?
- 可以。登录时会显示一个链接和验证码,你可以在任意浏览器中确认。
- 这些技能和 Codex 插件是同一套吗?
- 是的。Codex 插件、Claude Code、Cursor 和 Hermes Agent 使用的都是开源仓库 meshy-3d-agent 中的 meshy-3d-generation 和 meshy-3d-printing。
- 免费吗?
- 技能免费且开源。生成 3D 模型需要 Meshy 付费套餐,并按 API 价格消耗 Meshy 积分。可打印性分析免费。
后续步骤
-
如需在 Codex 中使用同样的技能,请参阅 Codex 版 Meshy 插件。
-
如需在 OpenClaw 中使用同样的技能,请参阅 OpenClaw 版 Meshy 技能。
-
如需用你自己的 API 密钥在 AI 智能体中调用 Meshy API,请参阅 AI 集成。