Build from source and flash

Steps

Prepare the ESP-IDF environment

Follow the ESP-IDF get-started guide, install ESP-IDF v5.5.4, and export the ESP-IDF environment.

After activating the IDF environment, install the ESP Board Manager package:
```
pip install esp-bmgr-assist
```
ESP-Claw uses ESP Board Manager to support multiple development boards.
To add other boards, see the ESP Board Manager component.

Get the ESP-Claw source

git clone https://github.com/espressif/esp-claw.git
cd esp-claw/application/basic_demo

Select a development board
```
idf.py gen-bmgr-config -c ./boards -b <board_name>
# e.g.: idf.py gen-bmgr-config -c ./boards -b esp32_S3_DevKitC_1
```
Supported boards
You can list supported boards with:
```
idf.py gen-bmgr-config -c ./boards -l
```
Or check the application/basic_demo/boards directory.
ESP Board Manager automatically selects the chip target based on the board, so idf.py set-target is not required.
Adjust menuconfig settings Optional
```
idf.py menuconfig
```
Suggested changes:
- (Top) → Basic Demo Config
  - Apply Configuration for baseline settings.
- (Top) → Component config → ESP-Claw Core → Agent stage notification verbosity
  - Simple by default;
  - If you want Event Router to receive agent_stage events (for example, forwarding tool-call progress to IM via router_rules.json), choose Verbose.
  - See Dataflow and automation.
- (Top) → Component config → ESP System Settings
  - Set Channel for console output to match your board hardware.
After the device is running, settings can also persist via NVS, so runtime changes do not require a rebuild. See Configuration.
Build and flash
```
idf.py build
idf.py flash monitor
```