OpenClaw LaunchOpenClaw Launch
← 国内应用

国内应用接入

可灵 AI MCP 接入：确认后生成视频、图片并查询结果

让 Hermes Agent 或 OpenClaw 整理创意，使用您自己的可灵 AccessKey 与 SecretKey 提交生成任务，再按任务 ID 获取完成状态和结果链接。

从一句创意到一条有记录的生成任务

准备产品短片、活动视觉或场景概念图时，助手可以先把您的想法写成明确的画面描述，列出时长、画幅和数量供您确认。确认之后，可灵 AI 工具才提交真实生成请求，消耗的是您自己的可灵 API 账户额度。

文生视频和文生图都是异步任务。提交成功通常先得到任务 ID，助手还需要查询状态；只有任务成功并返回结果链接，才有可查看的素材。任务 ID 本身不能当成已经完成的视频或图片。

本页描述 OpenClaw Launch 的托管连接，适用于 Hermes Agent 和 OpenClaw。当前凭证表单只支持 AccessKey 与 SecretKey 双密钥；如果您的可灵控制台仅提供一个独立 API Key，请先核对可用凭证方式，不要将同一个 Key 填进两个字段。

接入后可以做什么？

  • 文生视频：根据提示词创建视频任务，可选择 5 秒或 10 秒、16:9／9:16／1:1 画幅，以及 std 或 pro 模式；实际能否调用仍取决于模型和账号权限。
  • 文生图：按文字描述创建图片任务，当前数量参数支持 1 至 9 张，并可提供负向提示词和支持的画幅。每次生成都需要确认。
  • 按任务查询结果：使用任务 ID 和 video 或 image 类型查询状态。成功后返回素材地址；查询不会另建一个生成任务，也不会自动发布到社交账号。

先核对可灵凭证类型，再连接助手

当前托管连接需要您自己的 AccessKey 和配套 SecretKey，服务端用这对凭证签名调用可灵北京区 API。单一 API Key、登录密码或网页 Cookie 都不能替代这个表单要求的双密钥。

可灵官方开放平台：账号开通与 API 使用指引

  1. 确认账号的 API 权限 — 从可灵官方开放平台进入控制台，核对目标接口、模型权限以及 API 余额或资源包。先确认当前托管双密钥方式适用于您的账号，再决定是否为生成任务充值。
  2. 取得匹配的双密钥 — 在控制台密钥管理中查看或创建 AccessKey 和对应 SecretKey，并妥善保存。若页面只有单一 API Key，当前托管表单无法直接使用，请勿复制到两个字段尝试替代。
  3. 连接 Hermes 或 OpenClaw — 在国内应用列表选择可灵 AI，分别填写 AccessKey 与 SecretKey。两个框架使用相同入口；若 Hermes 显示重载中，等待工具就绪再调用。
  4. 先审阅创意和参数 — 让助手展示提示词、负向提示词、视频时长与模式，或图片数量。模型名称可以指定，也可以留空交给可灵使用默认值；先确认费用风险，再允许提交。
  5. 保存任务 ID 并查状态 — 提交后保留任务 ID，用对应的 video 或 image 类型查询结果。若网络中断或结果不确定，先在可灵任务记录中核对，避免把重复生成当成普通重试。
凭证与权限边界：AccessKey 与 SecretKey 由 OpenClaw Launch 服务端加密保存，用于生成短期签名凭证，不写入机器人容器。连接页面保存凭证不代表可灵已验证权限或余额；真正调用时仍可能返回认证、接口权限或资源包错误。请只在连接表单填写密钥，不要发给聊天助手。

连接后可以直接这样问

  • “为一段清晨茶园的 5 秒横屏视频整理提示词，使用 std 模式；先给我看参数和费用提醒，等我确认后再调用可灵。”
  • “准备一张 1:1 的水墨山水活动背景图，不含文字，数量 1 张；先展示完整生成描述，确认后再创建图片任务。”
  • “查询刚才那个可灵视频任务的状态；成功后给我结果链接，尚未完成就如实说明，不要重新创建任务。”

使用前必须知道的限制

当前只接入文生视频、文生图和单个任务查询，不提供图生视频、视频延长、对口型、素材编辑或账户余额查询。视频时长只接受 5／10 秒，模式为 std／pro，三种画幅为 16:9、9:16、1:1；图像数量为 1–9。model_name 可选，留空时本连接不固定模型版本，具体可用模型和参数组合以可灵权限为准。没有模型支持保证或固定生成完成时间。

生成视频和图片都会消耗真实 API 额度，工具要求在您确认后才传 confirm:true。生成前核对内容、时长或数量，生成结果用于发布前需自己检查。不要把客户密钥或无关个人资料写进提示词；任务查询只是查看已有状态，不能用于掩盖重复付费生成。

托管连接还是自己搭工具？

方案适合谁您需要负责什么
OpenClaw Launch 托管希望尽快让机器人持续在线并连接可灵 AI的用户提供必要授权、确认敏感操作并管理自己的应用账户
自行部署已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者为 Hermes Agent 或 OpenClaw 分别配置兼容的可灵工具，维护凭证类型、请求签名、账号区域、异步任务查询和模型参数；自行实现生成前确认、任务 ID 保存与不确定结果核对，避免重复计费。

自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。

已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。

可灵 AI接入常见问题

Hermes Agent 可以使用可灵 AI 吗？

可以。OpenClaw Launch 为 Hermes Agent 和 OpenClaw 提供相同的可灵托管连接，当前支持文生视频、文生图和任务查询，前提是您的账号具备兼容凭证与相应接口权限。

我只有一个可灵 API Key，能直接连接吗？

当前国内应用连接表单需要 AccessKey 和 SecretKey 两个字段，并按双密钥方式签名。只有一个独立 API Key 时无法直接使用，不应把同一个 Key 填入两个字段。

为什么返回了任务 ID，却没有视频？

生成是异步的，任务 ID 表示请求已提交。需要使用相同任务 ID 查询，等待状态成功且返回结果地址后，才能查看视频。

不填写模型名称会用哪个版本？

当前连接不会固定一个默认 model_name，留空时由可灵接口选择默认模型。若需要指定版本，请先确认该模型在您的 API 账号和目标生成接口中可用。

生成费用包含在托管费里吗？

不包含。可灵生成消耗您自己的 API 余额或资源包，和 OpenClaw Launch 托管费用分别计算；生成前应在可灵控制台核对额度。

超时后可以直接重新生成吗？

先核对可灵平台的任务记录。网络异常不一定表示创建失败；已经有任务 ID 时优先查询原任务，避免重复提交产生额外消耗。

继续配置您的中文 AI 助手

连接可灵 AI，先确认创意再生成

先创建持续在线的 AI Agent，再从国内应用列表连接可灵 AI。托管首月 $3，续费 $6/月，支持支付宝和微信支付。

开始部署可灵 AI助手