rh-skill_设计多媒体 skill-PHP中文网

rh-skill

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

RunningHub AI 智能调用，用于生成图像、视频或音频内容。

RHMCP Skill - OpenClaw QQRHMCP CHLOPNCLAW Skill CHLAW CHLAST CHLAST ALLAST: git

功能概述

RHMCP Skill - OpenClaw QQRHMCP CHLOPNCLAW Skill CHLAW CHLAST CHLAST ALLAST: git 是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

RHMCP Skill - OpenClaw 专用

概述

RHMCP 的 OpenClaw Skill 包装层，提供智能决策和 Agent 指引。

前置条件

安装 RHMCP：git clone https://github.com/AIRix315/RHMCP.git && cd RHMCP && npm install && npm run build
配置 OpenClaw MCP（见 README.md）
创建 RHMCP 配置：service.json 和 .env

Agent 决策树

场景 → APP 映射

用户请求
    │
    ├─ "生成图片" / "文生图" / "画画"
    │       └─► rh_execute_app({ alias: "qwen-text-to-image", params: { text: "描述" } })
    │
    ├─ "修改图片" / "改图" / "图生图"
    │       └─► rh_execute_app({ alias: "qwen-image-to-image", params: { image: "URL", prompt: "描述" } })
    │
    └─ "更多APP"
            └─► rh_list_apps() 查看所有可用APP

参数映射

文生图 (qwen-text-to-image)

参数	必填	默认值	说明
`text`	✅	-	提示词
`width`	❌	1024	图片宽度
`height`	❌	1024	图片高度

图生图 (qwen-image-to-image)

参数	必填	默认值	说明
`image`	✅	-	输入图片URL
`prompt`	✅	-	修改提示词

轮询策略

长时间任务使用异步模式：

APP 类型	首次等待	轮询间隔	最大等待
图生视频	3 分钟	1 分钟	15 分钟
数字人	2 分钟	30 秒	10 分钟
文生图	10 秒	5 秒	5 分钟

// 提交异步任务
const { taskId } = await rh_execute_app({
  alias: "image-to-video",
  params: { image: "https://..." },
  mode: "async",
});

// 轮询查询
await sleep(180000); // 3分钟
while (true) {
  const status = await rh_query_task({ taskId });
  if (status.status === "SUCCESS") return status.data;
  if (status.status === "FAILED") throw new Error(status.msg);
  await sleep(60000); // 1分钟
}

存储策略

步骤位置	存储模式	原因
中间步骤	`none`	URL 直接传递
最终输出	`none`	返回 URL，用户保存
用户要求	`network`	用户明确要求保存

// 中间步骤：URL 直接传递
const img = await rh_execute_app({
  alias: "qwen-text-to-image",
  params: { text: "一只猫" },
});

// 后续步骤：使用 URL
const video = await rh_execute_app({
  alias: "image-to-video",
  params: { image: img.outputs[0].originalUrl, motion: "转身" },
});

链式工作流

// 步骤1：文生图
const img = await rh_execute_app({
  alias: "qwen-text-to-image",
  params: { text: "一个女孩在樱花树下" },
});

// 步骤2：图生视频
const video = await rh_execute_app({
  alias: "image-to-video",
  params: {
    image: img.outputs[0].originalUrl,
    motion: "樱花飘落，女孩转身微笑",
  },
});

return { videoUrl: video.outputs[0].originalUrl };

失败重试

const fallbacks = ["sdxl-text-to-image", "flux-text-to-image"];
for (const alias of fallbacks) {
  try {
    return await rh_execute_app({ alias, params });
  } catch (e) {
    continue; // 尝试下一个
  }
}
throw new Error("所有备选 APP 均失败");

错误码速查

错误码	含义	处理方式
`0`	成功	正常返回结果
`804`	排队中	等待后轮询
`805`	任务失败	调整提示词重试
`813`	执行中	继续等待
`421`	并发限制	等待 5 秒后重试

工具清单

工具	用途
`rh_list_apps`	列出所有可用APP
`rh_get_app_info`	获取APP参数详情
`rh_execute_app`	执行APP任务
`rh_query_task`	查询任务状态
`rh_upload_media`	上传媒体文件

模板ID	名称	尺寸	适用场景
`anime-portrait`	动漫人像	1024×1024	角色生成
`landscape-wide`	风景横图	1920×1080	风景创作
`portrait-vertical`	人像竖图	768×1024	人物肖像

故障排除

问题	原因	解决方案
"未找到 alias"	APP 未配置	运行 `rhmcp --update-apps`
"apiKey 是必填项"	未配置 API Key	在 `.env` 设置 `RUNNINGHUB_API_KEY`
"任务超时"	执行时间过长	使用 `mode: "async"`