From 403783a3b12fb621949ea35df5d0d9e77f3c7f2e Mon Sep 17 00:00:00 2001
From: Marcus Castro <7562095+mcaxtr@users.noreply.github.com>
Date: Sun, 12 Apr 2026 19:41:13 -0300
Subject: [PATCH] fix(tts): correct tagged TTS syntax guidance (#65573)

---
 docs/tools/tts.md                 | 2 +-
 extensions/speech-core/src/tts.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/tools/tts.md b/docs/tools/tts.md
index e7dbb0c889e..0f4a7075e3f 100644
--- a/docs/tools/tts.md
+++ b/docs/tools/tts.md
@@ -235,7 +235,7 @@ Then run:
 
 - `auto`: auto‑TTS mode (`off`, `always`, `inbound`, `tagged`).
   - `inbound` only sends audio after an inbound voice message.
-  - `tagged` only sends audio when the reply includes `[[tts]]` tags.
+  - `tagged` only sends audio when the reply includes `[[tts:key=value]]` directives or a `[[tts:text]]...[[/tts:text]]` block.
 - `enabled`: legacy toggle (doctor migrates this to `auto`).
 - `mode`: `"final"` (default) or `"all"` (includes tool/block replies).
 - `provider`: speech provider id such as `"elevenlabs"`, `"microsoft"`, `"minimax"`, or `"openai"` (fallback is automatic).
diff --git a/extensions/speech-core/src/tts.ts b/extensions/speech-core/src/tts.ts
index 5b664476297..f95fc5cc43c 100644
--- a/extensions/speech-core/src/tts.ts
+++ b/extensions/speech-core/src/tts.ts
@@ -396,7 +396,7 @@ export function buildTtsSystemPromptHint(cfg: OpenClawConfig): string | undefine
     autoMode === "inbound"
       ? "Only use TTS when the user's last message includes audio/voice."
       : autoMode === "tagged"
-        ? "Only use TTS when you include [[tts]] or [[tts:text]] tags."
+        ? "Only use TTS when you include [[tts:key=value]] directives or a [[tts:text]]...[[/tts:text]] block."
         : undefined;
   return [
     "Voice (TTS) is enabled.",