History

Prateek 27712442f8 fix: restore GitHub repo URLs to ComposioHQ/agent-orchestrator — only npm scope changed		2026-04-09 16:00:32 +00:00
..
src	chore: rename @composio scope to @aoagents across all packages	2026-04-09 15:59:33 +00:00
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	fix: restore GitHub repo URLs to ComposioHQ/agent-orchestrator — only npm scope changed	2026-04-09 16:00:32 +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.