AgentVibes Clawdbot 技能 - local-gen-tts 集成

版本: 1.0.0
作者: Paul Preibisch
仓库: https://github.com/paulpreibisch/AgentVibes
许可证: Apache-2.0

概述

自动将 AgentVibes 与 Clawdbot 集成，通过 SSH 在远程设备（Android/Termux、Linux、macOS）上进行本地 TTS（文本转语音）生成。

功能特性

• ✅ 自动 TTS - Clawdbot 的每次回复都会通过 AgentVibes 语音播报
• ✅ 远程生成 - 文本发送到 Android/设备，音频在本地生成
• ✅ 完整功能 - 支持语音效果、混响、背景音乐
• ✅ 低带宽 - 仅通过 SSH 传输文本（约 1-5 KB）
• ✅ 安全 - SSH 密钥认证，推荐使用 Tailscale VPN

先决条件

服务器端（Clawdbot）

• 已安装并运行 Clawdbot
• 具备远程设备的 SSH 访问权限
• 工作空间目录（例如 ~/clawd）

远程设备端（Android/Linux/macOS）

• 运行 SSH 服务器（sshd）
• 已安装 Node.js（用于自动安装 AgentVibes）
• Tailscale（可选，但推荐使用）

注意： AgentVibes 会在设置过程中自动安装在服务器和远程设备上。

安装

首要步骤：SSH 设置 ⚠️

在运行技能设置之前，必须先设置好到远程设备的 SSH 连接：

1. 生成 SSH 密钥（如果尚未拥有）：

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ''

2. 将密钥复制到远程设备：

ssh-copy-id -i ~/.ssh/id_ed25519.pub user@remote-ip

3. 测试 SSH 连接（无需密码）：

ssh android "echo Connected"
# 应输出：Connected

4. 添加到 ~/.ssh/config（可选，但推荐）：

Host android
    HostName your-device-ip
    User your-username
    Port 22

SSH 连接正常后，继续安装。

快速安装

运行安装脚本：

npx agentvibes install-clawdbot-skill

手动安装

1. 运行设置脚本（AgentVibes 会自动安装在服务器和远程设备上）：

cd ~/.npm-global/lib/node_modules/agentvibes

# 设置 Clawdbot 工作空间
export CLAWDBOT_WORKSPACE=~/clawd

# 设置 SSH 远程主机（可选，默认为 'android'）
export AGENTVIBES_SSH_HOST=android

# 运行设置 - 如果需要，AgentVibes 将自动安装
bash skills/clawdbot/setup.sh

设置脚本将：
- ✅ 在服务器上安装 AgentVibes（如果尚未安装）
- ✅ 创建 TTS 钩子和脚本
- ✅ 通过 SSH 连接到远程设备并自动安装 AgentVibes
- ✅ 配置所有必要的文件和权限

安装内容

1. TTS 钩子 (<workspace>/.claude/hooks/play-tts.sh)

由 Clawdbot 为每个 TTS 响应自动调用：

#!/usr/bin/env bash
# AgentVibes Clawdbot TTS 钩子
TEXT="${1:-}"
VOICE="${2:-en_US-kristin-medium}"
[[ -z "$TEXT" ]] && exit 0
bash "$WORKSPACE/local-gen-tts.sh" "$TEXT" "$VOICE" &
exit 0

2. 本地生成脚本 (<workspace>/local-gen-tts.sh)

将文本发送到远程设备进行本地 AgentVibes 生成：

#!/usr/bin/env bash
# AgentVibes local-gen-tts
ANDROID_HOST="android"
TEXT="${1:-}"
VOICE="${2:-en_US-kristin-medium}"

ssh "$ANDROID_HOST" "bash ~/.termux/agentvibes-play.sh '$TEXT' '$VOICE'" &

3. 远程接收器 (~/.termux/agentvibes-play.sh)

安装在 Android/远程设备上：

#!/usr/bin/env bash
# AgentVibes SSH 接收器
TEXT="$1"
VOICE="${2:-en_US-ryan-high}"
export AGENTVIBES_NO_REMINDERS=1
export AGENTVIBES_RDP_MODE=false

AGENTVIBES_ROOT="/data/data/com.termux/files/usr/lib/node_modules/agentvibes"
bash "$AGENTVIBES_ROOT/.claude/hooks/play-tts.sh" "$TEXT" "$VOICE"

4. 配置文件 (<workspace>/.claude/)

• tts-provider.txt → piper
• tts-voice.txt → 语音名称（例如 en_US-kristin-medium）
• ssh-remote-host.txt → SSH 主机名（例如 android）

配置

语音选择

女声：
- en_US-kristin-medium - 专业、中性（推荐）
- en_US-lessac-medium - 温暖、富有表现力
- en_US-amy-medium - 友好、对话式
- en_US-libritts-high - 清晰、高质量

男声：
- en_US-ryan-high - 充满活力、清晰（推荐）
- en_US-joe-medium - 休闲
- en_US-bryce-medium - 专业

音频效果（可选）

在远程设备上配置：

# 在 Android/远程设备上
nano ~/.local/share/agentvibes/.claude/config/audio-effects.cfg

添加：

# 语音|混响|音乐|音量
en_US-kristin-medium|reverb 50 50 90|agentvibes_soft_flamenco_loop.mp3|0.10
en_US-ryan-high|reverb 50 50 90|agent_vibes_bachata_v1_loop.mp3|0.10

