Examples - WireClaw

Quick Start (No Soldering)

beginner no hardware

Flash via browser. Configure via captive portal. Chat on Telegram. Five minutes.

1

Flash

Open Flash Firmware in Chrome. Plug in your ESP32. Click “Install WireClaw.”

2

Configure

Connect to WireClaw-Setup WiFi from your phone. Enter your WiFi credentials, API key, model, and Telegram token in the captive portal.

3

Chat

Open Telegram. Send a message to your bot.

What's the chip temperature?

The chip temperature is 33.2°C.

Set the LED to purple

The LED is now purple.

✓ Working AI agent. No soldering. No code. Five minutes.

Temperature Alert

beginner NTC 10K + resistor

Wire a thermistor. Register it. Get a Telegram alert when it’s too hot.

wiring - NTC 10K voltage divider

  3.3V ──┬──
         │
        [10K resistor]
         │
  GPIO2 ─┤── ADC input
         │
        [NTC 10K]
         │
  GND ───┘

Register a temperature sensor called room_temp on pin 2, type ntc_10k

I have registered a temperature sensor called `room_temp` on pin 2.

Alert me on Telegram when room_temp goes above 30

I will send you a Telegram message when the room temperature goes above 30°C.

Room temperature is 35°C, which is above 30°C!

Web Config Portal

room_temp ntc_10k pin 2

value: 202.5

rule_02 rule_01 ON

room_temp gt 30 val=69 FIRED

→ telegram "Room temperature is {value}°C - too hot!"

✓ Telegram alert fires when temperature crosses 30°C. Edge-triggered - fires once, resets when temp drops back. Survives reboots.

Light-Activated LED

beginner LDR + resistor

Wire a light sensor. LED goes warm when it’s dark. Off when it’s bright. No code.

wiring - LDR voltage divider

  3.3V ──┬──
         │
        [10K resistor]
         │
  GPIO3 ─┤── ADC input
         │
        [LDR]
         │
  GND ───┘

Register a light sensor called light on pin 3, type ldr

Registered a light sensor named `light` on pin 3.

When light drops below 500, set LED warm white. When above, turn LED off.

Okay, I've set up a rule. When the light sensor `light` reads below 500, the LED will turn warm white (255, 255, 150). When it goes above 500, the LED will turn off.

Web Config Portal

light ldr pin 3

value: 11.4

rule_01 light_on ON

light lt 500 val=13 FIRED

→ led_set(255,255,150)

← led_set(0,0,0)

✓ Cover the sensor → LED glows warm. Uncover → LED off. Real-time. No cloud. No polling delay.

Scheduled Reports

beginner no hardware

One chat message. Daily chip temperature on Telegram at 8 AM. Uses the built-in clock sensor.

Every day at 8 AM, send me the chip temperature on Telegram

Rule created: "morning_report" - when clock_hhmm = 800 → Telegram "Good morning! Chip temp: {chip_temp}°C"

Rule visualization

clock_hhmm → eq 800 → telegram

✓ Telegram message every morning at 8:00. No cron. No external hardware. Just a rule on the clock sensor.

NATS Mesh

intermediate 2 ESP32s + NATS server

One device publishes sensor data. Another triggers a rule from it. Cross-device automation over NATS.

A

Device A - Sensor Node

Uses built-in chip_temp. Publishes temperature to NATS subject home.room.temp.

B

Device B - Alert Node

Subscribes to the same NATS subject. Creates an alert rule on the incoming data.

Telegram (Device A)

Create a rule that publishes chip_temp to NATS subject home.room.temp every 60 seconds

OK, I've created a rule named `publish_temp_to_nats` that will publish the `chip_temp` to the NATS subject `home.room.temp` every 60 seconds.

Web Config Portal - Device A

rule_01 publish_temp_to_nats ON

chip_temp always 0 val=31 idle

→ nats_publish "{value}"

Telegram (Device B)

Register a NATS sensor called room_temp on subject home.room.temp

I have registered a NATS sensor named `room_temp` on the subject `home.room.temp`.

Alert me when room_temp goes above 28

I have created a rule to alert you via Telegram when the `room_temp` goes above 28 degrees Celsius.

Room temperature is 31°C, which is above 28°C.

Web Config Portal - Device B

room_temp nats_value virtual

value: 31.0

→ home.room.temp

rule_01 room_temp_high_alert ON

room_temp gt 28 val=31 FIRED

→ telegram "Room temperature is {value}°C, which is above 28°C."

Data flow

chip_temp → NATS → room_temp → Telegram

✓ Two $5 chips. One publishes chip_temp over NATS. The other subscribes and alerts. No external sensors needed.

Serial Bridge

intermediate Arduino + 2 wires

Connect an Arduino over serial. WireClaw reads its output as a sensor. Alert on any reading.

wiring - Arduino to ESP32

  Arduino TX  ──── ESP32 GPIO5 (UART1 RX)
  Arduino GND ──── ESP32 GND

  Arduino sketch: Serial.println(analogRead(A0));

Connect an Arduino on serial at 9600 baud and register it as a sensor called arduino_val

Registered sensor "arduino_val" (serial_text) on UART1 at 9600 baud.

Alert me on Telegram when arduino_val goes above 800

Rule created: "arduino_alert" - when arduino_val > 800 → Telegram "Arduino reading exceeded threshold: {value}"

✓ Any Arduino sensor becomes a WireClaw sensor. Two wires. Full rule engine. Telegram alerts on any reading.

Real Examples