meshy-openclaw

Meshy 3D — 生成与打印

使用 Meshy CLI 0.4.3，将用户的请求转化为交付的资产：在指定位置提供所需文件、在存在预览时检查预览；对于打印任务，则提供指定尺寸、分析／修复结果，以及用户要求时提供切片器交接。仅登录或提交任务并不算完成。选择合适的最短流程，并在后续任务中复用现有资产。

安全清单

**可执行程序：**仅限 Meshy CLI — meshy，或固定版本的临时软件包 npm exec --yes [email protected] -- meshy。不得使用 Python、curl 或捆绑脚本。

**凭据：**CLI 自带的浏览器登录（OAuth 设备流程）会在 ~/.config/meshy/credentials.json 中存储并刷新会话（权限模式 0600）。如果已有 MESHY_API_KEY，或指定了 --api-key-file，则会使用该凭据并优先采用。此技能绝不会读取、打印或复制令牌、设备代码或密钥，也绝不会在聊天中索要这些内容。MESHY_API_KEY 为可选项。

**网络：**Meshy API（api.meshy.ai）及其登录页面（www.meshy.ai）；下载资产时使用的媒体主机，或检查输入 URL 时访问的媒体主机（不带凭据）；安装 CLI 或将其作为临时软件包运行时访问 npm 注册表。

**文件：**每项任务仅在一个工作区内写入文件——用户指定的目录，或 ./meshy_output；CLI 会拒绝写入工作区之外的路径，包括通过符号链接逃逸的路径。除非用户提出要求，否则不会覆盖现有文件。仅读取用户指定的输入文件。切片器交接会启动已安装的切片器应用程序。

**离开本机的数据：**发送给 Meshy 的提示词、输入图像／模型和任务请求。

根据请求阅读所需内容

需求	参考文档
CLI 运行程序、登录或输出位置	设置
数字资产：生成、纹理、绑定、动画、转换、图像	流程
实体打印：本地准备、打印生成、Creative Lab、切片器	打印方案
费用、等待、预览、交付或查找先前的模型	交付
操作失败或结果不确定	故障排除

需要时阅读相关章节；方案只是供调整的示例，并非必须完整执行的阶段。未贴图的模型可跳过贴图处理；现有 GLB 无需转换。参数不确定时，使用命令 --help。

数字资产或实体打印

任何用于打印的内容——打印件、切片器、3MF、STL、Bambu／Orca／Prusa／Cura、多色模型、桌面玩具或实体人偶——都应从第一条命令开始遵循打印方案，以便生成参数适用于打印。其他所有内容均遵循流程。

打印请求	路径
缩放、定向或放置现有 OBJ	本地运行 mesh prepare-print；无需登录或余额
打开现有 STL 或 3MF	本地运行 slicer detect 和 slicer open；无需登录或余额
从文本或照片生成白色模型	生成无纹理几何体；按需分析／修复；准备文件
多色模型	生成／复用几何体；按需分析／修复；添加纹理；执行 multi-color-print
分开零件打印（打印平台、各零件的颜色、减少支撑）	生成／复用几何体；自动拆分；对各零件切片
Creative Lab 人偶、乙烯基人偶、积木人偶、灯具、钥匙扣、冰箱贴、键帽或像素解压板	原型 → 审核 → 构建 → 选择产品资源
Creative Lab 折叠式解压玩具	根据照片创建一次 → STL

仅提到小雕像并不意味着要使用 Creative Lab。只有当缺失的选择会实质性改变结果时，才询问尺寸、颜色或风格。

在 OpenClaw 中首次使用并登录

按照 Setup 中的说明解析运行器：优先使用兼容的 meshy，否则使用固定版本的临时包。仅本地打印任务到此为止。其他所有任务都复用已验证的 auth status 会话；只有在没有此类会话时，才登录：

1. 使用 exec 启动 meshy auth login --device --format json --no-update-check，并设置较短的 yieldMs（约 3000）和 timeoutSeconds: 900，以便其在后台持续运行并返回 sessionId。
2. CLI 会在几秒内通过 stderr 打印 Enter code … at https://www.meshy.ai/device。如果首次输出中只有 npm 通知，则对同一个 sessionId 执行 process poll。将 URL 作为链接、验证码原样发给用户，并说明操作步骤：打开链接，如有提示则登录 Meshy，输入验证码并批准。用户无需在聊天中回复任何内容。
3. 不要启动第二次登录、终止会话或自行轮询 HTTP；CLI 会等待批准。CLI 退出后，OpenClaw 会唤醒此会话；使用 process poll 获取结果（不会收到唤醒通知的子代理应在让出控制权前轮询）。然后验证 auth status，并继续执行原始请求，使用已提供的输入、路径和预算。

不得使用 & 或 nohup 脱离后台会话。验证码过期或被拒绝时，应重新运行同一登录命令；这绝不是重新执行付费任务的理由。长时间运行的 wait 命令也遵循相同规则：让 exec 将其放到后台，并在任务完成唤醒后继续，而不是重新提交或循环执行 sleep。

执行边界

• 通过 CLI 执行 API、上传、下载和网格操作。本地输入不得超过 50 MiB；本地模型必须为 GLB 或 glTF（绑定骨骼和多色任务使用 GLB）；其他情况请使用受支持的 URL 输入方式。
• 业务命令使用 --output-schema v1 --format json --no-update-check；认证使用自己的 JSON 格式。根据用户的输出路径解析 WORKSPACE，并将其传递给每次写入操作。
• 使用 create --async 提交一次，保留所属资源和任务 ID，然后对该任务执行 wait。超时和未知提交按 Troubleshooting 中的说明处理；它们绝不代表可以再次执行付费的 create。
• 在已批准的范围和预算内操作；如需增加付费阶段或重新运行，应先提出，再进行消费。本地预处理和可打印性分析免费；Delivery 会涵盖估算。
• 修复会改变几何结构并丢弃纹理：后续使用修复后的几何结构，多色输出前重新贴图。仅将 Y 轴朝上的 OBJ 准备一次，并另存为新文件；切勿将该变换应用于 STL、3MF 或浮雕产品输出。

交付

仅下载所需资源。将可用的渲染预览作为图片发送给用户；若缺少预览，必须明确说明，不能让用户误以为存在预览；渲染后的 PNG 不是 3D 查看器。报告文件路径、供后续跟进使用的任务 ID，以及实际费用。对于打印任务，还要报告尺寸和分析／修复状态；仅在用户请求时启动检测到的切片软件，并说明 launch_requested 并不能证明模型已导入。提及相关的待检查事项，例如支撑和壁厚；未经测试的模型不得称为保证可打印。