# Mp4 To Mp3 Extractor

Adopt this skill: https://proskills.md/skills/other/mp4-to-mp3-extractor

Page: https://proskills.md/skills/other/mp4-to-mp3-extractor
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .gitignore
upstream: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/.gitignore

Content is not inlined in the catalog. Read the upstream file: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/.gitignore

## File: LICENSE
upstream: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/LICENSE

Content is not inlined in the catalog. Read the upstream file: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/LICENSE

## File: README.md
upstream: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/README.md

```text
# **🎵 MP4 to MP3 Extractor (OpenClaw Skill)**

**高效、智能的本地音频提取工具** 这是一个为 [OpenClaw](https://github.com/openclaw/openclaw) 量身定制的自动化 Skill。它能递归扫描目录，利用 FFmpeg 将 .mp4 视频提取为高质量 .mp3 音频，同时**完美保留原始文件夹层级结构**。

## **✨ 核心特性**

* **📂 完美的结构保持**：自动映射源目录的多级子文件夹到目标目录，确保输出井然有序。  
* **🤖 自动化环境 (Self-bootstrapping)**：  
  * 首次运行自动创建 venv 虚拟环境。  
  * 智能兼容 Windows (Scripts/python.exe) 与 Linux/macOS 环境。  
  * 隔离运行，不污染全局 Python 环境。  
* **⚡ 工业级音频处理**：直接调用系统级 FFmpeg，默认输出 **192kbps** 高质量音频。  
* **📝 智能日志系统**：采用滚动日志技术，**仅保留最近 3 天记录**，平衡审计需求与磁盘空间。  
* **🧠 语义化调用**：深度集成 OpenClaw，Agent 可精准理解意图并自动推断路径。

## **🛠️ 环境依赖 (必读)**

在运行此 Skill 之前，请确保宿主机已安装：

1. **Python 3.8+**（建议安装 python3-venv 支持）。  
2. **FFmpeg**：必须添加到系统环境变量 PATH 中。  
   * *验证：终端输入 ffmpeg \-version 有输出即视为正常。*

**⚠️ 常见排错：若 Skill 状态显示为 blocked**

这通常是因为 OpenClaw 找不到 python 路径。

**修复步骤 (Linux示例)：**

\# 1\. 安装 venv 支持  
sudo apt update && sudo apt install python3-venv  
\# 2\. 建立软链接 (路径请根据实际 Python 安装位置修改)  
sudo ln \-s /usr/bin/python3 /usr/bin/python  
\# 3\. 重启服务  
systemctl \--user restart openclaw-gateway

## **🚀 安装指南**

### **1\. 自动安装 (CLI)**

根据你的环境执行以下命令：

**Linux / macOS:**

\# 视实际安装路径而定  
npx skills add \[https://github.com/wangminrui2022/mp4-to-mp3-extractor\](https://github.com/wangminrui2022/mp4-to-mp3-extractor)

**Windows:**

npx skills add D:\\path\\to\\mp4-to-mp3-extractor

### **2\. 重启生效**

安装完成后，进入 OpenClaw 目录重启 Gateway 即可在技能列表中看到它。

## **💻 使用方法**

### **命令行手动测试**

\# 进入技能目录  
cd \~/.openclaw/skills/mp4-to-mp3-extractor/

\# 运行转换脚本 (Linux)  
python scripts/extract.py "/path/to/videos" "/path/to/audio"

\# 运行转换脚本 (Windows)  
python scripts\\extract.py "F:\\Videos" "F:\\Audio"

### **在 OpenClaw 聊天中**

你可以直接对你的 Agent 说：

请使用 mp4-to-mp3-extractor 技能，将 "F:\命理学" 目录下的所有视频转换为 MP3，输出到 "F:\命理学-音频"。

## **📁 存储说明**

* **代码目录**：\~/.openclaw/skills/mp4-to-mp3-extractor/  
* **日志查看**：执行过程中的详细日志可在技能目录下的 logs/ 文件夹中找到。
```

## File: SKILL.md
upstream: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/SKILL.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/SKILL.md

## File: scripts
upstream: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/scripts

Content is not inlined in the catalog. Read the upstream file: https://github.com/wangminrui2022/mp4-to-mp3-extractor/blob/HEAD/scripts