🚀 OpenClaw Desktop - 开箱即用版本

真正的便携式桌面应用，双击即用，无需任何配置

🏠 教程首页 📚 学习路线 🚀 功能展示 🛡️ 安全指南 📖 开发文档 🔧 安装配置指南 💡 OpenClaw介绍 ⬇️ 下载 EXE

1️⃣ 开箱即用版本开发过程

开发理念

传统桌面应用需要用户预装 Node.js 环境，通过 npm 安装依赖后才能运行。我们的"开箱即用"版本将所有依赖内置到应用中，用户只需下载 EXE 文件双击即可使用。

核心开发步骤

技术架构

📦

应用打包

Electron 应用 + 内置 OpenClaw CLI + 配置管理器

↓
🚀

首次运行

检测配置文件，显示设置向导

↓
🔑

API Key 配置

用户选择提供商并输入密钥

↓
🔒

加密存储

配置信息加密保存到用户目录

↓
💬

正常使用

启动网关服务，开始 AI 对话

2️⃣ 所需依赖

开发环境依赖

Node.js 18+

开发时需要 Node.js 18 或更高版本

npm 9+

包管理器，用于安装依赖和运行脚本

Electron 28.0.0

桌面应用框架，打包核心

electron-builder 24.9.1

打包工具，生成可执行文件

应用内置依赖

以下依赖会被打包到应用中，用户无需安装：

OpenClaw 2026.3.8

AI 代理核心 CLI 工具

electron-store

配置管理，持久化存储

axios

HTTP 请求库

Node.js 运行时

Electron 内置，无需单独安装

package.json 配置

{
  "dependencies": {
    "electron-store": "^8.1.0",
    "axios": "^1.6.2",
    "openclaw": "^2026.3.8"
  },
  "devDependencies": {
    "electron": "^28.0.0",
    "electron-builder": "^24.9.1"
  }
}

3️⃣ 注意事项

⚠️ 构建时注意事项

文件锁定问题：Windows 下构建时如有 Electron 应用运行，会导致构建失败。请关闭所有 Electron 相关应用后再构建。

Bundle 大小：OpenClaw CLI 包含大量依赖，打包后的应用约 200-250MB。

首次构建：首次构建会自动下载 Electron 二进制文件，可能需要较长时间。

⚠️ 运行时注意事项

API Key 必需：使用前必须配置至少一个 AI 提供商的 API Key。

网络连接：应用需要联网才能访问 AI 模型服务。

配置目录：配置存储在 %APPDATA%\OpenClaw Desktop\openclaw\，卸载时如需清理请手动删除。

✅ 开发最佳实践

开发模式：使用 npm start 进行开发调试，使用 npm run build 生成最终版本。

Bundle 更新：修改依赖后运行 npm run prepare-bundle 更新内置 CLI。

配置测试：每次更新配置相关代码后，建议删除配置目录重新测试首次运行流程。

常见问题处理

问题 原因 解决方案
Bundle 不可用 Bundle 目录不存在或损坏 运行 npm run prepare-bundle
网关启动失败 端口被占用或配置错误 检查端口 18789 是否被占用
聊天返回错误 未配置 API Key 或 Key 无效 在设置页面配置有效的 API Key
响应解析失败 OpenClaw 响应格式变化 更新 _parseResponse 方法

4️⃣ 支持的平台和系统

完全支持的平台

🪟

Windows 10/11

✔ 完全支持

64 位系统

便携式 EXE

可扩展支持的平台

🍎

macOS

✔ 可构建

需要额外配置

DMG 安装包

🐧

Linux

✔ 可构建

AppImage/DEB/RPM

需要测试验证

系统要求

操作系统

Windows 10/11 64位

Build 16299 或更高

内存

至少 4GB RAM

推荐 8GB 或更多

磁盘空间

应用：~250MB

配置和数据：~50MB

网络

稳定的互联网连接

访问 AI 模型服务

🎯 目标用户定位

终端用户：不想了解技术细节，只想快速使用 AI 助手的普通用户

企业用户：需要在多台电脑上部署，希望简化安装流程

离线场景：可以在无网络环境下安装（使用时仍需联网）

5️⃣ 运行后执行顺序

完整用户流程

📥

步骤 1：下载并运行

下载 OpenClaw-Desktop-1.0.0-Standalone.exe，双击运行

↓
👋

步骤 2：首次运行检测

应用检测到首次运行，自动显示配置向导

↓
🏠

步骤 3：欢迎页面

介绍 OpenClaw 功能和系统要求

↓
🔑

步骤 4：选择提供商

选择 AI 服务商（智谱 AI、OpenAI 等）并输入 API Key

↓
🤖

步骤 5：选择默认模型

从可用模型列表中选择默认使用的模型

↓
✅

步骤 6：完成配置

确认配置摘要，点击"开始使用"按钮

↓
🚀

步骤 7：自动启动网关

应用自动启动 OpenClaw 网关服务（端口 18789）

↓
🖥️

步骤 8：显示主界面

显示主页仪表盘，可以开始使用各项功能

日常使用流程

配置管理流程

📂

配置存储位置

%APPDATA%\OpenClaw Desktop\openclaw\

↓
🔒

加密存储

API Key 使用 AES-256 加密存储

↓
💾

自动备份

配置修改时自动创建备份，保留最近 10 个版本

📊 开箱即用版 vs 开发者版对比

特性 开箱即用版 开发者版
部署方式 单文件 EXE，双击即用 需要 Node.js 和 npm
依赖环境 无需预装 Node.js 需要 Node.js 18+
首次运行向导 有，4 步配置流程 无
API Key 加密 AES-256 加密 明文存储
OpenClaw CLI 内置，自动管理 需要通过 npx 调用
应用大小 ~200-250 MB ~50 MB（不含依赖）
适用场景 终端用户、企业部署 开发者、技术用户
更新方式 下载新 EXE 替换 npm update

OpenClaw Desktop - 开箱即用版本 | 真正便携的 AI 助手

🏠 教程首页 📚 学习路线 🚀 功能展示 🛡️ 安全指南 📖 开发文档 🔧 安装配置指南 💡 OpenClaw介绍