Skills rhmcp-skill

RunningHub AI 智能调用。Use when user wants to generate images, videos, or audio content.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/airix315/runninghub-skill" ~/.claude/skills/clawdbot-skills-rhmcp-skill && rm -rf "$T"

manifest: skills/airix315/runninghub-skill/SKILL.md

source content

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`	上传媒体文件

故障排除

问题原因解决方案

"未找到 alias"

APP 未配置

运行

rhmcp --update-apps

"apiKey 是必填项"

未配置 API Key

在

.env

设置

RUNNINGHUB_API_KEY

"任务超时"

执行时间过长

使用

mode: "async"

License

MIT-0

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