dlinkclaw-openclaw 1.0.0

package/ext_capabilities/workrelay-speak/workrelay-tts.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+# WorkRelay TTS 桥接脚本 - 调用本地 Voicebox REST API
+# 环境变量：
+#   WR_VOICEBOX_HOST       - Voicebox 服务地址（默认 127.0.0.1）
+#   WR_VOICEBOX_PORT       - Voicebox 端口（默认 17493）
+#   WR_VOICEBOX_PROFILE_ID - 声音 profile ID（可选，缺省时自动解析：
+#                            ① ~/.workrelay/speak/profile_id（install.sh 写入）
+#                            ② 从 Voicebox /profiles 查找 preset profile）
+#   WR_VOICEBOX_ENGINE     - TTS 引擎（可选，缺省时按 profile 的 default_engine 自动匹配）
+#   WR_VOICEBOX_LANG       - 语言（默认 zh）
+
+set -e
+
+TEXT="$1"
+OUT="$2"
+
+if [ -z "$TEXT" ] || [ -z "$OUT" ]; then
+  echo "usage: $0 <text> <output_path>" >&2
+  exit 1
+fi
+
+VB_HOST="${WR_VOICEBOX_HOST:-127.0.0.1}"
+VB_PORT="${WR_VOICEBOX_PORT:-17493}"
+VB_DOCKER_PORT="${WR_VOICEBOX_DOCKER_PORT:-17600}"
+PROFILE_ID="${WR_VOICEBOX_PROFILE_ID:-}"
+ENGINE="${WR_VOICEBOX_ENGINE:-}"
+LANG="${WR_VOICEBOX_LANG:-zh}"
+
+# 自动探测端口
+BASE_URL="http://${VB_HOST}:${VB_PORT}"
+curl -s --max-time 2 "${BASE_URL}/mcp" >/dev/null 2>&1 || {
+  BASE_URL="http://${VB_HOST}:${VB_DOCKER_PORT}"
+  curl -s --max-time 2 "${BASE_URL}/mcp" >/dev/null 2>&1 || {
+    echo "ERROR: Voicebox API 不可达 ($VB_HOST:$VB_PORT / $VB_DOCKER_PORT)" >&2
+    exit 1
+  }
+}
+
+# ── 2026-08-12：profile 自动解析（安装后开箱即用，无需手动传 ID）──
+if [ -z "$PROFILE_ID" ] && [ -f "$HOME/.workrelay/speak/profile_id" ]; then
+  PROFILE_ID=$(cat "$HOME/.workrelay/speak/profile_id" 2>/dev/null | tr -d ' \n')
+fi
+if [ -z "$PROFILE_ID" ]; then
+  # 兜底：从 /profiles 找 preset profile（优先 kokoro + 中文）
+  PROFILE_ID=$(curl --noproxy '*' -s --max-time 5 "$BASE_URL/profiles" 2>/dev/null \
+    | python3 -c '
+import json,sys
+out=""
+try:
+    d=json.load(sys.stdin)
+    for p in d:
+        if p.get("preset_engine")=="kokoro" and p.get("language")=="zh":
+            out=p.get("id",""); break
+    if not out:
+        for p in d:
+            if p.get("voice_type")=="preset":
+                out=p.get("id",""); break
+    print(out)
+except Exception:
+    print("")
+' 2>/dev/null)
+fi
+if [ -z "$PROFILE_ID" ]; then
+  echo "ERROR: 未找到可用的语音 profile（Voicebox /profiles 为空）" >&2
+  exit 1
+fi
+
+# ── 2026-08-12：引擎未指定时按 profile 的 default_engine 自动匹配 ──
+if [ -z "$ENGINE" ]; then
+  ENGINE=$(curl --noproxy '*' -s --max-time 5 "$BASE_URL/profiles/$PROFILE_ID" 2>/dev/null \
+    | python3 -c '
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    print(d.get("default_engine") or d.get("preset_engine") or "qwen")
+except Exception:
+    print("qwen")
+' 2>/dev/null)
+fi
+
+# JSON-escape text
+TEXT_JSON=$(python3 -c 'import json,sys; print(json.dumps(sys.argv[1]))' "$TEXT")
+
+# 提交生成请求
+RESP=$(curl --noproxy '*' -s --max-time 15 -X POST "$BASE_URL/generate" \
+  -H "Content-Type: application/json" \
+  -H "X-Voicebox-Client-Id: workrelay-tts" \
+  -d "{\"text\": $TEXT_JSON, \"profile_id\": \"$PROFILE_ID\", \"language\": \"$LANG\", \"engine\": \"$ENGINE\"}")
+
+GEN_ID=$(echo "$RESP" | python3 -c 'import json,sys; print(json.load(sys.stdin).get("id",""))' 2>/dev/null)
+if [ -z "$GEN_ID" ]; then
+  echo "ERROR: Voicebox 生成提交失败: $RESP" >&2
+  exit 1
+fi
+
+# 轮询等待完成（CPU 推理约 10-180 秒，视文本长度）
+MAX_POLLS=180
+for i in $(seq 1 $MAX_POLLS); do
+  sleep 1
+  ST=$(curl --noproxy '*' -s --max-time 10 "$BASE_URL/history/$GEN_ID" 2>/dev/null \
+    | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d.get("status",""))' 2>/dev/null)
+  if [ "$ST" = "completed" ]; then
+    break
+  fi
+  if [ "$ST" = "error" ] || [ "$ST" = "failed" ]; then
+    echo "ERROR: Voicebox 生成失败 (id=$GEN_ID, status=$ST)" >&2
+    exit 1
+  fi
+done
+
+# 下载音频
+curl --noproxy '*' -s --max-time 30 -o "$OUT" "$BASE_URL/audio/$GEN_ID"
+if [ -s "$OUT" ]; then
+  exit 0
+else
+  echo "ERROR: Voicebox 音频下载失败 (id=$GEN_ID)" >&2
+  exit 1
+fi

package/ext_capabilities/workrelay-speak-luxtts/README.md

@@ -0,0 +1,44 @@
+# WorkRelay 语音合成（LuxTTS 克隆声）
+
+Agent 语音回复能力：Docker 部署 Voicebox（**LuxTTS 引擎**），内置**石头哥克隆声音**，音色自然。
+
+## 特点
+
+- **独立容器**：容器名 `voicebox-luxtts`，端口 `17601`，与 Kokoro 版（`voicebox` / 17493）**互不干扰，可同时安装**
+- **克隆声音**：安装时自动创建克隆 profile（内置 4 个声音样本），开箱即有"石头哥克隆声"
+- **引擎固定**：LuxTTS 为纯克隆声音引擎（无预设音色），桥接脚本固定 `engine=luxtts`
+- **生产可用**：镜像含 LuxTTS 模型（1.1G），拉取即用，无需再下载模型
+
+## 安装
+
+扩展能力页 → 语音合成（LuxTTS 克隆声）→ 启用，或手动执行：
+
+```bash
+bash install.sh
+```
+
+前置条件：Linux + Docker（6GB 内存、10GB 磁盘）。
+
+## 使用
+
+安装后 OpenClaw 自动配置 `messages.tts.provider=tts-local-cli-luxtts`，
+桥接脚本 `~/.workrelay/speak-luxtts/workrelay-tts.sh` 调用 `http://127.0.0.1:17601`。
+
+声音 profile 记录在 `~/.workrelay/speak-luxtts/profile_id`，可用环境变量覆盖：
+
+```bash
+WR_VOICEBOX_PROFILE_ID=<profile_id>  # 指定其它克隆声音
+WR_VOICEBOX_LUXTTS_PORT=17601        # 覆盖端口
+```
+
+## 与 Kokoro 版（workrelay-speak）关系
+
+| 项 | workrelay-speak | workrelay-speak-luxtts |
+|---|---|---|
+| 容器名 | voicebox | voicebox-luxtts |
+| 端口 | 17493/17600 | 17601 |
+| 引擎 | Kokoro-82M | LuxTTS |
+| 声音 | 50+ 预设音色 | 石头哥克隆声（可换） |
+| OpenClaw provider | tts-local-cli | tts-local-cli-luxtts |
+
+两者可共存，OpenClaw 当前生效的 TTS 由 `messages.tts.provider` 决定（后启用者生效）。

package/ext_capabilities/workrelay-speak-luxtts/install.sh

@@ -0,0 +1,330 @@
+#!/bin/bash
+# WorkRelay 语音合成（LuxTTS 克隆声）一键安装脚本
+# 独立容器 voicebox-luxtts（端口 17601），拉取含 LuxTTS 模型的阿里镜像，
+# 自动创建"石头哥克隆声音"profile（内置样本），配置 OpenClaw TTS。
+# 2026-08-15 新增能力：与 workrelay-speak（Kokoro）互不干扰，可同时安装。
+set -eo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+VB_DIR="$HOME/.workrelay/voicebox-luxtts"
+VB_HOST="${WR_VOICEBOX_HOST:-127.0.0.1}"
+# 独立端口 17601（Kokoro 版占用 17493/17600，避免冲突）
+VB_PORT="${WR_VOICEBOX_LUXTTS_PORT:-17601}"
+VB_CONTAINER_PORT=17493
+# 阿里云镜像：石头哥推送后使用（含 LuxTTS 模型 + Kokoro + 英文补丁）
+# 2026-09-14 双源：国内=阿里云公共仓库；国际=GitHub Container Registry (ghcr.io)
+# 2026-09-14 改名为 dlinkclaw-tts（统一仓库名，tag 区分模型）
+IMG_TAG="${WR_IMAGE_TAG:-luxtts-20260914}"
+# 国内源：暂未发布（留空自动跳过）；发布后填入 registry.cn-hangzhou.aliyuncs.com/NAMESPACE/dlinkclaw-tts:${IMG_TAG}
+IMG_CN="${WR_IMAGE_CN:-}"
+IMG_INTL="${WR_IMAGE_INTL:-ghcr.io/rockychen2016/dlinkclaw-tts:${IMG_TAG}}"
+VB_IMAGE=""
+INSTALL_DIR="$(dirname "$(readlink -f "$0")")"
+
+# ── 2026-09-14 镜像双源（国内=阿里云公共仓库 / 国际=ghcr.io）──
+# 按 WR_IMAGE_REGION（auto|cn|intl）优先尝试，失败自动回退另一源；WR_VOICEBOX_IMAGE 可显式覆盖。
+IMAGE_CANDIDATES=()
+if [ -n "${WR_VOICEBOX_IMAGE:-}" ]; then
+  IMAGE_CANDIDATES=("$WR_VOICEBOX_IMAGE")
+else
+  # 2026-09-14：国内源暂未发布（IMG_CN 为空则自动跳过），默认国际源优先；国内源上架后自动生效
+  case "${WR_IMAGE_REGION:-auto}" in
+    cn)   CAND_PRIMARY="$IMG_CN";   CAND_SECONDARY="$IMG_INTL" ;;
+    intl) CAND_PRIMARY="$IMG_INTL"; CAND_SECONDARY="$IMG_CN" ;;
+    *)    CAND_PRIMARY="$IMG_INTL"; CAND_SECONDARY="$IMG_CN" ;;
+  esac
+  [ -n "$CAND_PRIMARY" ] && IMAGE_CANDIDATES+=("$CAND_PRIMARY")
+  [ -n "$CAND_SECONDARY" ] && IMAGE_CANDIDATES+=("$CAND_SECONDARY")
+fi
+
+pull_image_with_fallback() {
+  local log="$1"
+  for img in "${IMAGE_CANDIDATES[@]}"; do
+    echo "  → 尝试镜像源: $img"
+    if docker pull "$img" > "$log" 2>&1; then
+      VB_IMAGE="$img"
+      return 0
+    fi
+    echo "    ⚠ 该源拉取失败，尝试下一个..."
+  done
+  return 1
+}
+
+
+echo "============================================"
+echo "  WorkRelay 语音合成（LuxTTS 克隆声）- 一键安装"
+echo "============================================"
+echo ""
+
+# ── 系统检查 ──
+echo -n "[1/6] 检查系统环境... "
+
+OS="$(uname -s)"
+case "$OS" in
+  Linux)  ;;
+  *)
+    echo -e "${RED}失败${NC}"
+    echo "错误：当前仅支持 Linux（TTS 需要 Docker）"
+    exit 1
+    ;;
+esac
+
+export PATH="$PATH:/snap/bin:/usr/local/bin"
+
+if ! command -v docker &>/dev/null; then
+  echo -e "${RED}失败${NC}"
+  echo "错误：未找到 Docker，请先安装 Docker"
+  echo "  Ubuntu: sudo apt install docker.io docker-compose-v2"
+  exit 1
+fi
+
+if ! docker info &>/dev/null 2>&1; then
+  # 2026-08-18 增强：docker 权限多级自适应（尽量零 sudo，任何机器可用）：
+  #   ① 用户已在 docker 组（含会话未刷新）→ sg docker 切组执行
+  #   ② 免密 sudo（sudo -n）可用 → sudo 包装
+  #   ③ 都不行 → 给出一键修复指引，而不是干失败
+  if sg docker -c "docker info" &>/dev/null 2>&1; then
+    echo "  ℹ 用户已加入 docker 组，通过 sg docker 执行（无需 sudo）"
+    docker() { sg docker -c "docker $(printf '%q ' "$@")"; }
+  elif sudo -n docker info &>/dev/null 2>&1; then
+    echo "  ⚠ 当前用户无 docker 组权限，检测到免密 sudo，自动使用 sudo 执行 docker"
+    docker() { sudo docker "$@"; }
+  else
+    echo -e "${RED}失败${NC}"
+    echo "错误：Docker 未运行或无权限。请先执行一次以下命令："
+    echo ""
+    echo "  ① 启动 Docker：sudo systemctl start docker"
+    echo "  ② 把当前用户加入 docker 组（避免以后每次要密码）："
+    echo "       sudo usermod -aG docker \$USER"
+    echo "  ③ 重启 openclaw 服务（或重新登录会话），然后重新安装"
+    echo ""
+    echo "  备选：为当前用户配置免密 sudo（sudo visudo 添加：\$USER ALL=(ALL) NOPASSWD: ALL）"
+    exit 1
+  fi
+fi
+
+echo -e "${GREEN}OK${NC} ($(docker --version | head -1), $(uname -o))"
+
+# snap docker 项目目录适配（与 workrelay-speak 一致）
+if [ -d /var/snap/docker/common ]; then
+  VB_DIR="/var/snap/docker/common/workrelay-voicebox-luxtts"
+  echo "  ℹ 检测到 snap docker，项目目录使用 $VB_DIR（AppArmor 放行读写）"
+  # 2026-08-18：无免密 sudo 时给出手动命令指引（不依赖 sudo 密码）。
+  if [ -d "$VB_DIR" ]; then
+    sudo -n chown -R "$(id -u):$(id -g)" "$VB_DIR" 2>/dev/null || true
+  elif ! sudo -n mkdir -p "$VB_DIR" 2>/dev/null; then
+    echo -e "${RED}失败${NC}"
+    echo "错误：无法创建项目目录 $VB_DIR（需要 root 权限）。"
+    echo "请手动执行一次以下命令后重新安装："
+    echo "  sudo mkdir -p $VB_DIR && sudo chown \$USER:\$USER $VB_DIR"
+    exit 1
+  fi
+  sudo -n chown "$(id -u):$(id -g)" "$VB_DIR" 2>/dev/null || true
+fi
+
+# ── 磁盘空间 ──
+echo -n "[2/6] 检查磁盘空间... "
+DF_TARGET="$VB_DIR"; [ -d "$DF_TARGET" ] || DF_TARGET="$HOME"
+AVAIL=$(df -BM "$DF_TARGET" | tail -1 | awk '{print $4}' | sed 's/M//')
+if [ "$AVAIL" -lt 10000 ]; then
+  echo -e "${RED}不足${NC}"
+  echo "错误：可用空间 ${AVAIL}MB，至少需要 10GB（Docker 镜像 + 模型 ~6GB）"
+  exit 1
+fi
+echo -e "${GREEN}OK${NC} (可用 ${AVAIL}MB)"
+
+# ── 内存检查 ──
+echo -n "[3/6] 检查内存... "
+# 2026-09-15 修复：中文 locale 下 free -m 输出“内存：”，awk 匹配 Mem: 失败会误报内存不足 → 强制 LANG=C
+RAM=$(LANG=C free -m | awk '/^Mem:/{print $2}')
+if [ "$RAM" -lt 6000 ]; then
+  echo -e "${RED}不足 (${RAM}MB)${NC}"
+  echo "错误：至少需要 6GB 内存，当前仅 ${RAM}MB"
+  exit 1
+fi
+echo -e "${GREEN}OK${NC} (${RAM}MB)"
+
+# ── 端口检查 ──
+echo -n "[4/6] 检查端口 $VB_PORT... "
+if ss -tlnp 2>/dev/null | grep -q ":$VB_PORT "; then
+  echo -e "${RED}已被占用${NC}"
+  echo "错误：端口 $VB_PORT 已被占用，请先停止占用进程或设置 WR_VOICEBOX_LUXTTS_PORT 换端口"
+  exit 1
+fi
+echo -e "${GREEN}空闲${NC}"
+
+# ── 拉取镜像 ──
+echo -n "[5/6] 拉取 Voicebox (LuxTTS) 镜像... "
+mkdir -p "$VB_DIR"
+if pull_image_with_fallback /tmp/wr-pull-luxtts.log; then
+  echo -e "${GREEN}OK${NC} ($VB_IMAGE)"
+else
+  echo -e "${RED}失败${NC}"
+  tail -5 /tmp/wr-pull-luxtts.log
+  echo "错误：所有镜像源均拉取失败，检查网络连接（国内=阿里云公共仓库 / 国际=ghcr.io）"
+  exit 1
+fi
+
+# ── 启动容器 ──
+echo "[6/6] 启动 Voicebox (LuxTTS) 容器..."
+
+# 2026-09-15 修复（生产环境反馈）：持久化整个 /app/data
+# 含 voicebox.db（音色库）+ profiles + generations，避免容器重建后音色/数据丢失
+mkdir -p "$VB_DIR/data/generations" "$VB_DIR/data/profiles" "$VB_DIR/data/cache"
+chmod -R 777 "$VB_DIR/data" 2>/dev/null || true
+
+docker rm -f voicebox-luxtts >/dev/null 2>&1 || true
+if ! docker run -d --name voicebox-luxtts --restart unless-stopped \
+    -p "127.0.0.1:${VB_PORT}:${VB_CONTAINER_PORT}" \
+    -v "$VB_DIR/data:/app/data" \
+    -e LOG_LEVEL=info \
+    -e NUMBA_CACHE_DIR=/tmp/numba_cache \
+    --cpus 4 --memory 8g \
+    "$VB_IMAGE" >/dev/null 2>&1; then
+  echo -e "${RED}失败${NC}"
+  echo "错误：docker run 失败，执行 docker logs voicebox-luxtts 查看日志"
+  exit 1
+fi
+echo "  ✅ docker run 启动成功"
+
+# 2026-08-15 权限兜底：snap docker 的 bind mount 目录在容器内可能显示 root:root 755，
+# voicebox 用户（uid 999）无法写入 /app/data/generations 导致生成保存失败。
+# 容器内 chmod 777 兜底（docker run 后立即执行，幂等）。
+docker exec voicebox-luxtts chmod -R 777 /app/data 2>/dev/null || true
+
+# 等待 API 就绪
+echo -n "  等待 Voicebox API 就绪..."
+for i in $(seq 1 90); do
+  if curl -s --max-time 2 "http://${VB_HOST}:${VB_PORT}/mcp" >/dev/null 2>&1; then
+    echo -e " ${GREEN}OK${NC} (耗时 ${i} 次检查)"
+    break
+  fi
+  sleep 5
+  echo -n "."
+done
+
+if ! curl -s --max-time 2 "http://${VB_HOST}:${VB_PORT}/mcp" >/dev/null 2>&1; then
+  echo ""
+  echo -e "${RED}Voicebox 启动失败${NC}"
+  echo "  检查日志: docker logs voicebox-luxtts"
+  exit 1
+fi
+
+# ── 创建石头哥克隆声音 profile ──
+echo "  ⚙ 配置克隆声音（石头哥克隆声）..."
+
+mkdir -p "$HOME/.workrelay/speak-luxtts"
+PROFILE_FILE="$HOME/.workrelay/speak-luxtts/profile_id"
+SAMPLE_DIR="$INSTALL_DIR/samples"
+
+# 查已存在的同款克隆 profile（按名字匹配，避免重复创建）
+EXIST_ID=$(curl --noproxy '*' -s --max-time 5 "http://${VB_HOST}:${VB_PORT}/profiles" 2>/dev/null \
+  | python3 -c '
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    for p in d:
+        if p.get("name")=="石头哥克隆声" and p.get("voice_type")=="cloned":
+            print(p.get("id","")); break
+except Exception:
+    print("")
+' 2>/dev/null)
+
+if [ -z "$EXIST_ID" ]; then
+  # 创建克隆 profile
+  EXIST_ID=$(curl --noproxy '*' -s --max-time 10 -X POST "http://${VB_HOST}:${VB_PORT}/profiles" \
+    -H "Content-Type: application/json" \
+    -d '{"name":"石头哥克隆声","description":"WorkRelay LuxTTS 内置克隆声音（石头哥）","language":"zh","voice_type":"cloned"}' \
+    | python3 -c 'import json,sys; print(json.load(sys.stdin).get("id",""))' 2>/dev/null)
+fi
+
+if [ -n "$EXIST_ID" ]; then
+  # 上传样本（file + reference_text 多文件）
+  SAMPLE_COUNT=0
+  while IFS='|' read -r fname reftext; do
+    [ -z "$fname" ] && continue
+    fpath="$SAMPLE_DIR/$fname"
+    if [ -f "$fpath" ]; then
+      if curl --noproxy '*' -s --max-time 15 -X POST "http://${VB_HOST}:${VB_PORT}/profiles/${EXIST_ID}/samples" \
+          -F "file=@${fpath}" -F "reference_text=${reftext}" \
+          | python3 -c 'import json,sys; d=json.load(sys.stdin); print("ok" if d.get("id") else "fail")' 2>/dev/null | grep -q ok; then
+        SAMPLE_COUNT=$((SAMPLE_COUNT+1))
+      fi
+    fi
+  done < "$SAMPLE_DIR/reference_text.txt"
+  echo "  ✅ 克隆声音 profile 已就绪（${SAMPLE_COUNT} 个样本）"
+  echo "$EXIST_ID" > "$PROFILE_FILE"
+else
+  echo "  ⚠ 克隆 profile 创建失败，可手动设 WR_VOICEBOX_PROFILE_ID 指定声音"
+fi
+
+# ── TTS 互斥：停止其它 TTS 容器（2026-09-14：TTS 只能启用一个）──
+echo "  🔒 互斥处理：停止其它 TTS 容器..."
+for other in voicebox voicebox-qwen; do
+  if docker ps --format '{{.Names}}' 2>/dev/null | grep -qx "$other"; then
+    docker stop "$other" >/dev/null 2>&1 && echo "     ⏹ 已停止 $other" || true
+  fi
+done
+
+# ── 部署脚本 & 配置 OpenClaw ──
+echo -n "[收尾] 部署 TTS 桥接脚本 & 配置 OpenClaw... "
+
+mkdir -p "$HOME/.workrelay/speak-luxtts"
+cp "$INSTALL_DIR/workrelay-tts.sh" "$HOME/.workrelay/speak-luxtts/"
+chmod +x "$HOME/.workrelay/speak-luxtts/workrelay-tts.sh"
+cp "$INSTALL_DIR/README.md" "$HOME/.workrelay/speak-luxtts/" 2>/dev/null || true
+
+if command -v openclaw &>/dev/null; then
+  TTS_SCRIPT="$HOME/.workrelay/speak-luxtts/workrelay-tts.sh"
+  # 独立 provider 名（tts-local-cli-luxtts），与 Kokoro 版 tts-local-cli 互不覆盖
+  # 2026-09-14：openclaw 升级后 TTS 配置在顶层 tts.*（旧 messages.tts.* 已失效）
+  openclaw config set tts.provider tts-local-cli-luxtts 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-luxtts.command "$TTS_SCRIPT" 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-luxtts.args '["{{Text}}","{{OutputPath}}"]' 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-luxtts.outputFormat wav 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-luxtts.timeoutMs 180000 2>/dev/null || true
+
+  # MCP 配置（独立 server 名 voicebox-luxtts）
+  openclaw config set mcp.servers.voicebox-luxtts.url "http://${VB_HOST}:${VB_PORT}/mcp" 2>/dev/null || true
+  openclaw config set mcp.servers.voicebox-luxtts.transport streamable-http 2>/dev/null || true
+  openclaw config set mcp.servers.voicebox-luxtts.timeout 60 2>/dev/null || true
+
+  openclaw gateway restart 2>/dev/null || true
+else
+  echo -e "${YELLOW}⚠ 未检测到 openclaw CLI，跳过自动配置${NC}"
+fi
+
+echo -e "${GREEN}OK${NC}"
+echo ""
+
+# ── 验证 ──
+echo "============================================"
+echo "  安装验证"
+echo "============================================"
+
+echo -n "  Docker 容器: "
+docker ps --format '{{.Names}}' 2>/dev/null | grep -q voicebox-luxtts && echo -e "${GREEN}运行中${NC}" || echo -e "${RED}未运行${NC}"
+
+echo -n "  API 连通性: "
+curl -s --max-time 2 "http://${VB_HOST}:${VB_PORT}/mcp" >/dev/null 2>&1 \
+  && echo -e "${GREEN}OK${NC} (http://${VB_HOST}:${VB_PORT})" \
+  || echo -e "${RED}无法连接${NC}"
+
+echo -n "  TTS 桥接脚本: "
+[ -f "$HOME/.workrelay/speak-luxtts/workrelay-tts.sh" ] && echo -e "${GREEN}已部署${NC}" || echo -e "${RED}缺失${NC}"
+
+echo -n "  克隆声音 profile: "
+[ -f "$PROFILE_FILE" ] && echo -e "${GREEN}$(cat "$PROFILE_FILE")${NC}" || echo -e "${RED}缺失${NC}"
+
+echo ""
+echo -e "${GREEN}✅ Voicebox (LuxTTS) 安装完成！${NC}"
+echo "  API 地址:  http://${VB_HOST}:${VB_PORT}"
+echo "  管理命令:  docker ps | grep voicebox-luxtts"
+echo "  查看日志:  docker logs -f voicebox-luxtts"
+echo ""
+echo "  🎙️ 声音：内置石头哥克隆声（LuxTTS 引擎）"
+echo ""

package/ext_capabilities/workrelay-speak-luxtts/manifest.json

@@ -0,0 +1,63 @@
+{
+  "name": "workrelay-speak-luxtts",
+  "displayName": "语音合成（LuxTTS 克隆声）",
+  "description": "Agent 语音回复：Docker 部署 Voicebox（LuxTTS 引擎），内置石头哥克隆声音，音色自然，与其它 TTS 互斥（同时只能启用一个）",
+  "requirements": [
+    {
+      "id": "os",
+      "label": "操作系统",
+      "expect": "Linux",
+      "check": "uname -s | grep -qi linux",
+      "hint": "TTS 依赖 Docker，仅支持 Linux（Windows 请用 WSL2）"
+    },
+    {
+      "id": "docker",
+      "label": "Docker 已安装",
+      "expect": "已安装 docker",
+      "check": "command -v docker >/dev/null 2>&1",
+      "hint": "未找到 Docker，请先安装：sudo apt install docker.io docker-compose-v2"
+    },
+    {
+      "id": "docker_access",
+      "label": "Docker 可访问（权限）",
+      "expect": "docker info 可正常执行",
+      "check": "docker info >/dev/null 2>&1 || (id -nG | grep -qw docker && sg docker -c 'docker info' >/dev/null 2>&1) || sudo -n docker info >/dev/null 2>&1",
+      "hint": "Docker 无权限。一次性解决（需 sudo 密码一次）：① sudo systemctl start docker ② sudo usermod -aG docker $USER（$USER 换成 openclaw 运行用户，whoami 可查）③ openclaw gateway restart 后重试"
+    },
+    {
+      "id": "memory",
+      "label": "内存 ≥ 6GB",
+      "expect": "≥ 6GB 可用",
+      "check": "[ $(LANG=C free -m | awk '/^Mem:/{print $2}') -ge 6144 ]",
+      "hint": "当前内存不足，TTS 至少需要 6GB 内存"
+    },
+    {
+      "id": "disk",
+      "label": "磁盘 ≥ 10GB",
+      "expect": "≥ 10GB 可用",
+      "check": "[ $(df -BM \"$HOME\" | tail -1 | awk '{print $4}' | sed 's/M//') -ge 10240 ]",
+      "hint": "可用空间不足，镜像+模型约需 6GB，建议预留 10GB"
+    },
+    {
+      "id": "network",
+      "label": "外网可达（镜像仓库）",
+      "expect": "能访问阿里云镜像仓库",
+      "check": "curl -sI --max-time 5 https://crpi-3zj44dlldca7vawm.cn-hangzhou.personal.cr.aliyuncs.com >/dev/null 2>&1",
+      "hint": "无法访问阿里云镜像仓库，将无法拉取 Docker 镜像"
+    },
+    {
+      "id": "registry",
+      "label": "镜像仓库可达（ghcr.io / 国内公共仓库，自动回退）",
+      "expect": "能访问阿里云镜像仓库",
+      "check": "timeout 4 docker manifest inspect ghcr.io/rockychen2016/dlinkclaw-tts:luxtts-20260914 >/dev/null 2>&1 || timeout 4 docker manifest inspect registry.cn-hangzhou.aliyuncs.com/shiduo/dlinkclaw-tts:luxtts-20260914 >/dev/null 2>&1",
+      "hint": "镜像源不可达。国际源: ghcr.io（GitHub Container Registry，公开免登录）；国内源: registry.cn-hangzhou.aliyuncs.com（待发布）。安装时自动按区域优先并回退"
+    },
+    {
+      "id": "gpu",
+      "label": "GPU 加速（可选）",
+      "expect": "检测到 NVIDIA GPU 时合成更快",
+      "check": "if command -v nvidia-smi >/dev/null 2>&1; then nvidia-smi -L >/dev/null 2>&1 && exit 0; fi; exit 0",
+      "hint": "未检测到 NVIDIA 独显，将使用 CPU 合成（慢但可用）；有 NVIDIA GPU 时自动启用 CUDA 加速"
+    }
+  ]
+}

package/ext_capabilities/workrelay-speak-luxtts/samples/reference_text.txt

@@ -0,0 +1,4 @@
+85fafe01-d4d6-4a48-890e-9ae113f21905.wav|我是想让你克隆一份我的声音，然后用我的声音来回复我，试一下。
+800e5af4-cba5-441e-8003-6d36f35409e6.wav|好，小朵听到吗？现在石头哥给小朵发语音信息，小朵收到吗？收到请回复。小朵，有没有收到？收到了没有？
+45ea2e2c-0863-4966-a739-8bff8817f4c0.wav|这是石头哥的声音样本，用于视频配音克隆。
+stone-sample-6.4s.wav|这是石头哥的声音样本，用于视频配音克隆。