夜雨聆风OpenClaw Portable 是一款主打 “即插即用、全离线运行” 的便携式 AI 助手工具，核心定位为跨设备、无依赖、高隐私的轻量化 AI 交互解决方案。它解决了传统 AI 助手安装复杂、依赖网络、设备切换成本高、隐私泄露风险大等痛点，首次实现了 AI 助手从 “复杂部署” 到 “USB 即插即用” 的轻量化转型，既适用于个人用户在共享 / 公共电脑上的隐私化使用，也可满足企业场景下标准化、零配置的 AI 辅助需求。
核心定位关键词：
便携化：可完全运行于 USB 存储设备，跨设备无适配成本；
离线优先：内置本地 AI 模型，首次下载后无需网络即可使用；
零配置：解压即运行，无复杂依赖安装和参数配置；
高隐私：在设备上无数据残留，适配共享 / 公共电脑场景。
What【项目架构】
OpenClaw Portable 采用 “轻量化分层架构 + 便携化封装” 设计，整体架构分为四层，各层解耦且适配便携化需求：
1. 基础层（便携化封装层）
核心作用：实现 “跨设备、无痕迹” 的运行环境封装，屏蔽不同操作系统（以 Windows 为主，兼容 Linux）的环境差异；
关键组件：批处理脚本（.bat）、Shell 脚本（.sh）、便携化目录结构（bin/、config/ 等）；
核心逻辑：通过脚本统一启动 / 停止流程，自动适配设备环境，运行过程中所有数据仅写入便携存储（如 USB），退出后无本地残留。
2. 配置层
核心作用：提供零配置开箱即用能力，同时支持自定义扩展；
关键组件：config/openclaw.json.example（配置示例）、config.html（可视化配置页面）、apply-config.bat（配置应用脚本）；
核心逻辑：默认加载内置离线模型配置，无需手动修改；支持在线版本自定义云 API 配置（如 OpenAI、DeepSeek），配置变更自动生效且不依赖系统环境。
3. 核心运行层
核心作用：承载 AI 模型运行、API 调度、交互核心逻辑；
关键组件：bin/openclaw（核心执行程序）、内置 Qwen2.5-1.5B 模型（离线版本）、模型管理脚本（install-models.js）；
核心逻辑：离线版本自动加载本地 CPU 版模型，无 API 调用成本；在线版本支持云 API 适配，本地仅做调度和交互，兼顾轻量化与灵活性。
4. 交互层
核心作用：提供用户友好的启动、交互、访问方式；
关键组件：启动脚本（start.bat/start.sh）、自动浏览器启动逻辑、Token 自动提取与注入；
核心逻辑：一键启动后自动完成服务初始化（60s 智能等待 + 进度反馈），自动提取访问 Token 并打开浏览器，用户无需手动操作即可进入交互界面。
What【技术栈】
1. 核心运行环境
跨平台脚本：Batch（Windows）、Shell（Linux），实现一键启动 / 停止 / 配置；
轻量化执行程序：bin/openclaw（底层为编译后的可执行文件，适配 x86/AMD64 架构）；
模型运行：CPU 版 Qwen2.5-1.5B 轻量化模型（无 GPU 依赖，降低硬件门槛）。
2. 配置与扩展
配置管理：JSON 配置文件 + HTML 可视化配置页面，支持可视化 / 脚本化配置生效；
模型管理：Node.js 脚本（install-models.js），实现模型自动安装 / 更新；
跨平台兼容：.editorconfig 统一代码规范，脚本适配 Windows/Linux 路径、权限差异。
3. 交互与调度
自动浏览器调用：脚本级浏览器进程管理，自动注入 Token 实现免登录；
进程管理：启动 / 停止 / 重启脚本（start.bat/stop.bat/restart.bat），实现服务生命周期管理；
离线打包：build-offline-package.sh/create-offline.sh 实现离线包构建，内置模型与运行环境一体化封装。
Why【功能与应用】
1. 核心功能
功能分类 | 具体能力 |
离线运行 | 内置 Qwen2.5-1.5B 本地模型，无网络时全功能可用，零 API 调用成本； |
便携使用 | 可安装至 USB 设备，跨电脑即插即用，数据随存储设备同步，无设备绑定； |
零配置启动 | 双击 start.bat（Windows）/start.sh（Linux）即可启动，60s 自动完成初始化，无需手动配置； |
隐私保护 | 运行过程中所有数据仅写入便携存储，退出后设备无任何痕迹，适配共享 / 公共电脑； |
灵活扩展 | 离线版本支持本地模型，在线版本可对接 OpenAI、DeepSeek 等云 API，支持自定义模型接入； |
自动化交互 | 启动后自动提取访问 Token，自动打开浏览器并跳转至交互界面，无需手动复制 Token； |
服务管理 | 提供一键停止、重启、清理脚本，支持服务状态检测（check.bat）、环境清理（cleanup.bat）； |
2. 核心应用场景
个人隐私使用：在公司 / 网吧等共享电脑上使用 AI 助手，避免数据残留和隐私泄露；
移动办公：USB 即插即用，跨办公电脑 / 家用电脑无缝切换，无需重复安装配置；
无网络场景：出差、户外等无网络环境下，依赖内置本地模型完成 AI 辅助（如文本生成、问答）；
企业标准化部署：批量分发至员工设备，零配置即可使用，统一管控 AI 使用规范，降低部署成本；
轻量化 AI 需求：无需高性能 GPU，仅靠 CPU 即可运行轻量化模型，降低硬件门槛。
How【安装与部署】
OpenClaw Portable 提供 “离线版” 和 “在线版” 两种版本，部署流程极简，核心为 “解压即运行”，具体步骤如下：
1. 版本选择
版本类型 | 大小 | 核心特点 | 适用场景 |
离线版 | ~1.2GB | 内置 Qwen2.5-1.5B 模型，全离线运行 | 无网络环境、追求零成本使用 |
在线版 | ~300MB | 无内置模型，对接云 API | 有稳定网络、需使用特定云 AI 服务 |
2. 下载地址
离线版：OpenClaw-Portable-v6.0.0-windows-offline.tar.gz（对应版本可从仓库发布页获取）；
在线版：OpenClaw-Portable-v6.0.0-windows-online.tar.gz。
3. 部署步骤（Windows 系统，核心流程）
步骤 1：解压包
将下载的压缩包解压至任意目录（推荐 USB 设备根目录，如 D:\OpenClaw-Portable\），解压后目录包含 bin/、config/、start.bat 等核心文件。
步骤 2：启动服务
双击解压目录下的 start.bat（或 start-offline.bat/start-online.bat，按需选择）；
脚本自动执行初始化，控制台显示进度反馈，等待 60s 左右完成服务启动；
启动完成后，自动打开浏览器并跳转至 AI 交互界面（Token 已自动提取，无需手动输入）。
步骤 3：停止 / 重启服务
停止：双击 stop.bat，脚本自动终止所有相关进程；
重启：双击 restart.bat，自动完成服务重启，无需重新解压；
清理：双击 cleanup.bat，清理运行过程中的临时文件，确保设备无残留。
4. Linux 系统部署（补充）
解压压缩包至目标目录；
赋予脚本执行权限：chmod +x start.sh stop.sh restart.sh；
启动：./start.sh（离线版 ./start-basic.sh，在线版 ./start-online.sh）；
停止：./stop.sh，清理：./cleanup.sh。
5. 离线包自定义构建（进阶）
若需自定义离线包（如替换内置模型），可执行：
# 克隆仓库 git clone https://github.com/SonicBotMan/openclaw-portable.git cd openclaw-portable # 构建离线包 ./build-offline-package.sh # 生成自定义离线包，位于当前目录下的 offline-package/ 文件夹 |
Whops【总结】
OpenClaw Portable 以 “便携、离线、零配置” 为核心，重构了 AI 助手的使用方式，解决了传统 AI 工具的安装复杂、依赖网络、设备绑定等核心痛点。其轻量化架构、跨平台脚本封装、本地模型内置等设计，使其既适配个人用户的隐私化、移动化需求，也满足企业标准化、低成本的 AI 部署诉求，是一款真正 “开箱即用” 的便携式 AI 助手解决方案。
* 官方代码仓库：https://github.com/SonicBotMan/openclaw-portable
