项目简介

VH-Claw 是基于 Electrobun 框架开发的 OpenClaw 便携式管理工具，旨在将 OpenClaw 的完整环境封装至 U 盘，实现 “即插即用” 的跨平台体验。用户无需安装 Node.js 或其他依赖，即可在任何电脑上运行 OpenClaw，并管理 AI 模型与技能[用户提供]。

作为 OpenClaw 生态的轻量化衍生项目，VH-Claw 解决了原版 OpenClaw 部署复杂、依赖环境繁琐的问题¹⁵，尤其适合国内用户、非技术背景开发者及需要频繁切换设备的使用场景。

核心特性

1. 🚀 零配置启动

   • 首次运行自动下载 Bun 运行时（替代 Node.js），无需手动配置环境。
   • 支持离线模式，依赖仅需下载一次，后续插拔 U 盘即可直接使用。

2. 💾 便携式设计

   • 所有数据（配置、日志、OpenClaw 本体）存储在单一目录，支持 U 盘或移动硬盘携带。
   • 目录结构清晰，跨平台共享配置（config/.openclaw/openclaw.json）。

3. 🔧 图形化管理界面

   • 提供可视化控制面板，支持一键配置模型（DeepSeek、智谱、通义千问等）和技能。
   • 内置 10+ 中文 AI 技能（如小红书文案生成、B站助手、天气预报等），开箱即用。

4. 📱 全平台兼容

   • 支持 Windows（.bat）、macOS（.app）、Linux（二进制），覆盖主流操作系统。

5. ⚡ 国内网络优化

   • 内置 GitHub 镜像源（cdn.gh-proxy.org）和 华为云 npm 源，解决依赖下载慢的问题。
   • 预置国内主流 AI 服务商 API 配置，降低接入门槛[用户提供]⁵。

技术架构与创新

1. 技术栈

• 底层框架：Electrobun（跨平台桌面应用） + Bun 运行时（替代 Node.js，启动更快）。
• 前端：Vue 3 + Vite，提供响应式管理界面。
• 核心依赖：OpenClaw 最新版，支持多 Agent 协作和技能调用[用户提供]⁶。

2. 与 OpenClaw 生态的差异化

快速开始指南

1. 下载与安装

1. 从 https://github.com/uxiaohan/vh-claw/releases 下载对应平台版本。
2. 解压至 U 盘根目录（推荐）。
3. 运行启动文件：
   • Windows：双击 Windows启动.bat
   • macOS：运行 VH-Claw-canary.app
   • Linux：执行 ./vh-claw

2. 初始化与配置

• 首次运行：点击「初始化环境」，自动下载依赖（约 30 秒）。
• 模型配置：
  • 进入「模型配置」页面，选择服务商（如 DeepSeek、Kimi）。
  • 填入 API Key，保存后返回控制台启动服务。

3. 使用内置技能

• 通过 Web 界面调用预置技能，例如：
  • 中国天气：查询实时天气预报。
  • 小红书作家：生成带货文案。
  • B站助手：管理视频稿件[用户提供]。

应用场景与优势

1. 移动办公：随身携带 U 盘，在任意电脑上快速调用 AI 助手处理文件、邮件或数据分析。
2. 教育演示：无需安装环境，教师可直接在教室电脑演示 OpenClaw 功能。
3. 隐私保护：所有数据本地存储，避免云端服务的数据泄露风险¹³。

开源与社区

• 项目地址：https://github.com/uxiaohan/vh-claw
• 许可证：MIT，支持二次开发与商业用途。
• 贡献指南：支持提交技能插件或优化国内网络适配。

结语

VH-Claw 填补了 OpenClaw 生态中 “便携式+开箱即用” 的空白，尤其适合国内用户和轻量化需求场景。随着 OpenClaw 衍生项目日益增多（如安全强化版 NanoClaw、嵌入式版 PicoClaw），VH-Claw 的 U 盘设计为技术普惠提供了新思路。

立即体验：下载项目并插入 U 盘，开启你的便携式 AI 助手之旅！

配图建议：

1. VH-Claw 控制面板截图（模型配置页）。
2. U 盘运行效果图（跨平台演示）。
3. OpenClaw 生态对比图（突出便携性）。