SenseAudio Speech-to-Text Provider for Inbound Voice Notes

Learn how SenseAudio transcribes inbound voice notes via OpenClaw's audio pipeline. This page covers setup, API key configuration, and usage for developers integrating speech-to-text.

Read this when

  • You want SenseAudio speech-to-text for audio attachments
  • You need the SenseAudio API key env var or audio config path

SenseAudio handles speech-to-text for incoming audio and voice-note files using OpenClaw's shared tools.media.audio pipeline. Multipart audio is submitted by OpenClaw to the transcription endpoint that follows OpenAI's API conventions, and whatever text comes back is inserted into the conversation as {{Transcript}} alongside an [Audio] block.

PropertyValue
Provider idsenseaudio
Pluginbundled, enabledByDefault: true
ContractmediaUnderstandingProviders (audio)
Auth env varSENSEAUDIO_API_KEY
Default modelsenseaudio-asr-pro-1.5-260319
Default URLhttps://api.senseaudio.cn/v1
Websitesenseaudio.cn
Docsdocs.senseaudio.cn

Getting started

Set your API key

export SENSEAUDIO_API_KEY="..."

Enable the audio provider

{
  tools: {
    media: {
      models: [
        {
          provider: "senseaudio",
          model: "senseaudio-asr-pro-1.5-260319",
          capabilities: ["audio"],
        },
      ],
      audio: {
        enabled: true,
      },
    },
  },
}

Send a voice note

Any connected channel can be used to send an audio message. The audio is uploaded by OpenClaw to SenseAudio, and the resulting transcript feeds into the reply pipeline.

Options

OptionPathDescription
modeltools.media.models[].modelSenseAudio ASR model id
languagetools.media.models[].languageOptional language hint
prompttools.media.models[].promptOptional transcription prompt
baseUrltools.media.models[].baseUrlOverride the OpenAI-compatible base
headerstools.media.models[].headersExtra request headers

Note

Within OpenClaw, SenseAudio only performs batch STT. For realtime transcription in Voice Call, you still need a provider that supports streaming STT.

277 words · updated Aug 12, 2026