History

i-trytoohard b9b20e19d1 chore: release 0.6.0 (#1723 ) * chore: release 0.6.0 * test(agent-codex): bump version pin to 0.6.0 --------- Co-authored-by: Prateek <karnalprateek@gmail.com>		2026-05-08 02:37:44 +05:30
..
src	chore: rename @composio scope to @aoagents across all packages	2026-04-09 15:59:33 +00:00
CHANGELOG.md	chore: release 0.6.0 (#1723 )	2026-05-08 02:37:44 +05:30
README.md	fix: address CodeRabbit review comments	2026-03-26 21:58:19 +05:30
package.json	chore: release 0.6.0 (#1723 )	2026-05-08 02:37:44 +05:30
tsconfig.json	fix: scope node types to node packages	2026-04-13 18:25:21 +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.