diff --git a/integrations/openclaw-athena-talk/README.md b/integrations/openclaw-athena-talk/README.md index 43e93be..df78cef 100644 --- a/integrations/openclaw-athena-talk/README.md +++ b/integrations/openclaw-athena-talk/README.md @@ -60,7 +60,7 @@ openclaw plugins install . --force --accept-capabilities openclaw plugins inspect athena-talk --runtime --json ``` -Version 1.2.0 also registers **Athena Whisper (Diktieren)** as a separate +Version 1.2.1 also registers **Athena Whisper (Diktieren)** as a separate realtime transcription provider through OpenClaw's official plugin API. In the browser composer, hold the microphone for dictation, then release it to send the 8 kHz G.711 audio through the Gateway. The plugin converts it to PCM WAV @@ -74,6 +74,48 @@ appears under `transcription.providers`. OpenClaw currently gives a transcription provider five seconds to return its final text after recording stops; the plugin caps its Whisper request at 4.5 seconds. +### Voice-note file attachments + +An M4A voice note uploaded as a chat attachment does **not** use the realtime +dictation provider above. OpenClaw processes it through its built-in +`tools.media.audio` path. On the Unraid installation, automatic provider +selection hit `SsrFBlockedError` for the private Athena address. Configure the +existing OpenAI-compatible provider and select Whisper explicitly: + +```json5 +{ + models: { + providers: { + openai: { + // Keep the existing baseUrl and apiKey SecretRef. + request: { allowPrivateNetwork: true }, + }, + }, + }, + tools: { + media: { + models: [ + { + provider: "openai", + model: "whisper-1", + baseUrl: "http://192.168.1.212:8081/v1", + capabilities: ["audio"], + }, + ], + }, + }, +} +``` + +OpenClaw 2026.9.4 accepts `request.allowPrivateNetwork` under +`models.providers.openai`, not under a `tools.media.models[]` entry. These +settings hot-reload without restarting the Gateway. The existing +`ATHENA_ROUTER_API_KEY` SecretRef is reused; do not add another literal key. +On 2026-09-16, OpenClaw's official audio module transcribed the affected M4A +through Athena Whisper (127 characters returned). This confirms the endpoint +and file format; a fresh attachment in the chat is still needed to verify the +full message-to-transcript flow. + Restart the gateway once if the installation does not trigger an automatic reload. The managed plugin copy is stored in OpenClaw's persistent data directory, so normal image updates do not remove it. Hermes remains unchanged;