dlinkclaw-openclaw 1.0.0

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

@@ -0,0 +1,115 @@
+#!/bin/bash
+# WorkRelay 语音合成（LuxTTS 克隆声）状态检查
+# 返回值: 0=已启用, 1=未安装, 2=部分安装, 3=Docker未运行
+# 同时输出 JSON 给客户端解析
+# 2026-08-15 新增能力：独立容器 voicebox-luxtts + 端口 17601 + provider tts-local-cli-luxtts
+
+set -e
+
+STATUS_OK=0
+STATUS_NOT_INSTALLED=1
+STATUS_PARTIAL=2
+STATUS_DOCKER_DOWN=3
+
+VB_HOST="${WR_VOICEBOX_HOST:-127.0.0.1}"
+VB_PORT="${WR_VOICEBOX_LUXTTS_PORT:-17601}"
+VB_DOCKER_PORT="${WR_VOICEBOX_LUXTTS_PORT:-17601}"
+
+export PATH="$PATH:/snap/bin:/usr/local/bin"
+# 2026-08-18：与 install.sh 保持一致的 docker 权限自适应（sg docker / 免密 sudo）
+if ! docker info &>/dev/null 2>&1; then
+  if sg docker -c "docker info" &>/dev/null 2>&1; then
+    docker() { sg docker -c "docker $(printf '%q ' "$@")"; }
+  elif sudo -n docker info &>/dev/null 2>&1; then
+    docker() { sudo docker "$@"; }
+  fi
+fi
+
+# 检测实际端口（17601，fallback 同端口）
+check_port=$VB_PORT
+curl -s --max-time 2 "http://${VB_HOST}:${VB_PORT}/mcp" >/dev/null 2>&1 && check_port=$VB_PORT || {
+  curl -s --max-time 2 "http://${VB_HOST}:${VB_DOCKER_PORT}/mcp" >/dev/null 2>&1 && check_port=$VB_DOCKER_PORT
+}
+
+# 检查1: Docker
+check_docker=0
+docker info &>/dev/null 2>&1 && check_docker=1 || true
+
+# 检查2: voicebox-luxtts 容器
+check_container=0
+docker ps --format '{{.Names}}' 2>/dev/null | grep -q "voicebox-luxtts" && check_container=1 || true
+
+# 检查3: API
+check_api=0
+curl -s --max-time 3 "http://${VB_HOST}:${check_port}/mcp" >/dev/null 2>&1 && check_api=1 || true
+
+# 检查4: TTS 桥接脚本
+check_tts_script=0
+[ -f "$HOME/.workrelay/speak-luxtts/workrelay-tts.sh" ] && check_tts_script=1 || true
+
+# 检查5: 克隆声音 profile
+check_profile=0
+[ -f "$HOME/.workrelay/speak-luxtts/profile_id" ] && check_profile=1 || true
+
+# 检查6: OpenClaw TTS 配置（2026-09-14 openclaw 升级后：config 路径 messages.tts.* → 顶层 tts.*；
+# 不再调 openclaw CLI（升级后可能挂起卡插件队列），改为直接读 openclaw.json）
+# 2026-09-14 互斥判定：仅当 tts.provider == tts-local-cli-luxtts 时才算"已启用"（TTS 只能启用一个）
+check_config=0
+check_provider=0
+OC_JSON="${OPENCLAW_HOME:-$HOME/.openclaw}/openclaw.json"
+if [ -f "$OC_JSON" ]; then
+  grep -q '"tts-local-cli-luxtts":' "$OC_JSON" && check_config=1 || true
+  CUR_PROVIDER=$(python3 -c '
+import json,sys
+try:
+    c=json.load(open(sys.argv[1]))
+    print((c.get("tts") or {}).get("provider",""))
+except Exception:
+    print("")
+' "$OC_JSON" 2>/dev/null)
+  [ "$CUR_PROVIDER" = "tts-local-cli-luxtts" ] && check_provider=1 || true
+fi
+
+# ── 汇总状态 ──
+total=$((check_docker + check_container + check_api + check_tts_script + check_profile + check_config))
+
+case $total in
+  6)
+    # 2026-09-14 互斥：安装齐全后再看 provider 是否指向本引擎
+    if [ "$check_provider" -eq 1 ]; then
+      status="enabled";   desc="语音合成（LuxTTS 克隆声）已启用"; exit_code=$STATUS_OK
+    else
+      status="disabled";  desc="已安装但未启用（当前语音合成为其它引擎，TTS 只能启用一个）"; exit_code=$STATUS_NOT_INSTALLED
+    fi
+    ;;
+  0) status="disabled";  desc="未安装";          exit_code=$STATUS_NOT_INSTALLED ;;
+  *)
+    if [ "$check_container" -eq 0 ] && [ "$check_docker" -eq 1 ]; then
+      status="disabled"; desc="Docker 运行中但 voicebox-luxtts 未安装"; exit_code=$STATUS_NOT_INSTALLED
+    elif [ "$check_container" -eq 1 ] && [ "$check_api" -eq 0 ]; then
+      status="partial"; desc="voicebox-luxtts 容器存在但 API 未就绪（可能在下载模型）"; exit_code=$STATUS_DOCKER_DOWN
+    else
+      status="partial"; desc="部分安装"; exit_code=$STATUS_PARTIAL
+    fi
+    ;;
+esac
+
+# ── 输出 JSON ──
+cat <<EOF
+{
+  "status": "$status",
+  "description": "$desc",
+  "endpoint": "http://${VB_HOST}:${check_port}",
+  "checks": {
+    "docker": $( [ $check_docker -eq 1 ] && echo true || echo false ),
+    "container": $( [ $check_container -eq 1 ] && echo true || echo false ),
+    "api": $( [ $check_api -eq 1 ] && echo true || echo false ),
+    "tts_script": $( [ $check_tts_script -eq 1 ] && echo true || echo false ),
+    "profile": $( [ $check_profile -eq 1 ] && echo true || echo false ),
+    "openclaw_config": $( [ $check_config -eq 1 ] && echo true || echo false ),
+    "provider_active": $( [ $check_provider -eq 1 ] && echo true || echo false )
+  }
+}
+EOF
+
+exit $exit_code

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

