v0.2.0 — Auto language detection

Language defaults to auto — Whisper detects the language automatically. Set a specific language code to override.

@agentclaws/openclaw-whisper

Voice message transcription for OpenClaw. Send a voice note on Telegram, WhatsApp, or Discord — your agent reads it as text.

Fixes #14374.

Quick Start

openclaw plugins install @agentclaws/openclaw-whisper

Works immediately with local Whisper. No API key needed.

Requirements (local mode)

pip install openai-whisper
apt install ffmpeg

Providers

| Provider | Cost | Speed | Setup | |----------|------|-------|-------| | local (default) | Free | ~10s/msg | pip install openai-whisper | | groq | Free tier | ~1s/msg | Add apiKey to config | | openai | $0.006/min | ~2s/msg | Add apiKey to config |

Local mode is the default. For faster transcription, add a Groq or OpenAI key:

{
  "plugins": {
    "openclaw-whisper": {
      "enabled": true,
      "provider": "groq",
      "apiKey": "gsk_your_key_here"
    }
  }
}

How It Works

1. Voice note arrives via Telegram/WhatsApp/Discord
2. OpenClaw saves audio to ~/.openclaw/media/inbound/
3. Plugin detects new file, transcribes it
4. Text injected into agent context as [Voice] your message here
5. Agent responds naturally

Supports .ogg .opus .mp3 .wav .m4a .webm .flac up to 25MB.

Config

| Option | Default | Description | |--------|---------|-------------| | provider | "local" | "local", "groq", or "openai" | | apiKey | — | API key for groq/openai (not needed for local) | | model | auto | local: base. groq: whisper-large-v3-turbo. openai: whisper-1 | | language | "en" | ISO 639-1 code | | autoTranscribe | true | Watch for new voice messages | | pollSec | 3 | Check interval (seconds) | | watchDir | auto | Override media directory path |

Gateway API

await gateway.request("whisper.transcribe", { file: "/path/to/audio.ogg" });
await gateway.request("whisper.status");

License

MIT

Support

If this plugin is useful, consider supporting development:

• XMR: 846W4nu6fdHCFbbhW9Peu4FNvdFYKBoLKTWntFinf939fZSEJVjuPrgfkaUGiJeZ2uD4Cen3U8FKVPzsAcjUM6SqF9xQ7Am
• SOL (SOL/USDC/USDT): F47DjKkZBJD9Jcm6LdWZCar1Z9aMP8JYG6FbtKjLDbP6