echo 🔔#

ClawHub package name: echo-cue (the slug echo is taken by another publisher; product is called echo locally).

Source: https://github.com/SymbolStar/echoCue

Click the floating 🔔 in the bottom-right corner to open the picker: enable / disable, choose a preset, Preview each sound — no DevTools required.

A zero-build local patch for OpenClaw Control UI (webchat) that plays a short two-tone chime (A5 → E5, ~900ms) when an assistant reply finishes streaming. Designed as a stop-gap until upstream PR openclaw/openclaw#73894 (issue #69186) lands.

Why this exists#

OpenClaw Control UI has no completion sound on main yet. PR #73894 implements it but has been OPEN without review since 2026-04-29. This skill injects an equivalent IIFE into the bundled UI dist so it works today, and gracefully steps aside when upstream ships.

What you get#

• Short ding-dong when the assistant finishes a reply
• Skipped for NO_REPLY / empty silent completions
• Always rings by default (foreground + background); set onlyHidden=on to limit to hidden tabs only
• 4-second hard rate-limit + content-fingerprint dedup → never double-rings on streaming re-renders
• Per-browser localStorage toggles (no UI surface added)
• One-shot apply / remove with backup
• Cache-bust: rewrites index.html to a new bundle filename so plain Cmd+R picks up the patch
• Patches every detected OpenClaw install (brew + nvm + OPENCLAW_HOME) so it works even when Gateway runs under a different node than which openclaw resolves
• Auto-detects upstream PR landing → skips itself

Install#

bash

bash apply.sh

Then refresh your Control UI browser tab (regular Cmd+R is enough, the script cache-busts the bundle filename). Click or press a key once on the page to unlock the AudioContext (this happens automatically the first time you send a message).

Verify#

DevTools console:

js

window.__milly_cue_v1__   // → true

Send a question, switch to another tab — you should hear a ding-dong when the assistant finishes.

Toggle (per browser)#

js

// Disable entirely
localStorage.setItem('milly.completionCue', 'off')

// Re-enable
localStorage.removeItem('milly.completionCue')

// Ring even when the tab is in foreground (default behaviour as of 0.2.0):
localStorage.removeItem('milly.completionCue.onlyHidden')

// Limit ringing to hidden / unfocused tabs only:
localStorage.setItem('milly.completionCue.onlyHidden', 'on')

Sound presets#

Click the floating 🔔 button (bottom-right of Control UI) to open the picker: enable / disable, switch preset (with Preview button per row), toggle "Only when tab is hidden". Settings are stored in localStorage per browser.

keygroupdescriptionchime _(default)_BasicOriginal two-tone bell (A5 → E5, ~900ms). 叮咚。tritoneBasicApproximation of the classic iPhone SMS "Tri-tone" — three quick bright pings (E6 / C6 / G6, ~420ms).popBasicSingle bubble pop — quick upward swoop, ~110ms. 🫭twinkleBasicFast C → E → G arpeggio (triangle, ~280ms). ✨dropletBasicWater droplet — downward sine sweep (1600 → 520 Hz, ~180ms). 💧fishbiteAnimal CrossingFish-bite plonk (low sine plop + tiny splash, ~220ms). 🐟villagerAnimal CrossingDialog "blip" — soft triangle chirp like villagers talking (~90ms). 🐾acbellAnimal CrossingItem ding — single bright bell tone with shimmer (~260ms). 🔔coinSuper MarioClassic two-note coin chirp (B5 → E6 square, ~220ms). 🪙mariojumpSuper MarioJump — fast upward square pitch sweep (~150ms). 🍄oneupSuper Mario1-Up fanfare — ascending arpeggio E5-G5-E6-C6-E6-G6 (~450ms). 🍄powerupSuper MarioMushroom power-up — fast ascending climb (~360ms). 🌟pipeSuper MarioWarp pipe — descending square slide (~280ms). 🟢bumpSuper MarioBlock bonk — short low square thump with a click (~120ms). 🧱nokiaRetroNokia tune — iconic 13-note phrase from Tárrega's Gran Vals (square, ~1.2s). 📱modemRetroDial-up modem mini-impression — hi/low tones + brief screech tail (~600ms). 📞

Add more presets by appending to the SOUNDS array in inject/completion-cue.iife.js (each entry needs key, label, play(ctx, master)), then re-run bash apply.sh. The widget picks them up automatically.

Hide the floating button#

js

localStorage.setItem('milly.completionCue.widget', 'off')
localStorage.removeItem('milly.completionCue.widget')   // bring it back

DevTools fallback (still works):

js

__milly_cue_sounds__              // list available presets
__milly_cue_preview__('tritone')  // preview without sending a message
localStorage.setItem('milly.completionCue.sound', 'tritone')

Uninstall#

bash

bash remove.sh

Restores the original bundle from index-*.js.milly.bak and the original index.html from index.html.milly.bak.

After openclaw update#

The update overwrites dist/control-ui/..., dropping the patch. Re-run:

bash

bash apply.sh

apply.sh is idempotent and detects upstream:

• Already patched → skip
• Upstream responseCompletionSound shipped → skip + advise uninstall

Known limits#

• Anchor: .chat-group.assistant DOM class. If OpenClaw renames it the patch silently does nothing (fail-quiet, no breakage).
• AudioContext requires one user gesture per page load (browser policy).
• Webchat only. TUI / iOS / macOS / Android clients are not covered (they have their own native notification stacks).
• Single audible cue per assistant turn regardless of message length.

File layout#

FilePurposeapply.shDetect every OpenClaw install, idempotent inject IIFE, backup, cache-bustremove.shRestore from .milly.bak filesinject/completion-cue.iife.jsThe patch payloadtests/manual.md7-step verify checklist

Related#

• Issue: openclaw/openclaw#69186
• Upstream PR (stop-gap target): openclaw/openclaw#73894
• Sibling skill (same pattern): agent-tab-title