diff --git a/README.md b/README.md
index cead192..a5380b2 100644
--- a/README.md
+++ b/README.md
@@ -45,13 +45,17 @@ You send a message on Telegram. The ESP32-S3 picks it up over WiFi, feeds it int
 ### Install
 
 ```bash
-# You need ESP-IDF v5.5+ installed first:
-# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
-
 git clone https://github.com/memovai/mimiclaw.git
 cd mimiclaw
 
-idf.py set-target esp32s3
+# Ubuntu quick setup (installs ESP-IDF v5.5.2 + toolchain for esp32s3)
+./scripts/setup_idf_ubuntu.sh
+
+# Build with the configured ESP-IDF
+./scripts/build_ubuntu.sh
+
+# Or use upstream manual setup:
+# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
 ```
 
 ### Configure
diff --git a/README_CN.md b/README_CN.md
index 93def4e..48455e3 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -45,13 +45,17 @@ MimiClaw 把一块小小的 ESP32-S3 开发板变成你的私人 AI 助理。插
 ### 安装
 
 ```bash
-# 需要先安装 ESP-IDF v5.5+:
-# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
-
 git clone https://github.com/memovai/mimiclaw.git
 cd mimiclaw
 
-idf.py set-target esp32s3
+# Ubuntu 一键安装（安装 ESP-IDF v5.5.2 + esp32s3 工具链）
+./scripts/setup_idf_ubuntu.sh
+
+# 使用已配置好的 ESP-IDF 构建
+./scripts/build_ubuntu.sh
+
+# 或按官方文档手动安装：
+# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
 ```
 
 ### 配置
diff --git a/README_JA.md b/README_JA.md
index 8ffc09f..c9eebc2 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -45,13 +45,17 @@ Telegramでメッセージを送ると、ESP32-S3がWiFi経由で受信し、エ
 ### インストール
 
 ```bash
-# まずESP-IDF v5.5+をインストールしてください:
-# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
-
 git clone https://github.com/memovai/mimiclaw.git
 cd mimiclaw
 
-idf.py set-target esp32s3
+# Ubuntu向けクイックセットアップ（ESP-IDF v5.5.2 + esp32s3ツールチェーン）
+./scripts/setup_idf_ubuntu.sh
+
+# 設定済みESP-IDFでビルド
+./scripts/build_ubuntu.sh
+
+# もしくは公式手順で手動セットアップ:
+# https://docs.espressif.com/projects/esp-idf/en/v5.5.2/esp32s3/get-started/
 ```
 
 ### 設定