Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix Feature Request: TUI Notification When Agent Completes (Sound/Desktop Alert)

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

When running long agent tasks in the OpenClaw TUI, users often switch to other terminal windows or applications. Currently, the only indication that an agent has finished is the status line changing from running to idle — which requires the user to actively check the TUI.

Error Message

  • Polling openclaw status in another terminal — works but is manual and error-prone

Root Cause

When running long agent tasks in the OpenClaw TUI, users often switch to other terminal windows or applications. Currently, the only indication that an agent has finished is the status line changing from running to idle — which requires the user to actively check the TUI.

Code Example

{
  tui: {
    notifyOnComplete: true,           // master toggle
    notifyOnCompleteSound: "Glass",   // optional sound name
    notifyOnCompleteMode: "desktop"   // "desktop" | "bell" | "both" | "none"
  }
}
RAW_BUFFERClick to expand / collapse

Summary

When running long agent tasks in the OpenClaw TUI, users often switch to other terminal windows or applications. Currently, the only indication that an agent has finished is the status line changing from running to idle — which requires the user to actively check the TUI.

Feature Request

Add a notification mechanism to alert the user when an agent run completes in the TUI. This could be one or more of:

  1. macOS Desktop Notification (osascript / Notification Center)
  2. Terminal Bell (\a / audible beep)
  3. Configurable Sound (similar to openclaw nodes notify --sound Glass)
  4. Status Bar / Dock Badge highlight

Use Case

I use OpenClaw as a coding agent in the TUI. I send a task, switch to my editor/browser while waiting, and want to be notified when the agent finishes so I can review the results without constantly polling the TUI.

Proposed Configuration

{
  tui: {
    notifyOnComplete: true,           // master toggle
    notifyOnCompleteSound: "Glass",   // optional sound name
    notifyOnCompleteMode: "desktop"   // "desktop" | "bell" | "both" | "none"
  }
}

Alternatives Considered

  • openclaw nodes notify — only works if the machine is registered as a node, not for local TUI mode
  • Polling openclaw status in another terminal — works but is manual and error-prone
  • Having the agent itself run !osascript — hacky, not all agents have shell access, depends on macOS

Environment

  • macOS 26.5 (arm64)
  • OpenClaw TUI in both --local and Gateway-connected mode

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix Feature Request: TUI Notification When Agent Completes (Sound/Desktop Alert)