diff --git a/desktop/src-tauri/binaries/README.md b/desktop/src-tauri/binaries/README.md
new file mode 100644
index 0000000..1713a4f
--- /dev/null
+++ b/desktop/src-tauri/binaries/README.md
@@ -0,0 +1,79 @@
+# OpenViking Integration
+
+## 重要说明
+
+OpenViking 采用客户端-服务器架构：
+- **服务器** (`openviking-server`): Python 服务，提供核心功能
+- **CLI** (`ov`): Rust 客户端，与服务器通信
+
+**CLI 不能独立运行**，必须与服务器配合使用。
+
+## 系统要求
+
+| 组件 | 要求 | 说明 |
+|------|------|------|
+| Python | **3.10 - 3.12** | ⚠️ Python 3.13+ 可能没有预编译 wheel |
+| Go | 1.22+ | 可选，从源码构建时需要 |
+| C++ 编译器 | GCC/Clang/MSVC | 可选，从源码构建时需要 |
+
+## 推荐使用方式
+
+### 1. 安装并运行 OpenViking 服务器
+
+```bash
+# 安装 Python 包 (推荐 Python 3.10-3.12)
+pip install openviking --upgrade
+
+# 验证安装
+openviking-server --version
+
+# 启动服务器 (默认端口 1933)
+openviking-server
+```
+
+### ⚠️ Python 3.13+ 用户
+
+如果你使用 Python 3.13+，预编译 wheel 可能不可用。推荐方案：
+
+```bash
+# 方案 1: 使用 Python 3.12
+py -3.12 -m pip install openviking
+
+# 方案 2: 使用 conda
+conda create -n openviking python=3.12
+conda activate openviking
+pip install openviking
+```
+
+### 2. ZCLAW 自动管理
+
+ZCLAW 会自动：
+- 检测本地 OpenViking 服务器是否运行
+- 如未运行，自动启动 `openviking-server`
+- 管理服务器生命周期
+
+### 3. 环境变量配置（可选）
+
+```bash
+# 指定远程服务器
+export VIKING_SERVER_URL=http://your-server:1933
+
+# Windows PowerShell
+$env:VIKING_SERVER_URL = "http://your-server:1933"
+```
+
+## 本地回退模式
+
+如果 OpenViking 服务器不可用，ZCLAW 会自动回退到 localStorage 模式（使用 `agent-memory.ts`）。
+
+## 目录内容
+
+| 文件 | 说明 |
+|------|------|
+| `ov-x86_64-pc-windows-msvc.exe` | Mock 二进制（开发测试用） |
+
+## 参考链接
+
+- [OpenViking GitHub](https://github.com/volcengine/OpenViking)
+- [OpenViking PyPI](https://pypi.org/project/openviking/)
+- [完整文档](https://github.com/volcengine/OpenViking#readme)
diff --git a/docs/OPENVIKING_INTEGRATION.md b/docs/OPENVIKING_INTEGRATION.md
index 0859c05..be816c4 100644
--- a/docs/OPENVIKING_INTEGRATION.md
+++ b/docs/OPENVIKING_INTEGRATION.md
@@ -277,22 +277,56 @@ await invoke<VikingServerStatus>('viking_server_restart');
 
 ### 系统要求
 
-- Python 3.10+
-- 可选: Go 1.22+ (用于构建 AGFS 组件)
-- 可选: C++ 编译器: GCC 9+ 或 Clang 11+
+| 组件 | 要求 | 说明 |
+|------|------|------|
+| Python | 3.10 - 3.12 | ⚠️ Python 3.13+ 可能没有预编译 wheel |
+| Go | 1.22+ | 可选，用于从源码构建 AGFS 组件 |
+| C++ 编译器 | GCC 9+ / Clang 11+ / MSVC | 可选，从源码构建时需要 |
+
+### ⚠️ Windows 安装注意事项
+
+**如果使用 Python 3.13+**，预编译 wheel 可能不可用。推荐方案：
+
+1. **安装 Python 3.12**（推荐）：
+   - 从 [python.org](https://www.python.org/downloads/) 下载 Python 3.12
+   - 或使用 `py -3.12 -m pip install openviking`
+
+2. **使用 conda 创建 3.12 环境**：
+   ```bash
+   conda create -n openviking python=3.12
+   conda activate openviking
+   pip install openviking
+   ```
+
+3. **使用 WSL2 + Linux**：
+   ```bash
+   wsl --install -d Ubuntu
+   # 在 WSL 中
+   pip install openviking
+   ```
 
 ### 快速安装 (推荐)
 
 ZCLAW 会自动管理本地 OpenViking 服务器。你只需要安装 OpenViking Python 包：
 
 ```bash
-# 使用 pip 安装
-pip install openviking --upgrade --force-reinstall
+# 使用 pip 安装 (Python 3.10-3.12)
+pip install openviking --upgrade
 
 # 验证安装
 openviking-server --version
 ```
 
+### 安装验证
+
+```bash
+# 检查 OpenViking 是否正确安装
+python -c "import openviking; print(openviking.__version__)"
+
+# 检查服务器命令是否可用
+openviking-server --help
+```
+
 ### 自动服务器管理
 
 ZCLAW 的 `viking-server-manager.ts` 会自动：