Document verified Athena live state and recovery boundaries

This commit is contained in:
Mikei386
2026-09-16 16:16:53 +02:00
parent 7514b858f5
commit a75aea4b7e
7 changed files with 129 additions and 81 deletions
+10 -5
View File
@@ -1,4 +1,4 @@
# Athena realtime voice bridge (experimental)
# Athena realtime voice bridge
This independent service lets OpenClaw's existing browser Talk UI use Athena
Whisper, OpenClaw's agent, and Athena Qwen3-TTS through the browser's supported
@@ -69,7 +69,7 @@ cd /opt/mike-ai/stack
docker compose --env-file /etc/mike-ai/stack.env up -d --no-deps --build realtime-voice
```
OpenClaw 2026.9.4 uses the `athena-talk` plugin version 1.1.0 with
OpenClaw 2026.9.4 uses the `athena-talk` plugin version 1.2.1 with
`talk.realtime.transport` set to `webrtc` and
`talk.realtime.providers.athena-talk.realtimeUpstreamUrl` set to
`http://192.168.1.212:8090/v1/realtime/calls`. On the Mac, turn off
@@ -91,8 +91,13 @@ python3.11 -m venv .venv
The synthetic microphone test passed over the actual OpenClaw HTTPS offer
route and WireGuard media path with production Whisper and Qwen3-TTS on
2026-09-16. It supplied a fake agent result; it does not prove that the Mac
or browser UI completes a real agent-consult turn. Keep this integration
experimental until that UI round trip has been observed.
2026-09-16. Subsequent real browser Talk sessions successfully transcribed
and answered multiple user turns. Browser dictation through the same plugin
also produced text after a correction to its separate transcription path.
The first user report of a second turn becoming stuck was addressed by
matching conversation item and predecessor IDs; the later two-turn test
passed. This is still half-duplex and needs a private route for WebRTC media.
The plugin's additional support for uploaded M4A voice notes is documented
in `integrations/openclaw-athena-talk/README.md`.
For isolated tests, `ATHENA_TALK_REALTIME_SECRET` can replace
`OPENCLAW_PUBLIC_KEY_URL`; do not use that test mode in the deployed setup.