@bettsnation/paperclip-plugin-bettsclaw

Paperclip plugin that sends domain event notifications to BettsClaw (Clawd) via webhook for Telegram delivery.

Events

| Event | What Clawd receives | |-------|-------------------| | approval.created | Approval request with details for approve/reject | | approval.decided | Approval outcome confirmation | | agent.run.failed | Agent failure alert | | agent.status_changed (→ error) | Agent error state alert | | issue.updated (→ done) | Issue completion notification | | issue.created (routine) | Routine-created issue notification |

Install

npm install @bettsnation/paperclip-plugin-bettsclaw

Or via Paperclip UI: Instance Settings → Plugins → Install Plugin → @bettsnation/paperclip-plugin-bettsclaw

Configuration

| Setting | Required | Description | |---------|----------|-------------| | webhookUrl | Yes | BettsClaw webhook endpoint | | webhookSecretRef | Yes | Paperclip secret ref for HMAC signing | | notifyApprovals | No | Send approval events (default: true) | | notifyFailures | No | Send failure events (default: true) | | notifyCompletions | No | Send completion events (default: true) |

Webhook Payload

{
  "event_type": "approval.created",
  "timestamp": "2026-04-07T12:00:00.000Z",
  "company_id": "bdba7352-...",
  "entity_id": "b168fa1d-...",
  "entity_type": "approval",
  "actor_id": "0f302e1b-...",
  "actor_type": "agent",
  "payload": { ... }
}

Signed with HMAC-SHA256: X-BettsClaw-Signature header contains HMAC(secret, "${timestamp}.${body}").

License

MIT