diff --git a/README.ja-JP.md b/README.ja-JP.md
index be31aa4..fb3b6e9 100644
--- a/README.ja-JP.md
+++ b/README.ja-JP.md
@@ -307,6 +307,11 @@ AI を開発ワークフローに統合できます。エージェントを使
 
 - **Node.js**: 22以上（LTS推奨）
 - **パッケージマネージャー**: pnpm 9以上（推奨）またはnpm
+- **Linux（Ubuntu/Debian）**: Electron を実行する前に、必要なシステムライブラリをインストールしてください:
+  ```bash
+  sudo apt-get install -y libnss3 libgtk-3-0 libxss1 libxtst6 libatspi2.0-0 libnotify4 xdg-utils
+  ```
+  Ubuntu 24.04以降では、一部のパッケージに `t64` サフィックスが付いています。上記コマンドを実行すると `apt` が自動的に適切なバリアントを選択します。
 
 ### プロジェクト構成
 
diff --git a/README.md b/README.md
index e3d723a..56c135f 100644
--- a/README.md
+++ b/README.md
@@ -311,6 +311,11 @@ Chain multiple skills together to create sophisticated automation pipelines. Pro
 
 - **Node.js**: 22+ (LTS recommended)
 - **Package Manager**: pnpm 9+ (recommended) or npm
+- **Linux (Ubuntu/Debian)**: Install required system libraries before running Electron:
+  ```bash
+  sudo apt-get install -y libnss3 libgtk-3-0 libxss1 libxtst6 libatspi2.0-0 libnotify4 xdg-utils
+  ```
+  On Ubuntu 24.04+, some packages use a `t64` suffix; run the above command and `apt` will automatically select the correct variant.
 
 ### Project Structure
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 74bebb2..1dbd8c1 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -311,6 +311,11 @@ ClawX 采用 **双进程 + Host API 统一接入架构**。渲染进程只调用
 
 - **Node.js**：22+（推荐 LTS 版本）
 - **包管理器**：pnpm 9+（推荐）或 npm
+- **Linux（Ubuntu/Debian）**：运行 Electron 前，请先安装所需系统库：
+  ```bash
+  sudo apt-get install -y libnss3 libgtk-3-0 libxss1 libxtst6 libatspi2.0-0 libnotify4 xdg-utils
+  ```
+  在 Ubuntu 24.04+ 上，部分软件包使用 `t64` 后缀，运行上述命令后 `apt` 会自动选择正确版本。
 
 ### 项目结构