Document OpenClaw voice-note transcription via Athena

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;