hashbox-plugin#

OpenClaw plugin that connects an AI agent to the HashBox iOS app via Firebase webhook for push notifications.

Installation#

bash

npm install hashbox-plugin

Setup#

Prerequisites#

1. A HashBox iOS app account
2. A valid HB- prefixed API token from your HashBox dashboard

Configuration#

Before using the plugin, configure it with your HashBox API token using the configure_hashbox tool:

text

configure_hashbox({
  "token": "HB-your-token-here"
})

This stores your configuration locally in hashbox_config.json.

Usage#

configure_hashbox#

Sets up the HashBox connection by saving your API token.

Parameters:

ParameterTypeRequiredDescriptiontokenstringYesYour HashBox API token (must start with HB-)

Example:

text

configure_hashbox({
  "token": "HB-abc123"
})

send_hashbox_notification#

Sends a push notification to the HashBox iOS app through the configured Firebase webhook.

Parameters:

ParameterTypeRequiredDescriptionpayloadType``"article" | "metric" | "audit"YesType of notification payloadchannelNamestringYesName of the notification channelchannelIconstringYesIcon/emoji for the channeltitlestringYesNotification titlecontentOrDatastring | MetricItem[] | AuditFinding[]YesContent body (string for article) or structured data (array for metric/audit)

Example (article):

text

send_hashbox_notification({
  "payloadType": "article",
  "channelName": "Builds",
  "channelIcon": "🔨",
  "title": "Build Complete",
  "contentOrData": "Your project compiled successfully with 0 errors."
})

Example (metric):

text

send_hashbox_notification({
  "payloadType": "metric",
  "channelName": "Performance",
  "channelIcon": "📊",
  "title": "Daily Metrics",
  "contentOrData": [
    { "label": "CPU Usage", "value": 42, "unit": "%" },
    { "label": "Memory", "value": 8.2, "unit": "GB" }
  ]
})

Example (audit):

text

send_hashbox_notification({
  "payloadType": "audit",
  "channelName": "Security",
  "channelIcon": "🔒",
  "title": "Audit Log",
  "contentOrData": [
    { "severity": "info", "message": "User logged in from new device" }
  ]
})

Dependencies#

• Node.js >= 18.0.0
• A valid HB- prefixed token from your HashBox account

License#

MIT