LilyClaw — Web Flasher

// install firmware

Flash LilyClaw AI firmware to your ESP32-S3 board directly from the browser.
No tools. No drivers. Just USB and one click.

Requires Chrome or Edge · WebSerial API

WebSerial not available. Use Chrome or Edge on desktop.

// setup guide

1

Plug in your ESP32-S3

USB-C data cable. T-Display S3 has native USB.

2

Click "Flash LilyClaw"

Select the serial port. Firmware writes in ~30 seconds.

3

Connect to WiFi `LilyClaw-Setup`

Device starts an access point. Password: lilyclaw1

4

Configure at `192.168.4.1`

Set WiFi, Telegram token, Claude API key. Save & reboot.

⚠️

First install erases all data. Updates preserve your config.

// v1.3 wiring guide

Connect the HC-SR04 sensor and 4 SG90 servos to your T-Display S3:

  HC-SR04          T-Display S3          Servos (SG90)
 ┌────────┐       ┌────────────┐
 │VCC ── 5V──────┤ 5V      G18├────── Tete H (↔)
 │TRIG─ G16──────┤            │
 │ECHO─ G17──┐   │         G10├────── Tete V (↕)
 │GND ── GND─┤   │            │
 └────────┘  │   │         G11├────── Pince Gauche
   ⚠ Diviseur│   │            │
   1kΩ+2kΩ  │   │         G12├────── Pince Droite
   sur ECHO  │   │            │
             └───┤ GND     5V ├────── Servos VCC (rouge)
                 └────────────┘       Servos GND (marron)

!

5V Power

SG90 servos + HC-SR04 = 5V. Add a 470µF capacitor on the 5V rail to prevent brownouts.

!

ECHO 5V → 3.3V

HC-SR04 ECHO outputs 5V. Use a voltage divider (1kΩ + 2kΩ) or a 3.3V module (RCWL-1601).

// requirements

Board	ESP32-S3 · 16MB flash · 8MB PSRAM
Tested	LilyGo T-Display S3, Xiaozhi AI
Browser	Chrome 89+ or Edge 89+
Cable	USB-C (data, not charge-only)
Accounts	Telegram Bot + Anthropic API key

// what's new in v1.4.9

★

Fix: LLM Timeout 120s → 30s + TCP Keep-Alive

HTTP timeout réduit de 120s à 30s pour éviter de bloquer l'agent pendant 2 minutes sur erreur réseau. TCP keep-alive activé pour prévenir les "Connection reset by peer" causés par l'inactivité de la connexion.

★

Fix: Retry automatique LLM (2 tentatives)

Sur échec réseau, l'agent retente automatiquement 2 fois avec un backoff de 3s puis 6s avant de retourner une erreur à l'utilisateur. Récupère les coupures WiFi transitoires.

★

Fix: Sentinel non désarmé par geste WAVE (Full variant)

Un mouvement détecté par le capteur ne peut plus désarmer accidentellement le mode sentinelle. Seule la commande explicite sentinel_mode disarm via Telegram peut le faire.

✓

Previous: Smooth Servo Transitions (v1.4.8)

Transitions fluides de la tête avec easing float, screensaver non-bloquant, correction convergence du regard.