Tools
Rich Notifications
By openclaw plugin for desktop and webhook notifications. day 16 of 20 days of claw.
Install
openclaw plugins install -lConfiguration Example
{
"plugins": {
"rich-notifications": {
"backend": "auto",
"minUrgency": "normal",
"webhookUrl": "https://ntfy.sh/your-topic",
"webhookType": "ntfy"
}
}
}README
# rich-notifications
openclaw plugin for desktop and webhook notifications. get notified when things go wrong, tasks finish, or the agent needs your attention.
supports macos (osascript), linux (notify-send), and webhooks (slack, discord, ntfy, or any URL).
## install
```bash
openclaw plugins install -l .
```
## config
```json
{
"plugins": {
"rich-notifications": {
"backend": "auto",
"minUrgency": "normal",
"webhookUrl": "https://ntfy.sh/your-topic",
"webhookType": "ntfy"
}
}
}
```
### options
| option | default | what it does |
|--------|---------|-------------|
| `backend` | `"auto"` | `auto` (detect OS), `macos`, `linux`, or `webhook` |
| `minUrgency` | `"normal"` | minimum urgency to actually send |
| `notifyOnError` | `true` | notify on tool errors |
| `notifyOnComplete` | `true` | notify on session end |
| `notifyOnApproval` | `true` | notify when agent needs input |
| `webhookUrl` | - | webhook endpoint URL |
| `webhookType` | `"generic"` | `slack`, `discord`, `ntfy`, or `generic` |
| `maxHistory` | `100` | notifications to keep in history |
## tools
- **notify** - send a notification with title, body, urgency
- **notify_config** - view/update settings at runtime
- **notify_history** - list recent notifications
- **notify_test** - send test notification to verify setup
## hooks
- **after_tool_call** - notify on errors (ERROR/FATAL/PANIC in output)
- **on_session_end** - notify on task completion
- **on_approval_request** - notify when agent needs human input
## backends
**auto** picks macos on darwin, linux otherwise. webhook always works as a secondary channel - if you set a webhookUrl, notifications go to both desktop and webhook.
**ntfy** is the easiest webhook setup - free, self-hostable, no auth needed:
```
webhookUrl: "https://ntfy.sh/my-openclaw-alerts"
webhookType: "ntfy"
```
## day 16 of [20 days of claw](https://github.com/StressTestor)
tools
Comments
Sign in to leave a comment