← Back to Skills Marketplace
mrliugangqiang

Edge Tts Global

by 刘岗强 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install edge-tts-global
Description
Use the globally installed edge-tts command to generate Chinese or multilingual text-to-speech audio on this machine. Use when the user wants text converted...
README (SKILL.md)

Edge TTS Global

Use this skill when the user wants fast text-to-speech with the globally installed edge-tts command.

What is available

Global commands:

  • edge-tts
  • edge-playback

Bundled helper script:

  • scripts/tts_edge.py

Preferred Chinese test voice:

  • zh-CN-XiaoxiaoNeural

Fast workflow

  1. Put output files in the current caller workspace temp/ directory.
  2. Prefer the bundled Python script scripts/tts_edge.py for standard generation.
  3. If needed, call edge-tts directly.
  4. If sending back to Telegram and the user wants a voice bubble, send the audio with message and set asVoice=true.
  5. If the user wants a normal file/audio attachment, send it normally.
  6. After successful sending, immediately delete the generated temporary file.

Preferred script usage

Generate audio to the current caller workspace temp/ directory automatically:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "老板,你好,我是你的小助理。"

Generate audio with explicit relative path under the current caller workspace:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "老板,你好,我是你的小助理。" -o ./temp/out.mp3

Delete temporary file after successful sending:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py cleanup ./temp/out.mp3

Delete both audio and subtitles:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py cleanup ./temp/out.mp3 ./temp/out.vtt

Change voice explicitly:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "你好" -v zh-CN-XiaoxiaoNeural -o ./temp/out.mp3

Generate subtitles too:

python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "你好" -o ./temp/out.mp3 --subs ./temp/out.vtt

Direct command patterns

Generate MP3

mkdir -p ./temp
edge-tts --voice zh-CN-XiaoxiaoNeural --text "老板,你好,我是你的小助理。" --write-media ./temp/out.mp3

List voices

edge-tts --list-voices

Telegram sending rule

If the user asks for “气泡语音”, “语音条”, or a voice-message style result:

  • generate the file first
  • send with message
  • set asVoice=true
  • after successful sending, delete the temporary file immediately

If the user asks for a normal audio file:

  • send as a regular attachment
  • do not set asVoice=true
  • after successful sending, delete the temporary file immediately

Cleanup guidance

  • Temporary outputs belong in the current caller workspace temp/ directory
  • Sending succeeds → delete the generated temporary files immediately
  • Prefer python3 scripts/tts_edge.py cleanup \x3Cfile> [subtitle] for deterministic cleanup
  • Do not remove the global edge-tts install unless the user explicitly asks
Usage Guidance
This skill is coherent and appears safe in purpose: it simply runs the local edge-tts binary via a small Python wrapper and manages temporary files in the caller workspace. Before installing, confirm that you trust the system-level edge-tts binary that will be invoked (the skill executes it as a subprocess), ensure the agent's workspace temp/ directory is appropriate for generated audio, and be aware the helper script will read an undocumented EDGE_TTS_VOICE env var if present. If you plan to run in a different environment, note the SKILL.md examples use an absolute path (/data/claw/shared/...), which may need adjusting.
Capability Analysis
Type: OpenClaw Skill Name: edge-tts-global Version: 1.0.0 The skill bundle is a legitimate wrapper for the 'edge-tts' utility, providing a Python script (scripts/tts_edge.py) and instructions (SKILL.md) for generating and cleaning up audio files. The code uses safe subprocess execution and standard file handling without any signs of data exfiltration, obfuscation, or malicious intent.
Capability Assessment
Purpose & Capability
Name/description match the included files and instructions: the script and SKILL.md invoke the global edge-tts binary to produce TTS output. The only minor mismatch is that the script honors an environment variable EDGE_TTS_VOICE (for a default voice) that is not documented in SKILL.md or listed in requires.env.
Instruction Scope
SKILL.md limits actions to generating audio in the current caller workspace temp/ directory, optionally listing voices, and deleting temporary files after sending. The included script only runs the edge-tts subprocess, creates/removes files under the workspace, and does not read other system files or send data externally.
Install Mechanism
There is no install spec and no remote downloads; the skill is instruction-only plus a small helper script. It requires a preinstalled edge-tts binary (as stated) — this is proportional and low-risk for an instruction-only skill.
Credentials
No credentials or sensitive env vars are requested. The script does read EDGE_TTS_VOICE for a default voice (non-sensitive) but that env var is undocumented in the SKILL.md; otherwise environment access is minimal and proportionate.
Persistence & Privilege
The skill is not always-enabled, does not request persistent elevated privileges, and does not modify other skills or global agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install edge-tts-global
  3. After installation, invoke the skill by name or use /edge-tts-global
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of edge-tts-global - Enables text-to-speech audio generation using the globally installed edge-tts command. - Supports fast, multilingual TTS output (with a focus on Chinese), including Telegram voice-bubble style audio. - Provides bundled helper script (scripts/tts_edge.py) for audio generation, voice selection, and cleanup. - Outputs are stored in the current caller workspace temp/ directory and cleaned up after sending. - Allows selection of voices, MP3 generation, and subtitle creation.
Metadata
Slug edge-tts-global
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Edge Tts Global?

Use the globally installed edge-tts command to generate Chinese or multilingual text-to-speech audio on this machine. Use when the user wants text converted... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.

How do I install Edge Tts Global?

Run "/install edge-tts-global" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Edge Tts Global free?

Yes, Edge Tts Global is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Edge Tts Global support?

Edge Tts Global is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Edge Tts Global?

It is built and maintained by 刘岗强 (@mrliugangqiang); the current version is v1.0.0.

💬 Comments