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:
{
"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.
node skills/jettyd/scripts/jettyd-cli.js <command> [args]
Commands
| Command | Description |
|---|---|
list | List all devices with status |
device <id> | Device detail + all sensor readings |
telemetry <id> [metric] [period] | Historical readings (1h/6h/24h/7d) |
command <id> <action> [params] | Send command to device |
push_config <id> <json_or_file> | Push JettyScript rules |
webhooks | List webhook subscriptions |
create_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:
{
"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:
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