hashbox-plugin

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

Installation

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:

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:

Example:

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

send_hashbox_notification

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

Parameters:

Example (article):

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

Example (metric):

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):

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