agentCLAWHUBUnverified

Task Notifier

Tighten Task Notifier README consent and rollback docs.

OpenClaw

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 10, 2026

Version

1.1.5

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 10, 2026
Latest release
1.1.5release · observed Aug 16, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s175nq30bpd8fw1je74javsep986kcy9:task-notifier
  1. Install using `clawhub skill install s175nq30bpd8fw1je74javsep986kcy9:task-notifier` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/wdgame/task-notifier before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-wdgame-task-notifier/snapshot"

Documentation

CLAWHUB

95,545 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: "Task Notifier"
description: "Tighten Task Notifier README consent and rollback docs."
---

# Task Notifier

Task Notifier is an OpenClaw notification helper. When the runtime plugin is installed, it sends a native desktop notification after an OpenClaw agent finishes a user-initiated task, unless OpenClaw is currently the active foreground window.

> For the AI agent: this skill is documentation and operating guidance. The actual desktop notification behavior requires the separate runtime plugin package.

## When to use this skill

Use this skill when the user explicitly asks to install, set up, configure, verify, debug, update, or uninstall Task Notifier, or explicitly asks for desktop notifications when OpenClaw agents finish work.

Do not treat generic mentions of notifications, alerts, reminders, desktop settings, or operating-system notification behavior as permission to install or configure Task Notifier. In those cases, answer the user's actual question first and only discuss Task Notifier if it is clearly relevant.

## Safe setup workflow

If the user asks to set up or check Task Notifier, first check whether the runtime plugin is installed:

```bash
test -f ~/.openclaw/extensions/task-notifier/src/index.js && echo installed || echo missing
```

If it is missing, explain plainly:

> Task Notifier needs its runtime plugin to send desktop notifications. The skill only documents the workflow; the plugin is the code that registers OpenClaw lifecycle hooks and calls local OS notification commands.

Before installing, get explicit user confirmation. Tell the user what the install changes:

- downloads the runtime plugin to `~/.openclaw/extensions/task-notifier/`;
- enables `task-notifier` in OpenClaw plugin config;
- adds it to `plugins.allow`;
- grants lifecycle hook access with `allowConversationAccess`;
- requires `--dangerously-force-unsafe-install` because the plugin intentionally runs local notification commands.

The flag is a real security decision, not a cosmetic warning. The runtime plugin is designed to use local OS notification tools (`osascript` on macOS, PowerShell on WSL-on-Windows, and `notify-send` on Linux fallback), inspect the active foreground window title for suppression, and write small per-run state files under the active workspace's `.openclaw-task/` directory. The runtime itself does not need network access for notifications, but installing or updating from ClawHub uses network access.

Privacy note: `allowConversationAccess` lets the runtime receive OpenClaw lifecycle hook context for conversations and agent turns. Task Notifier uses that context only to decide when a user-initiated agent run started/ended, identify the agent name, and avoid heartbeat/cron/system-event noise. Do not install it unless the user explicitly accepts persistent lifecycle hook access across agents.

After explicit approval, install the runtime plugin:

```bash
openclaw plugins install clawhub:task-notifier --dangerously-force-unsa

README.md

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

## Security and privacy notice

Task Notifier has two parts: this skill documentation and a separate runtime plugin. The runtime plugin is persistent until disabled or uninstalled.

Before installing, understand that the runtime plugin:

- installs code under `~/.openclaw/extensions/task-notifier/`;
- enables `task-notifier` in OpenClaw plugin config;
- adds `task-notifier` to `plugins.allow`;
- grants lifecycle hook access with `allowConversationAccess`;
- restarts the OpenClaw Gateway during setup;
- writes small per-run state files under each active workspace's `.openclaw-task/` directory;
- reads the active foreground app/window title to suppress notifications while OpenClaw is already active;
- runs local OS notification commands (`osascript`/`afplay` on macOS, PowerShell on WSL-on-Windows, `notify-send` on Linux fallback).

`allowConversationAccess` lets the plugin receive OpenClaw lifecycle hook context for conversations and agent turns. Task Notifier uses that context to detect user-initiated run start/end, identify the agent name, and filter heartbeat/cron/system-event turns. Install it only if you accept that persistent hook access across agents.

The notifier runtime does not need network access for sending desktop notifications. Installing or updating from ClawHub does use network access.

## Install

Review the source and the install command first. Then install only after explicit consent:

```bash
openclaw plugins install clawhub:task-notifier --dangerously-force-unsafe-install
```

The `--dangerously-force-unsafe-install` flag is required because the plugin intentionally runs local OS notification commands and registers lifecycle hooks. Treat it as a real security decision, not a cosmetic warning.

Restart and verify:

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

## Manual verification

Run diagnostics:

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

Send a test notification:

```bash
AGENT_NAME="Task Notifier Test" STATE_DIR=/tmp/task-notifier-test STATE_FILE=/tmp/task-notifier-test/runs/manual.env \
  ~/.openclaw/extensions/task-notifier/src/task-notify.sh done "Task Notifier test"