SSH 设置

添加到 ~/.ssh/config：

Host android
    HostName 100.115.27.58  # Tailscale IP
    User u0_a484
    Port 52847
    IdentityFile ~/.ssh/android_key

使用

安装完成后，完全自动运行：

你："你好 Clawdbot"
Clawdbot："你好！"
→ 自动在 Android 上播放，带语音和效果

无需手动命令！

架构

┌─────────────────────────────────────┐
│ Clawdbot (服务器)                   │
│ ├─ 生成文本响应                     │
│ ├─ 调用 .claude/hooks/play-tts.sh  │
│ ├─ 调用 local-gen-tts.sh           │
│ └─ 通过 SSH 发送文本               │
└─────────────────────────────────────┘
              ↓ SSH/Tailscale
┌─────────────────────────────────────┐
│ Android/远程设备                    │
│ ├─ 接收文本                         │
│ ├─ AgentVibes (Piper TTS)          │
│ ├─ 本地生成音频                     │
│ ├─ 应用混响 + 音乐                  │
│ └─ 在扬声器上播放                   │
└─────────────────────────────────────┘

多实例支持

对于多个 Clawdbot 实例（例如 Orian + Samuel）：

# Orian (工作空间: ~/clawd)
export CLAWDBOT_WORKSPACE=~/clawd
export AGENTVIBES_VOICE=en_US-kristin-medium
bash skills/clawdbot/setup.sh

# Samuel (工作空间: ~/clawd2)
export CLAWDBOT_WORKSPACE=~/clawd2
export AGENTVIBES_VOICE=en_US-ryan-high
bash skills/clawdbot/setup.sh

每个实例可以拥有：
- 不同的语音
- 不同的背景音乐
- 不同的音频效果

故障排除

远程设备无音频

# 检查 SSH 连接
ssh android "echo 'Connected'"

# 直接测试接收器
ssh android "bash ~/.termux/agentvibes-play.sh 'Test' 'en_US-kristin-medium'"

TTS 未自动触发

# 检查钩子是否存在
ls -la $CLAWDBOT_WORKSPACE/.claude/hooks/play-tts.sh

# 检查提供程序设置
cat $CLAWDBOT_WORKSPACE/.claude/tts-provider.txt
# 应输出：piper

播放错误语音

# 检查语音配置
cat $CLAWDBOT_WORKSPACE/.claude/tts-voice.txt

# 更新语音
echo "en_US-kristin-medium" > $CLAWDBOT_WORKSPACE/.claude/tts-voice.txt

卸载

# 移除 TTS 集成
rm -rf $CLAWDBOT_WORKSPACE/.claude/hooks
rm $CLAWDBOT_WORKSPACE/.claude/tts-provider.txt
rm $CLAWDBOT_WORKSPACE/.claude/tts-voice.txt
rm $CLAWDBOT_WORKSPACE/local-gen-tts.sh

# 在远程设备上
ssh android "rm ~/.termux/agentvibes-play.sh"

安全性

• ✅ 仅 SSH 密钥认证（无密码）
• ✅ 仅传输文本（无可执行代码）
• ✅ 推荐使用 Tailscale VPN
• ✅ 可配置 SSH 端口（使用非标准端口）

性能

• 延迟： 约 5-8 秒（文本 → 音频 → 播放）
• 带宽： 每条消息约 1-5 KB（仅文本）
• 质量： 完整的神经 TTS 带效果
• 可靠性： 后台执行，非阻塞

示例

基本设置（Orian）

# 1. 在服务器上安装
cd ~/.npm-global/lib/node_modules/agentvibes
CLAWDBOT_WORKSPACE=~/clawd AGENTVIBES_SSH_HOST=android bash skills/clawdbot/setup.sh

# 2. 在 Android 上安装接收器
ssh android "curl -sSL https://raw.githubusercontent.com/paulpreibisch/AgentVibes/main/scripts/install-ssh-receiver.sh | bash"

# 3. 完成！向 Clawdbot 发送消息

高级设置（多实例不同音乐）

# Orian - Kristin + 弗拉门戈
CLAWDBOT_WORKSPACE=~/clawd \
AGENTVIBES_VOICE=en_US-kristin-medium \
AGENTVIBES_MUSIC=agentvibes_soft_flamenco_loop.mp3 \
bash skills/clawdbot/setup.sh

# Samuel - Ryan + 巴恰塔
CLAWDBOT_WORKSPACE=~/clawd2 \
AGENTVIBES_VOICE=en_US-ryan-high \
AGENTVIBES_MUSIC=agent_vibes_bachata_v1_loop.mp3 \
bash skills/clawdbot/setup.sh

支持项目

⭐ 喜欢 AgentVibes？ 为仓库加星以支持项目：
👉 https://github.com/paulpreibisch/AgentVibes

您的星标有助于其他开发者发现这个项目！

贡献

发现错误或有建议？请提交问题：
https://github.com/paulpreibisch/AgentVibes/issues

许可证

Apache-2.0 - 详见 LICENSE 文件

致谢

• AgentVibes: Paul Preibisch
• Clawdbot 集成: 与 Claude AI 共同开发
• Piper TTS: Rhasspy/Home Assistant

版本: 1.0.0
最后更新: 2026-01-30
状态: 生产就绪 ✅