jettyd IoT Skill#

Interact with IoT devices via the jettyd platform. Read sensor data, send commands, manage rules, and list devices.

When to use#

Use this skill when the user asks about:

• Device status, online/offline, last seen
• Sensor readings: temperature, humidity, distance, voltage, current
• Controlling actuators: relay, LED, PWM
• Pushing JettyScript rules (threshold alerts, automations)
• Webhook subscriptions for device events
• Anything involving their ESP32 or jettyd devices

Config#

Reads API key from ~/.openclaw/openclaw.json:

json

{
  "skills": {
    "entries": {
      "jettyd": {
        "apiKey": "tk_xxxx",
        "baseUrl": "https://api.jettyd.com/v1"
      }
    }
  }
}

Or from env: JETTYD_API_KEY

CLI#

All operations go through scripts/jettyd-cli.js.

bash

node skills/jettyd/scripts/jettyd-cli.js <command> [args]

Commands#

CommandDescriptionlistList all devices with statusdevice <id>Device detail + all sensor readingstelemetry <id> [metric] [period]Historical readings (1h/6h/24h/7d)command <id> <action> [params]Send command to devicepush_config <id> <json_or_file>Push JettyScript ruleswebhooksList webhook subscriptionscreate_webhook <name> <url> <events...>Create webhook

Example prompts#

"What devices do I have?" → node .../jettyd-cli.js list

"What's the temperature on my greenhouse sensor?" → node .../jettyd-cli.js list to find device ID, then device <id>

"Turn on the relay on device abc123" → node .../jettyd-cli.js command abc123 relay.on

"Blink the LED 3 times" → node .../jettyd-cli.js command abc123 led.blink '{"count":3,"interval_ms":300}'

"Alert me if temperature goes above 30°C" → Compose JettyScript JSON and run push_config <id> <json>

"Show me temperature history for the last 24 hours" → node .../jettyd-cli.js telemetry abc123 temperature 24h

push_rules — JettyScript rule format#

Use push_config <id> <json> to deploy rules to a device. Rules run on the jettyd cloud and fire webhooks / alerts when conditions are met.

Temperature alert example — alert when temperature exceeds 30 °C:

json

{
  "rules": [
    {
      "id": "temp-high-alert",
      "trigger": {
        "type": "threshold",
        "metric": "temperature",
        "operator": ">",
        "value": 30
      },
      "cooldown_seconds": 300,
      "actions": [
        {
          "type": "alert",
          "severity": "warning",
          "message": "Temperature is {{temperature}}°C — above threshold of 30°C"
        }
      ]
    }
  ]
}

Push it:

bash

node skills/jettyd/scripts/jettyd-cli.js push_config <device-id> '{"rules":[...]}'
# or from a file:
node skills/jettyd/scripts/jettyd-cli.js push_config <device-id> ./rules.json

Supported trigger operators: > < >= <= == != Supported action types: alert webhook command