← Back to Skills Marketplace
edge-tts-auto
by
IiaWhite-Sir
· GitHub ↗
· v1.0.0
· MIT-0
64
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install edge-tts-auto
Description
自动安装依赖并将输入文本转换为中文女声 MP3,兼容 OpenClaw,无需手动配置环境。
README (SKILL.md)
edge-tts-auto 文本转语音技能\r
---\r
📌 技能简介\r
edge-tts-auto 是一个 OpenClaw 原生兼容 的文本转语音技能,支持自动安装依赖,无需手动配置环境。\r
- 自动安装
pipx+edge-tts\r - 支持中文女声(
zh-CN-XiaoxiaoNeural)\r - 输出为标准 MP3 文件,可直接导入剪映等工具\r
- 适配 OpenClaw 2026.4.15 版本\r \r ---\r \r
📁 目录结构\r
~/.openclaw/skills/edge-tts-auto/\r
├── skill.json # 技能配置文件\r
├── main.sh # 执行脚本(含自动安装逻辑)\r
└── skill.md # 本文档\r
```\r
\r
---\r
\r
## ⚙️ 安装方法\r
1. **复制技能目录**\r
将整个 `edge-tts-auto` 文件夹复制到:\r
```bash\r
~/.openclaw/skills/\r
```\r
\r
2. **赋予执行权限**\r
```bash\r
chmod +x ~/.openclaw/skills/edge-tts-auto/main.sh\r
```\r
\r
3. **重启 OpenClaw 网关**\r
```bash\r
openclaw gateway restart\r
```\r
\r
---\r
\r
## 🚀 使用方法\r
### 1. 自然语言调用(推荐)\r
在 OpenClaw 对话中直接使用:\r
```\r
把下面这段文字转成语音,保存到桌面:\r
“你好,这是一段由 edge-tts-auto 生成的测试语音。”\r
```\r
\r
### 2. 命令行调用\r
```bash\r
openclaw skill run edge-tts-auto \\r
--text "你好,世界" \\r
--output_path "/mnt/c/Users/你的用户名/Desktop/voice.mp3"\r
```\r
\r
---\r
\r
## 🔧 参数说明\r
| 参数 | 必填 | 说明 | 示例 |\r
| :--- | :--- | :--- | :--- |\r
| `text` | ✅ | 要转换的文本内容 | `"欢迎使用 edge-tts-auto"` |\r
| `output_path` | ✅ | 输出 MP3 的完整路径 | `"/mnt/c/Users/xxx/Desktop/voice.mp3"` |\r
\r
---\r
\r
## ✨ 自动安装逻辑\r
第一次运行时,脚本会自动执行以下操作:\r
1. 更新系统包列表\r
2. 安装 `pipx` 和 `jq`\r
3. 配置 `pipx` 环境变量\r
4. 安装 `edge-tts` 工具\r
5. 调用 `edge-tts` 生成语音\r
\r
---\r
\r
## 🎯 常见问题\r
### 1. 权限不足报错\r
执行:\r
```bash\r
chmod +x ~/.openclaw/skills/edge-tts-auto/main.sh\r
```\r
\r
### 2. 找不到 `edge-tts`\r
重启 OpenClaw 网关后重试,脚本会自动完成安装。\r
\r
### 3. 输出文件无法在 Windows 打开\r
确保 `output_path` 是 WSL 可访问的 Windows 目录,例如:\r
`/mnt/c/Users/你的用户名/Desktop/voice.mp3`\r
\r
---\r
\r
## 📄 许可证\r
MIT License,可自由修改和分发。
Usage Guidance
This skill appears to do what it claims, but it will run sudo apt to install packages and pipx to fetch edge-tts from PyPI. Before installing: ensure you trust installing packages from your distribution repos and PyPI; be prepared to enter your sudo password; note the script assumes a Debian/Ubuntu environment and will modify your shell PATH via pipx ensurepath (it sources ~/.bashrc). If you prefer safer testing, run the script manually in a controlled environment (VM or container) first, or remove/inspect the install steps and install pipx/edge-tts yourself ahead of time.
Capability Analysis
Type: OpenClaw Skill
Name: edge-tts-auto
Version: 1.0.0
The skill's execution script (main.sh) performs high-risk system-level operations, including 'sudo apt update' and 'sudo apt install', to facilitate its 'auto-install' feature. Furthermore, the script lacks input validation for the 'output_path' parameter, which could be exploited to overwrite sensitive files (e.g., configuration files or SSH keys) with MP3 data. While these actions align with the stated purpose in skill.md, the use of sudo and the potential for arbitrary file writes represent significant security risks in an automated agent environment.
Capability Assessment
Purpose & Capability
The skill name/description (auto-install + convert text to MP3 using edge-tts) matches the included script and metadata. Installing pipx and edge-tts is a reasonable requirement for this functionality.
Instruction Scope
The runtime script only parses JSON input, installs system packages, and invokes edge-tts. It does require sudo to run apt and modifies the user's shell PATH via pipx ensurepath (sources ~/.bashrc). This is within the expected scope for an auto-installing TTS helper, but it performs system-level changes (package installs and PATH changes) that may be surprising.
Install Mechanism
There is no separate installer; the included script runs apt (sudo apt update; sudo apt install -y pipx jq) and pipx install edge-tts (PyPI). These are standard mechanisms (distribution package manager + PyPI). Risk is moderate only because it performs network installs and requires elevated privileges; no unusual or external URLs are used.
Credentials
The skill does not request credentials or environment variables. The script does rely on sudo privileges and a Debian/Ubuntu-style package manager (apt). That privilege need is explainable by the auto-install behavior but is a notable operational requirement.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills. It does, however, perform system-wide installs and invoke pipx ensurepath (which updates shell config). This grants it the ability to change the user's environment, so run with that understanding.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install edge-tts-auto - After installation, invoke the skill by name or use
/edge-tts-auto - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
# edge-tts-auto 文本转语音技能
---
## 📌 技能简介
`edge-tts-auto` 是一个 **OpenClaw 原生兼容** 的文本转语音技能,支持自动安装依赖,无需手动配置环境。
- 自动安装 `pipx` + `edge-tts`
- 支持中文女声(`zh-CN-XiaoxiaoNeural`)
- 输出为标准 MP3 文件,可直接导入剪映等工具
- 适配 OpenClaw 2026.4.15 版本
---
## 📁 目录结构
```
~/.openclaw/skills/edge-tts-auto/
├── skill.json # 技能配置文件
├── main.sh # 执行脚本(含自动安装逻辑)
└── skill.md # 本文档
```
---
## ⚙️ 安装方法
1. **复制技能目录**
将整个 `edge-tts-auto` 文件夹复制到:
```bash
~/.openclaw/skills/
```
2. **赋予执行权限**
```bash
chmod +x ~/.openclaw/skills/edge-tts-auto/main.sh
```
3. **重启 OpenClaw 网关**
```bash
openclaw gateway restart
```
---
## 🚀 使用方法
### 1. 自然语言调用(推荐)
在 OpenClaw 对话中直接使用:
```
把下面这段文字转成语音,保存到桌面:
“你好,这是一段由 edge-tts-auto 生成的测试语音。”
```
### 2. 命令行调用
```bash
openclaw skill run edge-tts-auto \
--text "你好,世界" \
--output_path "/mnt/c/Users/你的用户名/Desktop/voice.mp3"
```
---
## 🔧 参数说明
| 参数 | 必填 | 说明 | 示例 |
| :--- | :--- | :--- | :--- |
| `text` | ✅ | 要转换的文本内容 | `"欢迎使用 edge-tts-auto"` |
| `output_path` | ✅ | 输出 MP3 的完整路径 | `"/mnt/c/Users/xxx/Desktop/voice.mp3"` |
---
## ✨ 自动安装逻辑
第一次运行时,脚本会自动执行以下操作:
1. 更新系统包列表
2. 安装 `pipx` 和 `jq`
3. 配置 `pipx` 环境变量
4. 安装 `edge-tts` 工具
5. 调用 `edge-tts` 生成语音
---
## 🎯 常见问题
### 1. 权限不足报错
执行:
```bash
chmod +x ~/.openclaw/skills/edge-tts-auto/main.sh
```
### 2. 找不到 `edge-tts`
重启 OpenClaw 网关后重试,脚本会自动完成安装。
### 3. 输出文件无法在 Windows 打开
确保 `output_path` 是 WSL 可访问的 Windows 目录,例如:
`/mnt/c/Users/你的用户名/Desktop/voice.mp3`
---
## 📄 许可证
MIT License,可自由修改和分发。
Metadata
Frequently Asked Questions
What is edge-tts-auto?
自动安装依赖并将输入文本转换为中文女声 MP3,兼容 OpenClaw,无需手动配置环境。 It is an AI Agent Skill for Claude Code / OpenClaw, with 64 downloads so far.
How do I install edge-tts-auto?
Run "/install edge-tts-auto" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is edge-tts-auto free?
Yes, edge-tts-auto is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does edge-tts-auto support?
edge-tts-auto is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created edge-tts-auto?
It is built and maintained by IiaWhite-Sir (@iiawhite-sir); the current version is v1.0.0.
More Skills