尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

MediaGo OpenClaw Skill 使用指南:让 AI 编程助手通过自然语言直接下载视频

MediaGo OpenClaw Skill 使用指南:让 AI 编程助手通过自然语言直接下载视频 音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载本篇指南面向希望把 MediaGo 下载能力接入 AI 编程助手的开发者完整讲解 MediaGo OpenClaw Skill 的安装、初始化配置、自然语言调用方式以及它背后封装的 HTTP API 与下载流程。读完本文你将能在 Claude Code、Cursor 等支持 OpenClaw 的 AI 助手中用一句“帮我下载这个视频”完成 m3u8 流媒体、B 站视频和直链视频的下载、进度查询与结果反馈。OpenClaw Skill 是什么MediaGo 提供了面向 OpenClawSkill 定义了触发词、配置读写规则、API 调用方法全部基于curl以及完整的下载工作流。安装之后AI 助手会按 Skill 的指引将你的自然语言请求翻译成对 MediaGo 服务的 REST API 调用从而复用 MediaGo 的下载引擎。从 Skill 元数据可以看到skills/mediago/SKILL.md的 YAML frontmatter它支持的触发词覆盖中英文例如download video、下载视频、下载这个链接、帮我下载、m3u8 download、设置mediago地址、configure mediago、mediago api key且明确要求环境中存在一个正在运行的 MediaGo 实例桌面客户端或 Docker。前提条件在使用前请确认满足以下两点已安装并运行 MediaGo桌面客户端或 Docker 部署均可Skill 通过 HTTP 与它通信因此服务必须处于运行状态且网络可达。已安装支持 OpenClaw 的 AI 编程助手如 Claude Code、Cursor 等且具备执行终端命令与读取本地文件的能力。安装 Skill在终端中执行以下命令从 ClawHub 安装 mediago skillnpx clawhublatest install mediago安装完成后~/.mediago-skill.json是 Skill 的配置文件位置默认不存在需在首次配置时由 AI 助手写入其结构为{ url: http://localhost:8899, apiKey: }其中url是 MediaGo 服务的访问地址apiKey是 Docker 部署模式下的 API 认证密钥桌面客户端模式下通常留空。初始化配置安装后需要告诉 AI 助手你的 MediaGo 服务地址AI 会将其写入~/.mediago-skill.json。若该文件不存在Skill 会引导你完成首次配置skills/mediago/SKILL.md中的 First-time Setup 流程包括安装提示与地址初始化示例。桌面客户端在 AI 助手中直接发送设置 mediago 地址为 http://192.168.x.x:39719桌面客户端的服务端口固定为39719这与核心代码中的默认地址一致——见 apps/core/cmd/cli/main.go 中的defaultBaseURL http://127.0.0.1:39719。若 AI 助手与 MediaGo 运行在同一台机器也可使用http://127.0.0.1:39719。提示你也可以在 MediaGo 桌面客户端的设置 → Skills 设置中找到已生成的配置命令一键复制粘贴即可避免手写端口。DockerDocker 部署启用了 API 认证因此需要同时配置地址和 API Key设置 mediago 地址为 http://localhost:8899api key 为 你的APIKeyDocker 模式的默认端口为8899与 docker-compose.yml 中- 8899:8899的端口映射一致API 认证的密钥由服务端在初始化认证时生成。从源码看认证配置的实现位于 apps/core/internal/api/handler/auth.go首次调用/api/auth/setup时服务端会用 bcrypt 哈希你设置的密码并随机生成一个 UUID 作为 API Key 一并存储。提示API Key 可以在 MediaGo Web 界面的设置 → 更多设置中查看。使用方式配置完成后你可以直接用自然语言下达下载指令例如帮我下载这个视频 https://example.com/video.m3u8下载这个B站视频 https://www.bilibili.com/video/BV1xxxxxxxxdownload this video https://example.com/stream.m3u8Skill 会自动执行四步操作识别视频类型m3u8 / B站 / 直链创建下载任务并开始下载实时报告下载进度下载完成后告诉你文件保存位置视频类型自动识别原理Skill 约定按 URL 特征判断类型skills/mediago/SKILL.md的 Type detection 规则URL 包含bilibili.com或b23.tv判定为bilibili包含.m3u8判定为m3u8其余一律视为direct直链。服务端同样内置了类型推断逻辑可对照 apps/core/internal/core/types.go 中的InferDownloadType它会解析 URL 的 hostname 与 pathname命中b23.tv、bilibili.com及其子域返回bilibili路径以.m3u8结尾返回m3u8否则返回direct。若你明确指定了类型Skill 会优先使用你的指定值。底层下载引擎每一种视频类型在服务端对应独立的下载器二进制见apps/core/internal/core/types.go中BinaryNames映射m3u8 使用N_m3u8DL-RE、B站视频使用BBDown、直链使用aria2c。Skill 只需提交类型与 URL实际的协议解析、分段下载、合并与 ffmpeg 转封装均由 MediaGo 核心完成。支持的视频类型类型说明URL 示例m3u8HLS 流媒体https://example.com/video.m3u8bilibiliB站视频https://www.bilibili.com/video/BVxxxxdirect直链下载https://example.com/video.mp4其他命令你还可以用自然语言管理下载任务查看下载列表 / list downloads查看下载状态 / check download status修改 mediago 地址 / update mediago url更新配置时AI 会读取现有~/.mediago-skill.json仅修改对应字段后写回Skill 中 Updating Config 一节规定的行为。Skill 背后的 HTTP APISkill 的所有下载操作最终都落到 MediaGo 的 REST API 上完整路由注册见 apps/core/internal/api/server/router.go。每轮调用前Skill 都会先从~/.mediago-skill.json读取url与apiKey若配置了apiKey则在请求头中附加-H X-API-Key: API_KEY。该头正是服务端认证中间件优先识别的密钥来源——见 apps/core/internal/api/middleware/auth.go其优先级为X-API-Key头 Authorization: Bearer?token查询参数。健康检查curl -s BASE_URL/healthy服务正常时返回{success:true,...}。对应实现为 apps/core/internal/api/handler/health.go该处理器直接返回Success: true与Status: ok。创建并启动下载任务curl -s -X POST BASE_URL/api/downloads \ -H Content-Type: application/json \ -d {tasks:[{type:TYPE,url:VIDEO_URL,name:NAME}],startDownload:true}请求字段说明type必填m3u8、bilibili或directurl必填视频地址name可选自定义文件名不传时服务端会自动生成响应中的data是创建成功的任务数组取data[0].id作为任务 ID。该接口支持批量创建服务端实现见 apps/core/internal/api/handler/download.go当startDownload为true时会读取配置中的下载目录local与deleteSegments并逐个自动启动任务任务创建后还会通过 SSE 广播download-create事件让所有已连接的客户端实时刷新状态。查询任务状态curl -s BASE_URL/api/downloads/TASK_ID响应data字段包括id、name、status、type、exists、file。status的取值集合与核心枚举一一对应见apps/core/internal/core/types.go中TaskStatus常量pending排队等待、downloading下载中、success成功、failed失败、stopped已停止。查看下载列表curl -s BASE_URL/api/downloads?current1pageSize20响应结构data.total为任务总数data.list为任务数组分页参数current与pageSize控制页码和每页条数。获取配置下载目录等curl -s BASE_URL/api/config返回配置对象其中local字段即下载目录的本地路径下载完成后 AI 会据此告知你文件的保存位置。下载工作流Skill 规范了标准调用流程skills/mediago/SKILL.md的 Download Workflow 一节检查配置读取~/.mediago-skill.json不存在则走首次配置流程。健康检查请求/healthy确认服务可达不可达时提示用户 MediaGo 可能未启动。创建任务POST /api/downloads请求体携带startDownload: true。轮询进度每 3 秒GET /api/downloads/TASK_ID一次将状态反馈给用户。报告结果success→ 告知下载完成文件[路径]failed→ 告知下载失败轮询超过 5 分钟仍进行中 → 告知用户下载仍在继续配套注意事项还包括始终使用与用户相同的语言中文或英文回复API 返回 HTTP 401 时提示用户更新 API Key除非用户明确指定否则总是从 URL 自动推断下载类型未提供name时直接从请求中省略该字段由服务端自动生成文件名。常见问题提示连接不上 MediaGo请依次确认MediaGo 服务已启动配置的地址和端口正确桌面客户端为 39719Docker 为 8899如果是 Docker确认端口映射正确默认 8899可对照 docker-compose.yml 的映射配置且容器内的服务端口已暴露到宿主机。提示 API Key 错误发送以下命令更新密钥设置 mediago api key 为 你的新APIKeyAI 会读取~/.mediago-skill.json并更新apiKey字段。对应地服务端认证中间件在收到错误的X-API-Key时会返回 HTTP 401此时按上文方法更新配置即可。小结MediaGo OpenClaw Skill 将视频下载这一重操作封装成了 AI 助手可理解、可编排的标准流程一条自然语言指令经过 Skill 的类型识别与 API 编排最终交由 MediaGo 的核心下载引擎N_m3u8DL-RE / BBDown / aria2c执行整个过程可查询、可追踪、可复用。如果你已在本地或 Docker 中运行 MediaGo按本文步骤安装 Skill 并配置好服务地址就能立刻在 AI 助手中获得流畅的对话式下载体验。赞分享音视频桌面应用后端【免费下载链接】mediago跨平台视频提取工具支持流媒体下载、视频下载、m3u8 下载及 B站视频下载提供 Windows 和 Mac 桌面客户端。Cross-platform video extraction tool: Supports streaming download, video download, m3u8 download, and Bilibili video download, with desktop clients for Windows and Mac.项目地址https://gitcode.com/caorushizi/mediago点击查看免费下载相关推荐MediaGo OpenClaw Skill 实战用自然语言驱动 m3u8、B 站与直链视频下载MediaGo OpenClaw Skill 实战用自然语言驱动 m3u8、B 站与直链视频下载 MediaGo 通过 OpenClaw Skill 把自然音视频桌面应用后端Repomix Explorer Skill 完整指南让 AI 编程助手用自然语言探索任意代码仓库Repomix Explorer Skill 完整指南让 AI 编程助手用自然语言探索任意代码仓库 Repomix Explorer 是 Repomix 官方开发工具MCP 服务AI 应用SQL Translator让自然语言直接生成SQL查询的AI助手SQL Translator让自然语言直接生成SQL查询的AI助手 还在为复杂的SQL语法头疼吗SQL Translator这个开源工具能够将你的日常语言直AI 应用前端上一篇Awesome Kubernetes 资源项目完全指南打造高效云原生开发环境下一篇ctransformers 终极指南如何在 Python 中快速部署高性能 AI 模型创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表