Add elevenlabs-stt skill and documentation

skills/elevenlabs-stt/scripts/transcribe.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ElevenLabs Speech-to-Text transcription script
+# Usage: transcribe.sh <audio_file> [options]
+
+show_help() {
+    cat << EOF
+Usage: $(basename "$0") <audio_file> [options]
+
+Options:
+  --diarize     Enable speaker diarization
+  --lang CODE   ISO language code (e.g., en, pt, es, fr)
+  --json        Output full JSON response
+  --events      Tag audio events (laughter, music, etc.)
+  -h, --help    Show this help
+
+Environment:
+  ELEVENLABS_API_KEY  Required API key
+
+Examples:
+  $(basename "$0") voice_note.ogg
+  $(basename "$0") meeting.mp3 --diarize --lang en
+  $(basename "$0") podcast.mp3 --json > transcript.json
+EOF
+    exit 0
+}
+
+# Defaults
+DIARIZE="false"
+LANG_CODE=""
+JSON_OUTPUT="false"
+TAG_EVENTS="false"
+FILE=""
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help) show_help ;;
+        --diarize) DIARIZE="true"; shift ;;
+        --lang) LANG_CODE="$2"; shift 2 ;;
+        --json) JSON_OUTPUT="true"; shift ;;
+        --events) TAG_EVENTS="true"; shift ;;
+        -*) echo "Unknown option: $1" >&2; exit 1 ;;
+        *) FILE="$1"; shift ;;
+    esac
+done
+
+# Validate
+if [[ -z "$FILE" ]]; then
+    echo "Error: No audio file specified" >&2
+    show_help
+fi
+
+if [[ ! -f "$FILE" ]]; then
+    echo "Error: File not found: $FILE" >&2
+    exit 1
+fi
+
+# API key (check env, then fall back to local OpenClaw config/secrets)
+API_KEY="${ELEVENLABS_API_KEY:-}"
+if [[ -z "$API_KEY" ]]; then
+    OPENCLAW_DIR="${HOME}/.openclaw"
+    for CANDIDATE in "$OPENCLAW_DIR/secrets.json" "$OPENCLAW_DIR/openclaw.json"; do
+        if [[ -f "$CANDIDATE" ]]; then
+            API_KEY=$(python3 - "$CANDIDATE" <<'PY'
+import json, sys
+path = sys.argv[1]
+try:
+    with open(path) as f:
+        data = json.load(f)
+except Exception:
+    print("")
+    raise SystemExit(0)
+
+candidates = [
+    ("elevenlabs", "apiKey"),
+    ("messages", "tts", "elevenlabs", "apiKey"),
+]
+for cand in candidates:
+    cur = data
+    ok = True
+    for key in cand:
+        if isinstance(cur, dict) and key in cur:
+            cur = cur[key]
+        else:
+            ok = False
+            break
+    if ok and isinstance(cur, str) and cur:
+        print(cur)
+        raise SystemExit(0)
+print("")
+PY
+)
+            if [[ -n "$API_KEY" ]]; then
+                break
+            fi
+        fi
+    done
+fi
+if [[ -z "$API_KEY" ]]; then
+    echo "Error: ELEVENLABS_API_KEY not set and no local OpenClaw ElevenLabs key was found" >&2
+    exit 1
+fi
+
+# Build curl command
+CURL_ARGS=(
+    -s
+    -X POST
+    "https://api.elevenlabs.io/v1/speech-to-text"
+    -H "xi-api-key: $API_KEY"
+    -F "file=@$FILE"
+    -F "model_id=scribe_v2"
+    -F "diarize=$DIARIZE"
+    -F "tag_audio_events=$TAG_EVENTS"
+)
+
+if [[ -n "$LANG_CODE" ]]; then
+    CURL_ARGS+=(-F "language_code=$LANG_CODE")
+fi
+
+# Make request
+RESPONSE=$(curl "${CURL_ARGS[@]}")
+
+# Check for errors
+if echo "$RESPONSE" | grep -q '"detail"'; then
+    echo "Error from API:" >&2
+    echo "$RESPONSE" | jq -r '.detail.message // .detail' >&2
+    exit 1
+fi
+
+# Output
+if [[ "$JSON_OUTPUT" == "true" ]]; then
+    echo "$RESPONSE" | jq .
+else
+    # Extract just the text
+    TEXT=$(echo "$RESPONSE" | jq -r '.text // empty')
+    if [[ -n "$TEXT" ]]; then
+        echo "$TEXT"
+    else
+        echo "$RESPONSE"
+    fi
+fi