- name
- rhmcp-skill
- description
- RunningHub AI 智能调用。Use when user wants to generate images, videos, or audio content.
- homepage
- https://github.com/AIRix315/RHMCP
- metadata
- license
- MIT-0
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 | 人物肖像 |
// 使用模板
const templates = require("./references/templates.json");
const t = templates.templates["anime-portrait"];
rh_execute_app({ alias: t.alias, params: { ...t.params, text: "用户描述" } });
故障排除
| 问题 | 原因 | 解决方案 |
|---|
| "未找到 alias" | APP 未配置 | 运行 rhmcp --update-apps |
| "apiKey 是必填项" | 未配置 API Key | 在 .env 设置 RUNNINGHUB_API_KEY |
| "任务超时" | 执行时间过长 | 使用 mode: "async" |
License
MIT-0
