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
- A HashBox iOS app account
- 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:
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | Yes | Your HashBox API token (must start with HB-) |
Example:
configure_hashbox({
"token": "HB-abc123"
})
send_hashbox_notification
Sends a push notification to the HashBox iOS app through the configured Firebase webhook.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
payloadType | "article" | "metric" | "audit" | Yes | Type of notification payload |
channelName | string | Yes | Name of the notification channel |
channelIcon | string | Yes | Icon/emoji for the channel |
title | string | Yes | Notification title |
contentOrData | string | MetricItem[] | AuditFinding[] | Yes | Content body (string for article) or structured data (array for metric/audit) |
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