55 lines
2.2 KiB
Plaintext
55 lines
2.2 KiB
Plaintext
---
|
|
title: Notifiers overview
|
|
description: Who gets pinged when an agent needs you. Six notifiers ship; pick one or stack several.
|
|
---
|
|
|
|
Notifiers deliver AO events — session stuck, PR opened, review requested, CI failed — to wherever you actually pay attention.
|
|
|
|
<PluginGrid>
|
|
<PluginCard name="Desktop" logo="apple" href="/docs/plugins/notifiers/desktop" description="Native macOS/Linux notifications. No-op on Windows." />
|
|
<PluginCard name="Discord" logo="discord" href="/docs/plugins/notifiers/discord" description="Discord webhook with rich embeds." />
|
|
<PluginCard name="Slack" logo="slack" href="/docs/plugins/notifiers/slack" description="Slack incoming webhook." />
|
|
<PluginCard name="Webhook" logo="webhook" href="/docs/plugins/notifiers/webhook" description="Generic HTTP POST. Retries + exponential backoff." />
|
|
<PluginCard name="Composio" logo="composio" href="/docs/plugins/notifiers/composio" description="Route through Composio — Slack, Discord, or Gmail." />
|
|
<PluginCard name="OpenClaw" logo="openclaw" href="/docs/plugins/notifiers/openclaw" description="Local OpenClaw gateway for personal alerts." />
|
|
</PluginGrid>
|
|
|
|
## Stacking notifiers
|
|
|
|
Notifier config is a list — pass as many as you want:
|
|
|
|
```yaml
|
|
notifier:
|
|
- type: desktop
|
|
- type: discord
|
|
webhookUrl: ${DISCORD_URL}
|
|
- type: slack
|
|
webhookUrl: ${SLACK_URL}
|
|
channel: "#agents"
|
|
```
|
|
|
|
Each notifier gets every event. AO doesn't try to dedupe across channels — that's your channel-configuration problem, not ours.
|
|
|
|
## Testing
|
|
|
|
```bash
|
|
ao doctor --test-notify
|
|
```
|
|
|
|
Sends a dummy notification through each configured notifier. Good way to verify your webhooks work before an agent needs to wake you at 3 AM.
|
|
|
|
## What gets notified
|
|
|
|
| Event | When |
|
|
|---|---|
|
|
| `session.spawned` | `ao spawn` succeeds |
|
|
| `session.working` | Agent is actively editing code |
|
|
| `pr.opened` | Agent pushed a branch and opened a PR |
|
|
| `ci.failed` | Required check fails |
|
|
| `review.requested` | Reviewer asks for changes |
|
|
| `session.mergeable` | CI green, no blockers |
|
|
| `session.merged` | PR merged |
|
|
| `session.blocked` | Agent is stuck — you need to intervene |
|
|
|
|
You can tune which events fire via [`reactions` config](/docs/configuration).
|