rk-tts

name	rk-tts
description	将文本转换为语音。当用户要求“转成音频”、“生成语音文件”、“朗读出来”、“播报这段话”、“念出来”、“TTS”时使用。除非用户明确指定云端TTS、远端服务或特定在线模型，否则默认优先使用本地rk-tts。

文本转语音技能

• 播放意图优先规则： 只要用户明确出现“直接播放”“播放一下”“播出来”“朗读”“念出来”“语音播报”“当场播”“实时播放”等表达，就应当优先判定为板端播放需求，直接使用./run.sh --play。 不要因为同时出现“音频”“TTS”“转语音”这些词，就退回到默认的生成文件模式。

• 默认选择规则： 当用户只是泛泛地提到“TTS”“转语音”“朗读”“播报”“生成语音”时，默认优先使用本地rk-tts。 只有当用户明确指定云端TTS、远端API、在线模型、model hub，或者明确要求不要使用本地TTS时，才不要使用这个技能。

• 先判断用户意图是“要一个音频文件”，还是“要板端当场播放”。 其中“直接播放”“朗读”“念出来”“播报一下”应视为明确播放，不要按文件模式处理。

• 当前默认约定： 音频文件输出路径为/userdata/output.wav 板端播放入口为./run.sh --play 默认耳机播放设备为plughw:CARD=rockchipes8388,DEV=0 HTTP取音频与本地播放逻辑统一由tts_client.py处理

• 当用户需要将文字转为音频文件、保存音频、发送音频文件时使用 在终端中执行以下命令进行语音合成：

cd ~/.openclaw/workspace/skills/rk-tts/scripts && ./run.sh "text to tts"

• 当用户需要播放、直接播放、朗读、念出来、语音播报某段文字时使用 在终端中执行以下命令进行语音合成并在板端播放：

cd ~/.openclaw/workspace/skills/rk-tts/scripts && ./run.sh --play "text to tts and play"

执行命令后的处理规则：

情况A - 生成音频文件： → 输出音频保存在/userdata/output.wav → 直接将该绝对路径的音频文件发送给用户 → 不需要再额外解释文件内容

情况B - 板端直接播放： → 只需告知用户已经在板端播放 → 不需要再发送音频文件，除非用户明确要求

情况C - 本地tts_server不可用： → run.sh会自动尝试启动本地tts_server → 若仍不可用，保存模式会回退到板端自带的rocktts_demo逻辑 → 若仍不可用，播放模式会回退到板端自带的播放demo逻辑 → 继续按最终执行结果处理

• 如果用户没有明确说“播放”或“朗读”，默认优先走音频文件模式。

• 如果用户既要求“播放一下”又要求“把音频给我”，优先先播放，再按需补发音频文件；不要因为提到了“把音频给我”就放弃本次播放动作。

• 如果用户没有明确指定云端TTS来源，默认不要切到云端能力，直接使用本地rk-tts完成任务。