Hermes Agent 接入教程
Hermes Agent 接入 ComfyUI：API 密钥、音乐与视频工作流
把自己的 ComfyUI 云端 API 密钥添加到 OpenClaw Launch，就能从 Hermes Agent 对话中调用音乐和视频工作流。计算在云端完成，不需要在本地准备 GPU。
ComfyUI 是什么？与 Hermes 怎么配合？
ComfyUI 是开源的节点式 AI 生成工具，可以把模型、采样器和后处理步骤连接起来，构建图片、视频与音乐生成流程。这些工作流以 JSON 图的形式描述，比只输入一段提示词的生成接口有更多可调整的环节。
除了在本地运行，也可以使用官方云平台 platform.comfy.org，通过 API 执行工作流，把 GPU 运维交给云端。在 OpenClaw Launch 上，你提供个人 ComfyUI API 密钥，平台负责认证、请求路由，并把密钥应用到正在运行的 Hermes Agent 实例。
如果还不熟悉 Hermes，可以先读中文入门介绍；其他服务商的密钥用途见Hermes BYOK 英文指南。
添加 ComfyUI 密钥后能做什么？
保存密钥后，Hermes 实例可使用 comfy/workflow 模型路由，调用云端工作流：
- 音乐与音频：在 Hermes 对话中触发 ComfyUI 云端的音乐生成流程，生成原创音乐或音频。
- 视频：通过 Hermes 可调用的工具，在云端 GPU 上执行文生视频、图生视频工作流。
- 自定义工作流：将兼容 ComfyUI 的工作流 JSON 交给
platform.comfy.org执行，按用量付费。
ComfyUI 云服务按每次工作流消耗的计算时间收费。添加密钥并不包含这部分费用，运行前需要为自己的 ComfyUI 账户充值。
第一步：申请 ComfyUI API 密钥
- 登录云平台。在浏览器打开
https://platform.comfy.org/login，登录或注册账户。 - 找到密钥管理入口。进入账户设置或控制台的 API 区域，在侧栏查找「API Keys」或「Credentials」。
- 创建密钥。点击「Create API Key」，取一个方便识别的名称，例如「Hermes Agent — OpenClaw Launch」。
- 复制密钥。ComfyUI API 密钥以
comfy-开头。创建后及时复制并妥善保存；许多平台只在创建时完整展示一次密钥。 - 充值。为 ComfyUI 账户添加余额，避免开始生成时因余额不足而失败。
国内用户可先确认当前网络能否正常打开并登录 ComfyUI 云平台，再进行后续配置。
第二步：在 OpenClaw Launch 保存密钥
- 登录 OpenClaw Launch，打开「API Keys」页面（路径为
/api-keys）。 - 找到 ComfyUI 卡片，粘贴以
comfy-开头的密钥，再点击「Save」。平台会先向 ComfyUI API 实时校验密钥，通过后才保存。 - 密钥以加密形式存储，保存后立即应用到你现有的所有运行中 Hermes Agent 实例，无需重新部署。
- 打开 Hermes 实例设置，在媒体设置面板中选择需要的音乐或视频模型。密钥保存成功后，ComfyUI 工作流模型就会出现在这里。
如果使用的是 OpenClaw 实例，可以参考OpenClaw + ComfyUI 英文指南中的对应步骤。
常见问题排查
提示 401 Unauthorized 或 Invalid Key
- 检查密钥是否以
comfy-开头，确认没有把工作区令牌等其他凭据当成 API 密钥。 - 检查复制时是否带上了末尾空格。可以先粘贴到纯文本编辑器中核对，再重新保存。
- 确认密钥属于已充值的计费账户。未充值子账户的密钥可能通过认证，却在第一次执行工作流时因余额不足而失败。
提示 Workflow Not Found，或找不到 ComfyUI 模型
comfy/workflow路由只有在有效密钥保存后才会出现。先回到「API Keys」页面，确认 ComfyUI 卡片显示保存成功的绿色勾选标记。- 密钥已经保存，但模型列表里仍没有 ComfyUI 选项时，刷新 Hermes 实例设置页面后再查看。
提示 Quota 或 Insufficient Credits
- 检查
platform.comfy.org账户余额。余额不足时，工作流会报计费错误，需要先在 ComfyUI 云平台充值。 - 较长的视频工作流通常比短音乐片段消耗更多额度。如果余额下降比预期快，到 ComfyUI 控制台查看具体用量。
常见问题
Hermes Agent 用户可以免费使用 ComfyUI 云服务吗？
不能。platform.comfy.org 按每次工作流消耗的 GPU 计算时间收费，不会因为使用 Hermes Agent 而免费。该云服务没有免费档位，运行工作流前需要先充值。
ComfyUI API 密钥以什么开头？
以 comfy- 开头。如果复制的凭据没有这个前缀，可能拿到的是会话令牌或工作区凭据。请回到 platform.comfy.org 的 API Keys 区域创建 API 密钥。
保存密钥后，需要停止或重新部署 Hermes 实例吗？
不需要。在 OpenClaw Launch 的 API Keys 页面保存成功后，密钥会立即应用到你现有的所有运行中 Hermes Agent 实例。随后可以在实例的媒体设置中选择 ComfyUI 工作流模型，无需停止或重新部署。
同一个 Hermes 实例能同时使用 ComfyUI 和其他媒体服务吗？
可以。你可以同时保存多家媒体服务的密钥，实例设置中的模型卡片会标明对应的服务商。例如，同一个实例可以用 ComfyUI 运行音乐工作流、用 fal 生成图片，再用 Runway 生成视频。