History

Dhruv Sharma 570f3b588f fix: address CodeRabbit review comments - Use consistent regex for OPENCLAW_HOOKS_TOKEN detection and replacement in shell profile (prevents silent no-ops for non-exported lines) - Broaden token detection regex to match lines with/without export prefix and leading whitespace - Fix misleading --non-interactive help text (token is auto-generated) - Fix doctor.ts catch block to say "Notifier checks failed" not "load config" - Fix 204 mock in Discord notifier test (ok: true, not ok: false) - Fix weak no-duplicate assertion in setup.test.ts (actually count list items) - Add discord to notifier options comment in config-instruction.ts - URL-encode threadId in Discord webhook URL construction - Add aoCwd to required[] in openclaw.plugin.json configSchema - Add HTTPS recommendation comment to agent-orchestrator.yaml.example - Add rimraf for cross-platform clean script in notifier-discord - Rename "Recommended Settings" to "Required: Disable Conflicting Built-in Skills" with explicit warning in docs - Add /ao setup post-setup reminder to manually disable coding-agent skill - Fix misleading README non-interactive example wording Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>		2026-03-26 21:58:19 +05:30
..
src	fix: address CodeRabbit review comments	2026-03-26 21:58:19 +05:30
CHANGELOG.md	chore: version packages	2026-03-20 15:47:55 +00:00
README.md	fix: address CodeRabbit review comments	2026-03-26 21:58:19 +05:30
package.json	chore: version packages	2026-03-20 15:47:55 +00:00
tsconfig.json	feat(ao): add OpenClaw notifier plugin for AO escalations	2026-03-09 18:24:30 +05:30

README.md

notifier-openclaw

OpenClaw notifier plugin for AO escalation events.

Quick setup

ao setup openclaw

This interactive wizard auto-detects your OpenClaw gateway, validates the connection, and writes the config. For non-interactive use (e.g., in CI/CD pipelines or automation scripts):

ao setup openclaw --url http://127.0.0.1:18789/hooks/agent --token YOUR_TOKEN --non-interactive

Required OpenClaw config (`openclaw.json`)

{
  "hooks": {
    "enabled": true,
    "token": "<your-hooks-token>",
    "allowRequestSessionKey": true,
    "allowedSessionKeyPrefixes": ["hook:"]
  }
}

AO config (`agent-orchestrator.yaml`)

notifiers:
  openclaw:
    plugin: openclaw
    url: http://127.0.0.1:18789/hooks/agent
    token: ${OPENCLAW_HOOKS_TOKEN}

Behavior

Sends POST /hooks/agent payloads with per-session key hook:ao:<sessionId>.
Defaults wakeMode: now and deliver: true.
Retries on 429 and 5xx responses with exponential backoff.

Token rotation

Rotate hooks.token in OpenClaw.
Update OPENCLAW_HOOKS_TOKEN used by AO.
Verify old token returns 401 and new token returns 200.

Known limitation (Phase 0)

OpenClaw hook ingest is not idempotent by default. Replayed webhook payloads are processed as separate runs.
Owner: AO integration.
Follow-up: add stable event id/idempotency key support.