← 返回 Skills 市场
symbolstar

Echo

作者 SymbolStar · GitHub ↗ · v0.2.0 · MIT-0
cross-platform ⚠ suspicious
92
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install echo-cue
功能描述
Patch a locally installed OpenClaw Control UI so that finishing an assistant reply plays a short Web-Audio two-tone "ding-dong" chime in the browser tab. Loc...
使用说明 (SKILL.md)

echo-cue 🔔 (a.k.a. "echo")

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 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:

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)

// 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')

Uninstall

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 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

File Purpose
apply.sh Detect every OpenClaw install, idempotent inject IIFE, backup, cache-bust
remove.sh Restore from .milly.bak files
inject/completion-cue.iife.js The patch payload
tests/manual.md 7-step verify checklist

Related

安全使用建议
Before installing, understand that this is a local patch: it rewrites OpenClaw Control UI bundle files and index.html in detected installs so the browser can play a chime. The artifacts include backups and an uninstall script, and no exfiltration or credential handling is evident.
功能分析
Type: OpenClaw Skill Name: echo-cue Version: 0.2.0 The skill performs automated patching of the OpenClaw Control UI by searching for installations across the system (including global npm and nvm directories) and injecting a JavaScript payload into minified production bundles. While the payload in 'inject/completion-cue.iife.js' appears limited to playing audio cues via the Web Audio API and lacks data exfiltration or network capabilities, the mechanism used in 'apply.sh' to modify application files and 'index.html' in-place is a high-risk behavior. This pattern of modifying production assets across the filesystem is a risky capability that could be repurposed for unauthorized code execution or persistence.
能力评估
Purpose & Capability
The browser payload matches the stated purpose: it watches assistant-message DOM updates and plays a Web Audio chime, with no network calls, credential use, or unrelated data handling shown.
Instruction Scope
The instructions are user-directed, but the default apply script intentionally patches every detected OpenClaw install rather than only one active install.
Install Mechanism
There is no install spec, but SKILL.md asks the user to run a shell script manually; this is disclosed and central to the local-patch purpose.
Credentials
The script searches common global, nvm, pnpm, and OPENCLAW_HOME locations and rewrites OpenClaw UI dist files. That is proportionate to a local UI patch, but users should understand the breadth.
Persistence & Privilege
The patch persists in the installed UI bundle and index.html until removed, but the artifacts disclose backups and include a remove.sh restore path.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install echo-cue
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /echo-cue 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.0
Default behavior change: ring in foreground tabs too (set milly.completionCue.onlyHidden=on to restrict to hidden tabs only).
v0.1.1
Align SKILL name field with published slug (echo-cue).
v0.1.0
Initial release: two-tone Web Audio chime when an assistant reply finishes streaming. Stop-gap for openclaw/openclaw#69186 / PR #73894.
元数据
Slug echo-cue
版本 0.2.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Echo 是什么?

Patch a locally installed OpenClaw Control UI so that finishing an assistant reply plays a short Web-Audio two-tone "ding-dong" chime in the browser tab. Loc... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 92 次。

如何安装 Echo?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install echo-cue」即可一键安装,无需额外配置。

Echo 是免费的吗?

是的,Echo 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Echo 支持哪些平台?

Echo 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Echo?

由 SymbolStar(@symbolstar)开发并维护,当前版本 v0.2.0。

💬 留言讨论