前言¶

让 agent 边干活边说话，听起来是个小需求，落地时会遇到几个具体问题：不想注册账号、不想按字数付费、不想因为网络抖动把播报打断，也不想换个声音就重新配置一遍。AgentVibes TTS 就是冲着这些问题来的：一套本地优先的 TTS 语音管理 skill，把选声音、设性格、调语速、加背景音这些操作压成一组 /agent-vibes: 命令，命令行里直接敲。

下面介绍这个 skill 是什么、怎么装、能做什么。

这是什么¶

AgentVibes TTS 是给 Claude Code 和 OpenClaw 用的文本转语音技能，作者是 Paul Preibisch（clawhub 上的 @clawhub_paulpreibisch），上游仓库在 https://clawhub.ai/paulpreibisch/agentvibes-openclaw-skill，当前版本 v4.6.6，许可证 MIT-0。SkillHub 页面上的坐标是 @clawhub_paulpreibisch/agentvibes-openclaw-skill，分类 design-media。

它解决的问题是：agent 的输出目前只有文字，读完长任务时没有节奏感；而现成的 TTS 方案要么要账号和 API Key，要么只能在单一平台上用。AgentVibes 走本地合成路线，不需要账号，也不需要 API Key（页面上 requires_api_key=false）。

核心能力¶

覆盖五块，都是页面上写明的能力。

声音¶

内置 Piper TTS 的 914+ 个声音，覆盖 30+ 种语言，另有 macOS 系统语音、Windows SAPI、Soprano 神经语音四类来源。常用默认声音举例：美式英语 en_US-lessac-medium、en_US-amy-medium、en_US-ryan-high；英式 en_GB-alan-medium；法语 fr_FR-siwis-medium；德语 de_DE-thorsten-medium；西班牙语 es_ES-davefx-medium；日语 ja_JP-ayanami-medium；中文 zh_CN-huayan-x_low；韩语 ko_KR-kss-medium。所有声音从 HuggingFace 下载，无需账号。

性格与措辞¶

可以给 TTS 输出挂上性格风格（如 sarcastic、dramatic，用 list 看全部），可以给每条播报加固定前缀，也可以用 verbosity 控制 agent 开口的密度：low 只做简短确认，medium 说关键决定（默认），high 说完整推理过程。

语速与音效¶

语速区间 0.5x 到 3.0x。音效支持 reverb、echo、pitch、eq 四类，各自可单独配置或 reset。

背景音与复听¶

可以开关背景音乐，切换曲目（如 jazz）；mute / unmute 会跨会话保留；replay 可以重放最近 10 条音频，支持指定序号。

语言学习¶

设置母语后，learn on 让 agent 用母语和目标语言各说一遍；translate 把一段文字翻译并朗读出来。

安装与启用¶

安装走 OpenClaw 的 skill 命令，在终端执行：

openclaw skills install @clawhub_paulpreibisch/agentvibes-openclaw-skill

上游页面同时提供 CLI 和 Prompt 两种安装入口，命令行方式就是上面这一条。安装后用 /agent-vibes: 开头的命令调用即可，例如 /agent-vibes:version 看版本、/agent-vibes:whoami 看当前配置。

Claude Code 与 OpenClaw 的差异：这个 skill 是同一个安装命令，差别只在调用侧——它面向 agent 会话内的 slash command 使用，不在脚本里当库 import。

典型用法¶

先挑声音。列出可用声音，可以分页看：

/agent-vibes:list            # 显示全部
/agent-vibes:list first 5    # 前 5 个
/agent-vibes:list last 3     # 最后 3 个

先用音频样本试听，再决定换不换：

/agent-vibes:preview         # 预览前 3 个声音
/agent-vibes:preview 5       # 预览前 5 个
/agent-vibes:preview last 5  # 预览最后 5 个
/agent-vibes:sample en_US-ryan-high

确认后切换，并收藏当前声音：

/agent-vibes:switch en_US-amy-medium
/agent-vibes:get
/agent-vibes:set-favorite-voice

调播报风格和语速：

/agent-vibes:personality list
/agent-vibes:personality sarcastic
/agent-vibes:set-pretext "AgentVibes"
/agent-vibes:set-speed 1.5
/agent-vibes:verbosity low

音效与背景音：

/agent-vibes:effects reverb hall
/agent-vibes:effects reverb none
/agent-vibes:effects reset
/agent-vibes:background-music on
/agent-vibes:background-music switch jazz

语言学习：

/agent-vibes:language japanese
/agent-vibes:learn on
/agent-vibes:translate "今天到这里"

Provider 管理，四种来源按平台切换：

/agent-vibes:provider list
/agent-vibes:provider switch piper
/agent-vibes:provider switch macos
/agent-vibes:provider switch sapi
/agent-vibes:provider switch soprano

清理与更新：

/agent-vibes:cleanup
/agent-vibes:update

适用场景与注意¶

适合这几类场景：想在长任务里用语音跟一下进度，又不希望被云 TTS 的额度和延迟卡住；需要多语言播报或语言学习用途；在 Windows 或 macOS 上想零配置直接出声。

注意几点：Piper 的声音要首次使用时从 HuggingFace 下载，网络不通时这一步会失败；macOS 的 Say 和 Windows 的 SAPI 只能用在各自平台上；语速和音效属于听感偏好，建议先用 preview 试听再批量切换；mute 是持久的，切换会话后仍保持静音，忘记时用 unmute 恢复；cleanup 会删掉缓存的音频文件。

结尾¶

AgentVibes 的价值在于把语音播报从”接一个云服务”变成”敲几条命令”：不需要账号和 API Key，声音选择多，语速、性格、背景音、语言学习这些维度都能就地调整。需要判断它是否合适，先看上游页面的命令清单和 Provider 支持表，再装一条命令试听。

官方地址：https://clawhub.ai/paulpreibisch/agentvibes-openclaw-skill
SkillHub 页面：https://www.skillhub.cn/skills/clawhub_paulpreibisch/agentvibes-openclaw-skill