🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Asr Claw

by @dionren

Speech recognition CLI for AI agent automation. Transcribe audio from stdin, files, or URLs.

Versionv1.1.1
Downloads842
TERMINAL
clawhub install asr-claw

πŸ“– About This Skill


name: asr-claw version: 1.1.1 description: Speech recognition CLI for AI agent automation. Transcribe audio from stdin, files, or URLs. metadata: openclaw: homepage: https://github.com/llm-net/asr-claw os: [darwin, linux] arch: [arm64, amd64] requires: bins: [asr-claw] install: kind: download url: https://github.com/llm-net/asr-claw/releases/latest/download/asr-claw-${os}-${arch} dest: bin/asr-claw executable: true checksum_url: https://github.com/llm-net/asr-claw/releases/latest/download/checksums.txt settings: - key: default_engine type: string default: qwen-asr description: Default ASR engine (qwen-asr, whisper, qwen3-asr, doubao, openai, deepgram) - key: default_lang type: string default: zh description: Default language code (zh, en, ja, ko, fr, de, es, ...) - key: model type: string default: Qwen/Qwen3-ASR-0.6B description: "HuggingFace model ID. Options: Qwen/Qwen3-ASR-0.6B (~1.9GB), Qwen/Qwen3-ASR-1.7B (~3.4GB)" - key: hf_mirror type: string default: "" description: "HuggingFace mirror URL for China users (e.g. https://hf-mirror.com)" - key: model_path type: string default: "" description: "Custom model directory path (overrides default ~/.asr-claw/models/)" - key: binary_path type: string default: "" description: "Custom qwen-asr binary path (overrides default ~/.asr-claw/bin/)"

asr-claw

Speech recognition CLI for AI agent automation. Transcribe audio streams from stdin, files, or URLs with multiple ASR engines β€” local and cloud.

