mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-17 08:02:12 -06:00
Peter Steinberger
a0ad38e71a
* feat(docs-ci): validate config examples against schema * docs: teach canonical agent roster configuration * docs: nest inline environment variables under vars * docs: update canonical media model keys * docs: remove retired config keys from examples * fix(docs-ci): keep audit internals private * feat(docs-ci): validate plugin-owned config examples * fix(docs-ci): validate indented config fences * fix(ci): route manifest changes through docs audit * chore(docs): refresh generated config baselines
75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
---
|
|
summary: "SenseAudio batch speech-to-text for inbound voice notes"
|
|
read_when:
|
|
- You want SenseAudio speech-to-text for audio attachments
|
|
- You need the SenseAudio API key env var or audio config path
|
|
title: "SenseAudio"
|
|
---
|
|
|
|
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](https://senseaudio.cn) |
|
|
| Docs | [docs.senseaudio.cn](https://docs.senseaudio.cn) |
|
|
|
|
## Getting started
|
|
|
|
<Steps>
|
|
<Step title="Set your API key">
|
|
```bash
|
|
export SENSEAUDIO_API_KEY="..."
|
|
```
|
|
</Step>
|
|
<Step title="Enable the audio provider">
|
|
```json5
|
|
{
|
|
tools: {
|
|
media: {
|
|
models: [
|
|
{
|
|
provider: "senseaudio",
|
|
model: "senseaudio-asr-pro-1.5-260319",
|
|
capabilities: ["audio"],
|
|
},
|
|
],
|
|
audio: {
|
|
enabled: true,
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
</Step>
|
|
<Step title="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.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Options
|
|
|
|
| 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 |
|
|
|
|
<Note>
|
|
SenseAudio is batch STT only in OpenClaw. Voice Call realtime transcription
|
|
continues to use providers with streaming STT support.
|
|
</Note>
|
|
|
|
## Related
|
|
|
|
- [Media understanding (audio)](/nodes/audio)
|
|
- [Model providers](/concepts/model-providers)
|