SenseAudio Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: SenseAudio
개요
이 페이지는 OpenClaw SenseAudio provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: SenseAudio batch speech-to-text for inbound voice notes
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider id | senseaudio |
| Plugin | bundled, enabledByDefault: true |
| Contract | mediaUnderstandingProviders (audio) |
| Auth env var | SENSEAUDIO_API_KEY |
| Default model | senseaudio-asr-pro-1.5-260319 |
| Default URL | https://api.senseaudio.cn/v1 |
| Website | senseaudio.cn |
| Docs | senseaudio.cn/docs |
공식 문서 기반 상세
아래는 공식 providers/senseaudio 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
SenseAudio transcribes inbound audio and voice-note attachments through OpenClaw's shared tools.media.audio pipeline. OpenClaw posts multipart audio to the OpenAI-compatible transcription endpoint and injects the returned text as {{Transcript}} plus an [Audio] block.
| Property | Value |
|---|---|
| Provider id | senseaudio |
| Plugin | bundled, enabledByDefault: true |
| Contract | mediaUnderstandingProviders (audio) |
| Auth env var | SENSEAUDIO_API_KEY |
| Default model | senseaudio-asr-pro-1.5-260319 |
| Default URL | https://api.senseaudio.cn/v1 |
| Website | senseaudio.cn |
| Docs | senseaudio.cn/docs |
시작하기
Set your API key
```bash
export SENSEAUDIO_API_KEY="..."
```
Enable the audio provider
```json5
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "senseaudio", model: "senseaudio-asr-pro-1.5-260319" }],
},
},
},
}
```
Send a voice note
Send an audio message through any connected channel. OpenClaw uploads the
audio to SenseAudio and uses the transcript in the reply pipeline.
옵션
| Option | Path | Description |
|---|---|---|
model |
tools.media.models[].model |
SenseAudio ASR model id |
language |
tools.media.models[].language |
Optional language hint |
prompt |
tools.media.models[].prompt |
Optional transcription prompt |
baseUrl |
tools.media.models[].baseUrl |
Override the OpenAI-compatible base |
headers |
tools.media.models[].headers |
Extra request headers |
SenseAudio is batch STT only in OpenClaw. Voice Call realtime transcription continues to use providers with streaming STT support.
관련 문서
검증 체크리스트
-
openclaw models list --provider senseaudio로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토