Task Notifier — OpenClaw Plugin

Desktop notifications when any OpenClaw agent finishes a task. Supports macOS and WSL-on-Windows. Works for all agents and subagents. Smart suppression, auto-language, per-run state for parallel agents, and optional agent/subagent filters.

Why the security warning?

During install OpenClaw will flag this plugin as dangerous and require --dangerously-force-unsafe-install. Treat that as a real security decision: Task Notifier intentionally runs local OS notification commands and registers OpenClaw lifecycle hooks.

Here is exactly what the plugin runs and why:

What the plugin does NOT do:

• No network requests are needed for runtime notifications.
• No outbound data is sent by the notifier runtime.
• No direct access to emails, documents, or unrelated local files is needed.

What the plugin does write/read locally:

• It writes small per-run state files under the active workspace's .openclaw-task/ directory.
• It reads the active foreground app/window title to suppress notifications while OpenClaw is already active.
• The installer updates OpenClaw plugin config to enable task-notifier, add it to plugins.allow, and grant lifecycle hook access.

All source code is in src/ — review it yourself. OpenClaw shows the exact warnings before install so you can verify.

Install

Task Notifier has two parts on ClawHub. Install both:

# 1. Skill (agent documentation)
clawhub install task-notifier

# 2. Plugin (runtime code — this package)
openclaw plugins install clawhub:task-notifier --dangerously-force-unsafe-install

The --dangerously-force-unsafe-install flag is required because the plugin runs local OS notification commands (osascript on macOS, PowerShell on WSL). Review the source and permissions before installing.

Restart and verify:

openclaw gateway restart
bash ~/.openclaw/extensions/task-notifier/scripts/doctor.sh

Agent filters

By default Task Notifier watches the main agent and all subagents. Include/exclude entries match either the raw agent id or the display name, case-insensitively; spaces and underscores are treated like hyphens. Optional env settings:

export TASK_NOTIFIER_NOTIFY_MAIN=true
export TASK_NOTIFIER_NOTIFY_SUBAGENTS=true
export TASK_NOTIFIER_INCLUDE_AGENTS="main,forgemaster"
export TASK_NOTIFIER_EXCLUDE_AGENTS="noisy-agent,avito"
export TASK_NOTIFIER_AGENT_IN_BODY=true
export TASK_NOTIFIER_STATE_TTL_HOURS=24

State is stored per run/session under .openclaw-task/runs/, so parallel agents do not overwrite each other. The agent name is included in the title and body because Windows may display the notification source/app name as the visible header.

Quick links

• ClawHub: https://clawhub.ai/skills/task-notifier
• Install: clawhub install task-notifier
• License: MIT-0