Triggers

  • User wants to transcribe audio, speech, or voice to text
  • User needs speech recognition or ASR
  • User wants to convert audio/voice recordings to text
  • User wants to monitor live audio / livestream speech
  • User asks about θ―­ιŸ³θ―†εˆ«γ€θ―­ιŸ³θ½¬ζ–‡ε­—γ€θ½¬ε†™γ€η›΄ζ’­θ―­ιŸ³
  • adb-claw audio capture output needs to be transcribed
  • User wants subtitles (SRT/VTT) generated from audio
  • Binary

    The asr-claw binary is located at ${CLAUDE_PLUGIN_ROOT}/bin/asr-claw.

    If it does not exist, the SessionStart hook will build or download it automatically.

    Setup

    Quick Start (Mac)

    # Install the qwen-asr engine (builds C binary + downloads 0.6B model ~1.9GB)
    asr-claw engines install qwen-asr

    Verify

    asr-claw engines list asr-claw doctor

    OpenClaw Setup

    After installing the skill via ClawHub, configure settings:

    # Set default language (default: zh)
    claw config set asr-claw.default_lang en

    Use a larger model

    claw config set asr-claw.model Qwen/Qwen3-ASR-1.7B

    For China users β€” set HuggingFace mirror

    claw config set asr-claw.hf_mirror https://hf-mirror.com

    Custom model path (e.g., shared NAS)

    claw config set asr-claw.model_path /mnt/models/Qwen3-ASR-0.6B

    Re-run install after changing model settings

    asr-claw engines install qwen-asr

    Settings are stored in ~/.asr-claw/config.yaml:

    default:
      engine: qwen-asr
      lang: zh
      format: json

    engines: qwen-asr: binary: ~/.asr-claw/bin/qwen-asr model_path: ~/.asr-claw/models/Qwen3-ASR-0.6B

    Cloud Engines (no local model needed)

    # OpenAI Whisper API
    export OPENAI_API_KEY=sk-...
    asr-claw transcribe --file audio.wav --engine openai

    Volcengine Doubao (η«ε±±εΌ•ζ“Ž)

    export DOUBAO_API_KEY=... asr-claw transcribe --file audio.wav --engine doubao

    Deepgram (native streaming)

    export DEEPGRAM_API_KEY=... asr-claw transcribe --file audio.wav --engine deepgram

    Commands

    transcribe β€” Core: audio to text

    # File transcription
    asr-claw transcribe --file meeting.wav --lang zh

    Pipe from stdin

    cat audio.wav | asr-claw transcribe --lang zh

    Streaming (real-time, from adb-claw or ffmpeg)

    adb-claw audio capture --stream --duration 60000 | asr-claw transcribe --stream --lang zh

    Subtitle output

    asr-claw transcribe --file lecture.wav --format srt > lecture.srt asr-claw transcribe --file lecture.wav --format vtt > lecture.vtt

    Specify engine

    asr-claw transcribe --file audio.wav --engine whisper --lang en

    Flags:

    | Flag | Default | Description | |------|---------|-------------| | --file | stdin | Input audio file | | --stream | false | Streaming mode (real-time) | | --lang | zh | Language code | | --engine | auto | ASR engine | | --format | json | Output: json, text, srt, vtt | | --chunk | 0 | Fixed-time chunking (disables VAD) | | --rate | 16000 | Sample rate for raw PCM input |

    engines β€” Manage ASR engines

    asr-claw engines list                    # List all engines + status
    asr-claw engines install qwen-asr       # Install local engine (Mac)
    asr-claw engines info qwen-asr          # Engine details
    asr-claw engines start qwen3-asr        # Start vLLM service engine
    asr-claw engines stop qwen3-asr         # Stop service engine
    asr-claw engines status                  # Running engines
    

    doctor β€” Environment check

    asr-claw doctor    # Check platform, engines, dependencies
    

    Engine Matrix

    | Engine | Type | Mac | GPU | Streaming | Install | |--------|------|-----|-----|-----------|---------| | qwen-asr | Local CLI | Yes | No (Accelerate) | VAD | engines install qwen-asr | | qwen3-asr | vLLM Service | No | Yes (CUDA) | Native | engines start qwen3-asr | | whisper | Local CLI | Yes | No | VAD | Manual | | doubao | Cloud API | Yes | β€” | No | Set DOUBAO_API_KEY | | openai | Cloud API | Yes | β€” | No | Set OPENAI_API_KEY | | deepgram | Cloud API | Yes | β€” | Native | Set DEEPGRAM_API_KEY |

    Output Format

    All commands output JSON envelope:

    {
      "ok": true,
      "command": "transcribe",
      "data": {
        "segments": [{"index": 0, "start": 0.0, "end": 2.5, "text": "..."}],
        "full_text": "...",
        "engine": "qwen-asr",
        "audio_duration_sec": 5.5
      },
      "duration_ms": 1230,
      "timestamp": "2026-03-13T10:00:00Z"
    }
    

    Use -o text for plain text, -o quiet for silent.

    With adb-claw

    # Real-time transcription from Android device
    adb-claw audio capture --stream --duration 60000 | asr-claw transcribe --stream --lang zh

    Record then transcribe

    adb-claw audio capture --duration 30000 --file recording.wav asr-claw transcribe --file recording.wav --lang zh

    Save audio + transcribe simultaneously

    adb-claw audio capture --stream --duration 0 | tee backup.wav | asr-claw transcribe --stream

    βš™οΈ Configuration

    Quick Start (Mac)

    # Install the qwen-asr engine (builds C binary + downloads 0.6B model ~1.9GB)
    asr-claw engines install qwen-asr

    Verify

    asr-claw engines list asr-claw doctor

    OpenClaw Setup

    After installing the skill via ClawHub, configure settings:

    # Set default language (default: zh)
    claw config set asr-claw.default_lang en

    Use a larger model

    claw config set asr-claw.model Qwen/Qwen3-ASR-1.7B

    For China users β€” set HuggingFace mirror

    claw config set asr-claw.hf_mirror https://hf-mirror.com

    Custom model path (e.g., shared NAS)

    claw config set asr-claw.model_path /mnt/models/Qwen3-ASR-0.6B

    Re-run install after changing model settings

    asr-claw engines install qwen-asr

    Settings are stored in ~/.asr-claw/config.yaml:

    default:
      engine: qwen-asr
      lang: zh
      format: json

    engines: qwen-asr: binary: ~/.asr-claw/bin/qwen-asr model_path: ~/.asr-claw/models/Qwen3-ASR-0.6B

    Cloud Engines (no local model needed)

    # OpenAI Whisper API
    export OPENAI_API_KEY=sk-...
    asr-claw transcribe --file audio.wav --engine openai

    Volcengine Doubao (η«ε±±εΌ•ζ“Ž)

    export DOUBAO_API_KEY=... asr-claw transcribe --file audio.wav --engine doubao

    Deepgram (native streaming)

    export DEEPGRAM_API_KEY=... asr-claw transcribe --file audio.wav --engine deepgram