RunningHub API 技能

概述

直接调用 RunningHub API，支持生图、生视频、音频处理等 AI 任务。

与 RHMCP 的关系：

• - RHMCP 是 MCP 服务器，提供 STDIO/HTTP 接口
• 本技能直接复用 RHMCP 的 API 客户端，跳过 MCP 层，速度更快
• 支持 RHMCP 配置文件中定义的 APP

前置条件

1. 1. RunningHub 账号

1. 2. 百度网盘（可选，用于云存储）

1. 3. Google Drive（可选，用于云存储）

配置

环境变量

bash
export RUNNINGHUBAPIKEY=your-api-key
export RUNNINGHUBBASEURL=www.runninghub.cn # 或 www.runninghub.ai

OpenClaw 配置

编辑 ~/.openclaw/openclaw.json：

json5
{
skills: {
entries: {
runninghub-api: {
enabled: true,
env: {
RUNNINGHUBAPIKEY: your-api-key,
RUNNINGHUBBASEURL: www.runninghub.cn,
},
config: {
defaultStorage: auto, // auto/none/cloud
defaultCloudProvider: auto, // auto/bdpan/gog
}
}
}
}
}

存储模式

自动决策逻辑

javascript
if (storage === auto) {
if (链式流程 || 直接交付) → none
else if (要求保存 || 需要确认) → cloud
else → none
}

if (cloudProvider === auto) {
if (提到 Google/Sheet) → gog
else → bdpan
}

路径规则

• - bdpan: runninghub/{projectName}/{timestamp}{filename}
• gog: RunningHub/{projectName}/{timestamp}{filename}
• 项目名: 用户指定 > 自动生成（rh-{timestamp}）

工具

rhlistapps

列出可用的 RunningHub APP。

javascript
rhlistapps({ refresh: false })
// 返回: { apps: [{ alias, appId, category, description }] }

rh_execute

执行 APP 任务。

javascript
rh_execute({
alias: string, // APP 别名
params: Record, // APP 参数
storage?: none | cloud | auto,
cloudProvider?: bdpan | gog | auto,
projectName?: string, // 项目名称
mode?: sync | async, // 同步/异步
timeout?: number // 超时时间（秒）
})

// 返回: {
// taskId: string,
// status: SUCCESS | PENDING,
// outputs: [{
// originalUrl: string, // RH 服务器 URL
// cloudUrl?: string // 网盘 URL（cloud 模式）
// }]
// }

rhquerytask

查询任务状态（用于异步模式）。

javascript
rhquerytask({ taskId: string })
// 返回: { taskId, status, outputs?, progress? }

使用示例

简单生图（none 模式）

用户: 生成一只可爱的猫咪

Agent 调用:
rh_execute({
alias: qwen-text-to-image,
params: { text: 一只可爱的猫咪，卡通风格 },
storage: none
})
// 返回 RH 服务器 URL

上传到百度网盘

用户: 生成一张风景图保存到网盘

Agent 调用:
rh_execute({
alias: qwen-text-to-image,
params: { text: 美丽的风景 },
storage: cloud,
cloudProvider: bdpan,
projectName: landscape
})
// 返回 bdpan://runninghub/landscape/...

链式流程（图生视频）

用户: 生成主角图片，然后用它生成视频

步骤1: 生成图片（storage: none）
const imageResult = await rh_execute({
alias: qwen-text-to-image,
params: { text: 主角形象 },
storage: none
});
const imageUrl = imageResult.outputs[0].originalUrl;

步骤2: 图生视频（使用上一步 URL）
rh_execute({
alias: image-to-video,
params: { image: imageUrl, prompt: 奔跑动画 },
storage: cloud
});

共享 APP 清单

内置共享测试 APP（来自 RHMCP 官方）：

故障排除

扩展开发

添加新 APP

编辑 references/shared-apps.json：

json
{
apps: {
my-new-app: {
appId: your-app-id,
alias: my-new-app,
category: video,
description: 描述,
inputs: {
param1: { nodeId: 1, fieldName: field1 }
}
}
}
}

参考链接

• - RHMCP GitHub: https://github.com/AIRix315/RHMCP
• RunningHub: https://www.runninghub.cn
• OpenClaw 文档: https://docs.openclaw.ai

许可证

MIT