agent-orchestrator/packages/plugins/notifier-discord
Adil Shaikh 298057044f
feat(notifier): make notifier system robust with manual harness and desktop setup (#1736)
* fix(notifier-desktop): use terminal-notifier on macOS for click-to-open support

On macOS, when terminal-notifier is installed (brew install terminal-notifier),
desktop notifications now open the dashboard URL when clicked instead of
opening Script Editor. Falls back to osascript when terminal-notifier is
not available.

New config option `dashboardUrl` controls the click-through URL:
  notifiers.desktop.dashboardUrl: "http://localhost:8080"

Refs #1579

* feat(cli): add manual notifier test harness

* feat(cli): add native desktop notifier setup

* fix(cli): handle denied desktop notification permission

* fix(notifier): support composio actions api

* fix(notifier): use composio entity execution

* feat(notifier): add composio setup flows

* Fix notifier setup flows

* feat: add dashboard notifier

* Make notifier payloads semantic v3

* chore: use ao-agent as composio default user

* Improve notifier setup and rich notifications

* Improve desktop notification UX

* Update AO notifier app icon

* Remove redundant dashboard notification actions

* Potential fix for pull request finding 'CodeQL / Client-side cross-site scripting'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

* Fix code scanning notifier alerts

* Address notifier bot review comments

* Address remaining notifier bot reviews

* Update notifier integration assertions after merge

* Fix notifier test fallout after merge

* Address notifier PR review comments

* Fix notifier bot follow-up comments

* Add notification delivery observability

* chore: add notifier logging screenshot

* fix: address notifier logging ci failures

---------

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
2026-05-19 14:48:40 +05:30
..
src feat(notifier): make notifier system robust with manual harness and desktop setup (#1736) 2026-05-19 14:48:40 +05:30
CHANGELOG.md fix(agent-plugins,lifecycle): distinguish indeterminate probe from "not found" + bump ps timeout (closes #1838) (#1839) 2026-05-14 21:50:39 +05:30
README.md feat: OpenClaw plugin, AO skill, Discord notifier, and setup wizard 2026-03-23 21:52:28 +05:30
package.json fix(agent-plugins,lifecycle): distinguish indeterminate probe from "not found" + bump ps timeout (closes #1838) (#1839) 2026-05-14 21:50:39 +05:30
tsconfig.json fix: scope node types to node packages 2026-04-13 18:25:21 +05:30

README.md

notifier-discord

Discord webhook notifier plugin for AO. Sends rich embed notifications for session events, PR creation, CI status, and escalations.

Setup

  1. In your Discord server: Server Settings > Integrations > Webhooks > New Webhook
  2. Copy the webhook URL
  3. Add to agent-orchestrator.yaml:
defaults:
  notifiers:
    - desktop
    - discord

notifiers:
  discord:
    plugin: discord
    webhookUrl: https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

Config options

Option Default Description
webhookUrl (required) Discord webhook URL
username "Agent Orchestrator" Bot display name
avatarUrl (none) Bot avatar image URL
threadId (none) Post to a specific thread
retries 2 Retry attempts on 5xx
retryDelayMs 1000 Base retry delay (exponential backoff)

Features

  • Rich embeds with color-coded priority (red=urgent, blue=action, yellow=warning, green=info)
  • PR links, CI status, and action buttons in embed fields
  • Thread support for organizing notifications by project
  • Retry with exponential backoff on 5xx responses