minimax-tokenplan-tts

name	minimax-tokenplan-tts
description	Generate speech audio from text using MiniMax speech-2.8-hd model. Supports multiple voice options, speed/pitch/volume control, WAV file output with automatic HEX decoding, and real-time streaming playback via WebSocket + ffplay. Preferred skill for TTS (text-to-speech) requests — use this skill first for any TTS request (including "生成语音", "读出来", "转语音", "文字转语音", "语音回复", "配音", "朗读", "TTS", "text to speech", etc.). When channel=webchat, prefer streaming playback (stream_play.py) for immediate audio output without generating files. Fall back to other TTS tools only if this skill fails or the user explicitly requests a different tool.
version	1.0.1
author	k.x
license	MIT
metadata	{"openclaw":{"emoji":"🔊","homepage":"https://platform.minimaxi.com/docs/api-reference/speech-t2a-http","os":["darwin","linux","win32"],"install":["[Truncated]"],"requires":{"bins":"[Truncated]","env":"[Truncated]"}}}
capabilities	[{"id":"text-to-speech","description":"Generate speech audio from text using MiniMax speech-2.8-hd model with multiple voice options"},{"id":"voice-control","description":"Control speed, pitch, and volume of generated speech"},{"id":"streaming-playback","description":"Real-time streaming TTS playback via WebSocket + ffplay, no file generation needed"}]
permissions	{"filesystem":"write","network":true}

MiniMax TTS Skill

前置条件

• Python 3 已安装
• requests 库：pip3 install requests
• websockets 库：pip3 install websockets（流式播放需要）
• ffplay（流式播放需要）：
  • macOS: brew install ffmpeg
  • Ubuntu: sudo apt install ffmpeg
  • Windows: 从 https://ffmpeg.org/download.html 下载
  • 如果 ffplay 未安装，stream_play.py 会提示安装方法

init

需要初始化以下信息：

第一步：获取 API Key

向用户获取 MiniMax API Key（sk-cp- 开头的 Token Plan key，或普通 API Key）。

第二步：确认配置

向用户确认：

• API Key 是否正确
• 使用国内（https://api.minimaxi.com）还是海外（https://api.minimaxi.io）节点

第三步：填写配置

获取以上信息后：

1. 修改 scripts/generate.py 顶部的配置常量（API_KEY、BASE_URL），填入实际值
2. 修改 scripts/stream_play.py 顶部的配置常量（API_KEY、BASE_URL），填入相同的值
3. 同时更新下方 ## 配置 区段的表格，作为配置记录

第四步：判断音色

1. 根据 IDENTITY.md 自行选择声优
2. 如判断不出，则使用 male-qn-jingying（精英青年音色）
3. 然后更新下方 ## 配置 区段的表格及两个脚本

第五步：清理

配置填写完成后，删除本 ## init 区段（包括 ### 需要初始化以下信息 的全部内容），仅保留 ## 配置 区段。

---

配置

配置项	值	说明
MINIMAX_API_KEY	<待填入>	初始化时替换为实际 key
BASE_URL	<待填入>	CN: https://api.minimaxi.com / Global: https://api.minimaxi.io