edge-tts-auto

自动安装依赖并将输入文本转换为中文女声 MP3，兼容 OpenClaw，无需手动配置环境。

Security Scan

The skill is internally consistent for a local text-to-speech tool: its script auto-installs pipx and edge-tts and then runs the TTS conversion; nothing in the files indicates unexplained credential access or hidden endpoints.

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.

Assessment

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.

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 文件夹复制到：

   ~/.openclaw/skills/
   

2. 赋予执行权限

   chmod +x ~/.openclaw/skills/edge-tts-auto/main.sh
   

3. 重启 OpenClaw 网关

   openclaw gateway restart
   

---

🚀 使用方法

1. 自然语言调用（推荐）

在 OpenClaw 对话中直接使用：

把下面这段文字转成语音，保存到桌面：
“你好，这是一段由 edge-tts-auto 生成的测试语音。”

2. 命令行调用

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. 权限不足报错

执行：

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，可自由修改和分发。