Web Flash

Prerequisites

At this point, you should already have assembled the ESP-Claw breadboard hardware, or prepared other ESP-Claw compatible hardware. You can view the list of ESP-Claw compatible development boards in boards application/edge_agent/boards/ . ESP-Claw requires at least 8 MB Flash and 8 MB PSRAM, currently supports ESP32-S3 and ESP32-P4.

Before flashing, prepare a computer with Chrome or Edge installed. Web flashing is not available in Firefox for now.

Tip

Advanced: Build from source and flash.

Web flash

1. Connect the board with a data cable

   Connect the board to your PC with a USB data cable. If you are using the breadboard form ESP-Claw, it is recommended to use the USB port labeled UART.

2. Open the web flasher and connect serial

   Web flash Open the web flasher to program ESP-Claw on ESP32

   Open the web flasher, click Connect, and connect to your board.

   The web flasher will detect the chip model on the board. Select the matching board (vendor/brand and board model), then click Flash to start programming.

   Advanced options

   By default, the web flasher programs all partitions but does not erase the entire Flash. As a result, NVS configuration is usually preserved when updating firmware. If you have special requirements, such as erasing the entire Flash, you can adjust this in Advanced options.

3. Configure Wi-Fi

   After flashing completes, the web flasher will try to connect to ESP-Claw and open the Wi-Fi configuration page. Configure the Wi-Fi SSID and password to continue.

   Can't enter the Wi-Fi configuration step?

   If you can’t enter the Wi-Fi configuration step, try connecting to the SoftAP provided by ESP-Claw and update the config there. ➡️Web config

4. Configure other options

   • Configure LLM: Supports GPT (OpenAI), Qwen (Alibaba Bailian), Claude (Anthropic), and DeepSeek (DeepSeek API). Generate an API Key as prompted and enter it.

     Please select a model with strong reasoning ability

     ESP-Claw’s self-programming, complex tool combination, and other advanced features rely on the ability of strong reasoning models. We recommend using GPT-5.4, Qwen3.6-plus, Claude4.6-sonnet, DeepSeek v4 Pro, or similar performance models to get the best experience.

   • Configure chat apps to connect: currently supports Telegram, QQ Bot (OpenClaw), Feishu, and WeChat ClawBot. You can fill several at once.

     Chat app	Setting	Help
     Telegram	Bot token	Telegram Bot docs
     QQ Bot	ID and secret	QQ Bot site
     Feishu	App ID and secret	Feishu doc
     WeChat ClawBot	Automatic configuration via WeChat QR scan	N/A

   • Configure search engine:

     Tip

     After a search engine is configured, ESP-Claw can retrieve up-to-date information from the web. Weather queries also depend on search engine support.

     Tavily is recommended and provides a free quota.

     Open Tavily Dashboard, sign up and sign in, copy an API Key, then paste it into the Tavily field in the web flasher.

   • Configure advanced settings (optional). See Configuration.

5. Flash

   Click the Flash button to start flashing.

6. Start using it

   After flashing completes, the device restarts automatically and is ready to use.

Next steps

First interactions Configuration