@@ -0,0 +1,98 @@
+#!/bin/bash
+# WorkRelay TTS 桥接脚本（LuxTTS 引擎）- 调用本地 Voicebox (voicebox-luxtts) REST API
+# 环境变量：
+#   WR_VOICEBOX_HOST       - Voicebox 服务地址（默认 127.0.0.1）
+#   WR_VOICEBOX_LUXTTS_PORT - LuxTTS 实例端口（默认 17601，独立于 Kokoro 版）
+#   WR_VOICEBOX_PROFILE_ID - 声音 profile ID（可选，缺省读取 ~/.workrelay/speak-luxtts/profile_id）
+#   WR_VOICEBOX_LANG       - 语言（默认 zh）
+# 固定引擎 luxtts（LuxTTS 为克隆声音引擎，无预设音色，必须使用克隆 profile）
+
+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_LUXTTS_PORT:-17601}"
+PROFILE_ID="${WR_VOICEBOX_PROFILE_ID:-}"
+ENGINE="luxtts"
+LANG="${WR_VOICEBOX_LANG:-zh}"
+
+BASE_URL="http://${VB_HOST}:${VB_PORT}"
+if ! curl -s --max-time 2 "${BASE_URL}/mcp" >/dev/null 2>&1; then
+  echo "ERROR: Voicebox (LuxTTS) API 不可达 ($VB_HOST:$VB_PORT)" >&2
+  exit 1
+fi
+
+# ── profile 自动解析（install.sh 写入石头哥克隆声 profile id）──
+if [ -z "$PROFILE_ID" ] && [ -f "$HOME/.workrelay/speak-luxtts/profile_id" ]; then
+  PROFILE_ID=$(cat "$HOME/.workrelay/speak-luxtts/profile_id" 2>/dev/null | tr -d ' \n')
+fi
+if [ -z "$PROFILE_ID" ]; then
+  # 兜底：从 /profiles 找克隆 profile（优先中文）
+  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("voice_type")=="cloned" and p.get("language")=="zh":
+            out=p.get("id",""); break
+    if not out:
+        for p in d:
+            if p.get("voice_type")=="cloned":
+                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
+
+# JSON-escape text
+TEXT_JSON=$(python3 -c 'import json,sys; print(json.dumps(sys.argv[1]))' "$TEXT")
+
+# 提交生成请求（固定 engine=luxtts）
+RESP=$(curl --noproxy '*' -s --max-time 15 -X POST "$BASE_URL/generate" \
+  -H "Content-Type: application/json" \
+  -H "X-Voicebox-Client-Id: workrelay-tts-luxtts" \
+  -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-qwen/README.md

@@ -0,0 +1,62 @@
+# WorkRelay 语音合成（千问 Qwen3-TTS）扩展能力
+
+Agent 语音回复能力：Docker 部署 **Voicebox**（**Qwen3-TTS CustomVoice 1.7B** 引擎），
+9 种预设音色（含中文女声 Vivian），中英日韩多语种，断句/语速自然，适合视频配音。
+
+> 2026-09-14 新增。与 `workrelay-speak`（Kokoro）、`workrelay-speak-luxtts`（LuxTTS）**互斥**：
+> TTS 同时只能启用一个，启用本能力会自动停止其它两个 TTS 容器并接管 `tts.provider`。
+
+## 文件说明
+
+| 文件 | 作用 |
+|------|------|
+| `workrelay-tts.sh` | TTS 桥接脚本（调 voicebox-qwen REST API，固定引擎 qwen_custom_voice） |
+| `install.sh` | 一键安装（拉镜像 → 下载千问模型 → 起容器 → 建音色 profile → 互斥 → 配 OpenClaw） |
+| `status.sh` | 状态查询（含**互斥判定**：读 `tts.provider` 判断是否当前启用） |
+| `manifest.json` | 前置条件清单（含镜像仓库可达性 + GPU 检测） |
+
+## 关键参数
+
+| 项 | 值 |
+|---|---|
+| 容器名 | `voicebox-qwen` |
+| 端口 | `17602`（Kokoro 17493/17600、LuxTTS 17601） |
+| 镜像 | `crpi-...aliyuncs.com/shiduo/workrelay-tts:20260813`（复用，已含 qwen_custom_voice 后端） |
+| 模型 | `Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice`（~4.6GB，安装时经 hf-mirror.com 下载） |
+| 音色 profile | Vivian（中文女声）；其它：Serena/Uncle_Fu/Dylan/Eric/Ryan/Aiden/Ono_Anna/Sohee |
+| OpenClaw provider | `tts-local-cli-qwen`（配置在顶层 `tts.providers.*`） |
+| 合成超时 | 300000 ms（5 分钟，CPU 推理较慢） |
+
+## 状态返回（status.sh）
+
+```json
+{
+  "status": "enabled | disabled | partial",
+  "description": "…",
+  "endpoint": "http://127.0.0.1:17602",
+  "checks": {
+    "docker": true, "container": true, "api": true,
+    "tts_script": true, "profile": true,
+    "openclaw_config": true, "provider_active": true
+  }
+}
+```
+
+- `provider_active=true` → 当前 TTS 就是本引擎（`tts.provider=tts-local-cli-qwen`）
+- `provider_active=false` → 已安装但被其它 TTS 接管 → 状态显示"已安装但未启用"
+
+## 管理命令
+
+```bash
+docker ps | grep voicebox-qwen          # 查看容器
+docker logs -f voicebox-qwen            # 查看日志
+curl -s http://127.0.0.1:17602/profiles # 查看音色 profile
+docker stop voicebox-qwen               # 停用（并把 tts.provider 切回其它引擎）
+```
+
+## GPU 说明
+
+- 有 NVIDIA GPU（`nvidia-smi` 可用）→ 安装时自动 `--gpus all`，合成快
+- 无独显 → CPU 合成，1.7B 模型约 10~60 秒/句（慢但可用）
+
+*文档版本：2026-09-14*

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

@@ -0,0 +1,349 @@
+#!/bin/bash
+# WorkRelay 语音合成（千问 Qwen3-TTS）一键安装脚本
+# 2026-09-14 新增能力：
+#   - 独立容器 voicebox-qwen（端口 17602），与 Kokoro(17493) / LuxTTS(17601) 互不干扰
+#   - 复用 workrelay-tts 镜像（已内置 qwen_custom_voice 后端），安装时下载 Qwen3-TTS 1.7B 模型（~4.6GB）
+#   - TTS 互斥：启用本能力会自动停止其它 TTS 容器，并把 tts.provider 切到本引擎
+set -eo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+VB_DIR="$HOME/.workrelay/voicebox-qwen"
+VB_HOST="${WR_VOICEBOX_HOST:-127.0.0.1}"
+# 独立端口 17602（Kokoro 17493/17600、LuxTTS 17601，避免冲突）
+VB_PORT="${WR_VOICEBOX_QWEN_PORT:-17602}"
+VB_CONTAINER_PORT=17493
+# 2026-09-14 双源：国内=阿里云公共仓库；国际=ghcr.io
+# 2026-09-14 改名为 dlinkclaw-tts（统一仓库名，tag 区分模型；千问复用同源镜像，模型安装时下载）
+IMG_TAG="${WR_IMAGE_TAG:-qwen-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=""
+# 千问模型（CustomVoice 预设音色版，1.7B）
+QWEN_MODEL="${WR_QWEN_MODEL:-Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice}"
+# 2026-09-14：模型下载源按区域选择——国内=hf-mirror.com（直连 HF 通常不通）；国际=huggingface.co
+if [ -n "${WR_HF_ENDPOINT:-}" ]; then
+  HF_MIRROR="$WR_HF_ENDPOINT"
+elif [ "${WR_IMAGE_REGION:-auto}" = "intl" ]; then
+  HF_MIRROR="https://huggingface.co"
+else
+  HF_MIRROR="https://hf-mirror.com"
+fi
+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 语音合成（千问 Qwen3-TTS）- 一键安装"
+echo "============================================"
+echo ""
+
+# ── 系统检查 ──
+echo -n "[1/8] 检查系统环境... "
+
+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
+  # docker 权限多级自适应（尽量零 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 组：sudo usermod -aG docker \$USER"
+    echo "  ③ 重启 openclaw 服务（或重新登录会话），然后重新安装"
+    exit 1
+  fi
+fi
+
+echo -e "${GREEN}OK${NC} ($(docker --version | head -1), $(uname -o))"
+
+# snap docker 项目目录适配（AppArmor 只放行 /var/snap/docker/common）
+if [ -d /var/snap/docker/common ]; then
+  VB_DIR="/var/snap/docker/common/workrelay-voicebox-qwen"
+  echo "  ℹ 检测到 snap docker，项目目录使用 $VB_DIR（AppArmor 放行读写）"
+  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
+
+# ── 磁盘空间（模型 4.6GB + 镜像，建议 ≥8GB）──
+echo -n "[2/8] 检查磁盘空间... "
+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 8192 ]; then
+  echo -e "${RED}不足${NC}"
+  echo "错误：可用空间 ${AVAIL}MB，至少需要 8GB（模型 4.6GB + 运行缓存）"
+  exit 1
+fi
+echo -e "${GREEN}OK${NC} (可用 ${AVAIL}MB)"
+
+# ── 内存检查 ──
+echo -n "[3/8] 检查内存... "
+# 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)"
+
+# ── GPU 检测（有 NVIDIA 则启用 CUDA 加速）──
+echo -n "[4/8] 检测 GPU... "
+DOCKER_GPU_ARGS=""
+if command -v nvidia-smi &>/dev/null && nvidia-smi -L &>/dev/null 2>&1; then
+  echo -e "${GREEN}检测到 NVIDIA GPU${NC} ($(nvidia-smi -L 2>/dev/null | head -1))"
+  DOCKER_GPU_ARGS="--gpus all"
+else
+  echo -e "${YELLOW}未检测到 N 卡，使用 CPU 合成（10~60 秒/句，较慢但可用）${NC}"
+fi
+
+# ── 端口检查 ──
+echo -n "[5/8] 检查端口 $VB_PORT... "
+if ss -tlnp 2>/dev/null | grep -q ":$VB_PORT "; then
+  echo -e "${RED}已被占用${NC}"
+  echo "错误：端口 $VB_PORT 已被占用，请先停止占用进程或设置 WR_VOICEBOX_QWEN_PORT 换端口"
+  exit 1
+fi
+echo -e "${GREEN}空闲${NC}"
+
+# ── 拉取镜像 ──
+echo -n "[6/8] 拉取 Voicebox 镜像... "
+mkdir -p "$VB_DIR"
+if pull_image_with_fallback /tmp/wr-pull-qwen.log; then
+  echo -e "${GREEN}OK${NC} ($VB_IMAGE)"
+else
+  echo -e "${RED}失败${NC}"
+  tail -5 /tmp/wr-pull-qwen.log
+  echo "错误：所有镜像源均拉取失败，检查网络连接（国内=阿里云公共仓库 / 国际=ghcr.io）"
+  exit 1
+fi
+
+# ── 预下载千问模型（用镜像自带的 huggingface_hub + 国内镜像源）──
+# 说明：镜像内已内置 Kokoro 模型，但未含 Qwen 模型；把 Qwen 模型下载到独立缓存目录，
+#       容器启动时挂载该目录作为 HF 缓存（HF_HUB_OFFLINE=1 离线加载，避免容器内联网失败）。
+echo -n "[7/8] 下载千问模型（约 4.6GB，视网速 5~30 分钟）... "
+HF_CACHE="$VB_DIR/hf-cache"
+mkdir -p "$HF_CACHE"
+if docker run --rm \
+    -v "$HF_CACHE:/hf-cache" \
+    -e HF_ENDPOINT="$HF_MIRROR" \
+    -e HF_HUB_OFFLINE=0 \
+    -e HF_HUB_DISABLE_PROGRESS_BARS=1 \
+    --entrypoint python3 \
+    "$VB_IMAGE" -c "
+from huggingface_hub import snapshot_download
+p = snapshot_download('$QWEN_MODEL', cache_dir='/hf-cache')
+print('MODEL_READY:' + p)
+" > /tmp/wr-qwen-download.log 2>&1; then
+  echo -e "${GREEN}OK${NC}"
+  chmod -R a+rX "$HF_CACHE" 2>/dev/null || true
+else
+  echo -e "${RED}失败${NC}"
+  tail -10 /tmp/wr-qwen-download.log
+  echo "错误：千问模型下载失败，请检查网络（hf-mirror.com）后重试"
+  exit 1
+fi
+
+# ── 启动容器 ──
+echo "[8/8] 启动 Voicebox (千问) 容器..."
+
+# 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-qwen >/dev/null 2>&1 || true
+if ! docker run -d --name voicebox-qwen --restart unless-stopped \
+    -p "127.0.0.1:${VB_PORT}:${VB_CONTAINER_PORT}" \
+    -v "$VB_DIR/data:/app/data" \
+    -v "$HF_CACHE:/home/voicebox/.cache/huggingface" \
+    -e LOG_LEVEL=info \
+    -e NUMBA_CACHE_DIR=/tmp/numba_cache \
+    -e HF_HUB_OFFLINE=1 \
+    $DOCKER_GPU_ARGS \
+    --cpus 4 --memory 8g \
+    "$VB_IMAGE" >/dev/null 2>&1; then
+  echo -e "${RED}失败${NC}"
+  echo "错误：docker run 失败，执行 docker logs voicebox-qwen 查看日志"
+  exit 1
+fi
+echo "  ✅ docker run 启动成功"
+
+docker exec voicebox-qwen 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-qwen"
+  exit 1
+fi
+
+# ── 创建千问预设音色 profile（Vivian 中文女声）──
+echo "  ⚙ 配置千问预设音色（Vivian 中文女声）..."
+
+mkdir -p "$HOME/.workrelay/speak-qwen"
+PROFILE_FILE="$HOME/.workrelay/speak-qwen/profile_id"
+
+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("preset_engine")=="qwen_custom_voice" and p.get("preset_voice_id")=="Vivian":
+            print(p.get("id","")); break
+except Exception:
+    print("")
+' 2>/dev/null)
+
+if [ -z "$EXIST_ID" ]; then
+  EXIST_ID=$(curl --noproxy '*' -s --max-time 15 -X POST "http://${VB_HOST}:${VB_PORT}/profiles" \
+    -H "Content-Type: application/json" \
+    -d '{"name":"WorkRelay 千问女声","description":"WorkRelay 千问 Qwen3-TTS 预设中文女声","language":"zh","voice_type":"preset","preset_engine":"qwen_custom_voice","preset_voice_id":"Vivian"}' \
+    | python3 -c 'import json,sys; print(json.load(sys.stdin).get("id",""))' 2>/dev/null)
+fi
+
+if [ -n "$EXIST_ID" ]; then
+  echo "$EXIST_ID" > "$PROFILE_FILE"
+  echo "  ✅ 千问预设音色已就绪"
+else
+  echo "  ⚠ 预设音色创建失败，可手动设 WR_VOICEBOX_PROFILE_ID 指定声音"
+fi
+
+# ── TTS 互斥：停止其它 TTS 容器（TTS 只能启用一个）──
+echo "  🔒 互斥处理：停止其它 TTS 容器..."
+for other in voicebox voicebox-luxtts; 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-qwen"
+cp "$INSTALL_DIR/workrelay-tts.sh" "$HOME/.workrelay/speak-qwen/"
+chmod +x "$HOME/.workrelay/speak-qwen/workrelay-tts.sh"
+cp "$INSTALL_DIR/README.md" "$HOME/.workrelay/speak-qwen/" 2>/dev/null || true
+
+if command -v openclaw &>/dev/null; then
+  TTS_SCRIPT="$HOME/.workrelay/speak-qwen/workrelay-tts.sh"
+  # 2026-09-14：openclaw 升级后 TTS 配置在顶层 tts.*（旧 messages.tts.* 已失效）
+  # 独立 provider 名 tts-local-cli-qwen，与 Kokoro(tts-local-cli)/LuxTTS(tts-local-cli-luxtts) 互不覆盖
+  openclaw config set tts.provider tts-local-cli-qwen 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-qwen.command "$TTS_SCRIPT" 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-qwen.args '["{{Text}}","{{OutputPath}}"]' 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-qwen.outputFormat wav 2>/dev/null || true
+  openclaw config set tts.providers.tts-local-cli-qwen.timeoutMs 300000 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-qwen && 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 "  千问 profile: "
+[ -f "$PROFILE_FILE" ] && echo -e "${GREEN}$(cat "$PROFILE_FILE")${NC}" || echo -e "${RED}缺失${NC}"
+
+echo -n "  TTS provider: "
+openclaw config get tts.provider 2>/dev/null | head -1 || echo "(读取失败)"
+
+echo ""
+echo -e "${GREEN}✅ 千问 Qwen3-TTS 安装完成！${NC}"
+echo "  API 地址:  http://${VB_HOST}:${VB_PORT}"
+echo "  管理命令:  docker ps | grep voicebox-qwen"
+echo "  查看日志:  docker logs -f voicebox-qwen"
+echo ""
+echo "  🎙️ 音色：Vivian（中文女声）；其它预设：Serena/Eric/Dylan/Ryan/Aiden 等 9 种"
+echo "  ⏱️ 首次合成需加载 1.7B 模型到内存，会稍慢（CPU 10~60 秒/句）"
+echo ""