```

## Revert

To disable or remove the runtime plugin:

```bash
openclaw plugins disable task-notifier || true
openclaw plugins uninstall task-notifier || true
openclaw gateway restart
```

You can also delete stale per-run state from workspaces after uninstalling:

```bash
find ~/.openclaw/workspace -path '*/.openclaw-task/runs/*.env' -type f -delete
```

## Agent filters

By default Task Notifier watches the main agent and all subagents. Include/exclude entries match either the raw agent id or the di

references/README.md

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

## Security and privacy notice

Task Notifier has two parts: this skill documentation and a separate runtime plugin. The runtime plugin is persistent until disabled or uninstalled.

Before installing, understand that the runtime plugin:

- installs code under `~/.openclaw/extensions/task-notifier/`;
- enables `task-notifier` in OpenClaw plugin config;
- adds `task-notifier` to `plugins.allow`;
- grants lifecycle hook access with `allowConversationAccess`;
- restarts the OpenClaw Gateway during setup;
- writes small per-run state files under each active workspace's `.openclaw-task/` directory;
- reads the active foreground app/window title to suppress notifications while OpenClaw is already active;
- runs local OS notification commands (`osascript`/`afplay` on macOS, PowerShell on WSL-on-Windows, `notify-send` on Linux fallback).

`allowConversationAccess` lets the plugin receive OpenClaw lifecycle hook context for conversations and agent turns. Task Notifier uses that context to detect user-initiated run start/end, identify the agent name, and filter heartbeat/cron/system-event turns. Install it only if you accept that persistent hook access across agents.

The notifier runtime does not need network access for sending desktop notifications. Installing or updating from ClawHub does use network access.

## Install

Review the source and the install command first. Then install only after explicit consent:

```bash
openclaw plugins install clawhub:task-notifier --dangerously-force-unsafe-install
```

The `--dangerously-force-unsafe-install` flag is required because the plugin intentionally runs local OS notification commands and registers lifecycle hooks. Treat it as a real security decision, not a cosmetic warning.

Restart and verify:

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

## Manual verification

Run diagnostics:

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

Send a test notification:

```bash
AGENT_NAME="Task Notifier Test" STATE_DIR=/tmp/task-notifier-test STATE_FILE=/tmp/task-notifier-test/runs/manual.env \
  ~/.openclaw/extensions/task-notifier/src/task-notify.sh done "Task Notifier test"
```

## Revert

To disable or remove the runtime plugin:

```bash
openclaw plugins disable task-notifier || true
openclaw plugins uninstall task-notifier || true
openclaw gateway restart
```

You can also delete stale per-run state from workspaces after uninstalling:

```bash
find ~/.openclaw/workspace -path '*/.openclaw-task/runs/*.env' -type f -delete
```

## Agent filters

By default Task Notifier watches the main agent and all subagents. Include/exclude entries match either the raw agent id or the di

_meta.json

{
  "ownerId": "kn77xhekpmh6nz586ytdbk98sx86j8zx",
  "slug": "task-notifier",
  "version": "1.1.5",
  "publishedAt": 1786915221610
}

skill-card.md

## Description:

Task Notifier helps agents guide users through installing, configuring, verifying, troubleshooting, updating, or removing desktop notifications for completed OpenClaw agent tasks.

This skill is ready for commercial/non-commercial use.

## Publisher:

[wdgame](https://clawhub.ai/user/wdgame)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and OpenClaw users use this skill to manage Task Notifier setup and operations so they can receive desktop notifications when long-running main-agent or subagent tasks finish. It also provides consent, verification, configuration, and rollback guidance for the separate runtime plugin.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Installing Task Notifier requires an unsafe-install bypass for a separate persistent runtime plugin with OpenClaw lifecycle access that was not included for review.

Mitigation: Install only after explicit user consent, prefer a reviewed and pinned runtime version or source bundle, and use the documented disable, uninstall, and state-cleanup steps if removing it.

Risk: The runtime plugin can inspect active foreground window titles, run local notification commands, and write per-run state files in active workspaces.

Mitigation: Review the requested permissions before installation, keep agent filters and active-window matching narrowly configured, and run the documented doctor check after setup.

## Reference(s):

- [Task Notifier ClawHub Page](https://clawhub.ai/wdgame/skills/task-notifier)
- [Task Notifier Reference README](references/README.md)

## Skill Output:

**Output Type(s):** [Guidance, Markdown, Shell commands, Configuration]

**Output Format:** [Markdown guidance with bash command blocks and configuration examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Provides install, verification, debugging, configuration, and rollback guidance; desktop notification behavior depends on a separate runtime plugin.]

## Skill Version(s):

1.1.5 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/wdgame/skills/task-notifier",
      "sourceUrl": "https://clawhub.ai/wdgame/skills/task-notifier",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T22:31:18.443Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-wdgame-task-notifier/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-wdgame-task-notifier/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T22:31:18.443Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/wdgame/task-notifier",
      "sourceUrl": "https://clawhub.ai/wdgame/task-notifier",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T22:31:18.443Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.1.5",
      "href": "https://clawhub.ai/wdgame/task-notifier",
      "sourceUrl": "https://clawhub.ai/wdgame/task-notifier",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-16T21:20:21.610Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-wdgame-task-notifier/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-wdgame-task-notifier/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.1.5",
      "description": "Add ClawHub skill card with clear runtime permission disclosure.",
      "href": "https://clawhub.ai/wdgame/task-notifier",
      "sourceUrl": "https://clawhub.ai/wdgame/task-notifier",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-16T21:20:21.610Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Task Notifier and adjacent AI workflows.