988字 4.9分钟
Code专为中国用户打造的 AI Agent 便携式解决方案 ，插上 U 盘就能用，双击即运行，无需配置，真正便携！
项目地址
VH-Claw - GitHub📸 截图展示
为什么需要 VH-Claw？
在中国使用 OpenClaw 是个噩梦，VH-Claw 解决所有问题
| 问题 | 传统方式 | VH-Claw 的答案 |
|---|---|---|
| 🚫 GitHub 连不上 | 源码下不了，npm 依赖装不上 | ✅ 全部打包好，插 U 盘，双击运行，搞定 |
| ⏳ npm install 超时 | 几百个依赖包，在国内网络下载到崩溃 | ⚡ 内置镜像源，下载速度飞快，再也不卡顿 |
| 📦 环境配置复杂 | Node.js、Bun、OpenClaw 一堆依赖 | 🎯 零配置启动，首次运行自动下载所需运行时 |
| 💻 换电脑重装 | 每次换电脑都要重新配置环境 | 💾 所有数据存储在 U 盘，更换电脑无需重新配置 |
🚀 核心特性
✨ 零配置启动
插入 U 盘即可使用，无需安装任何依赖，首次运行自动下载运行时。
💾 真正便携
所有数据存储在 U 盘，更换电脑无需重新配置，随身携带随时使用。
🔧 图形化管理
直观的用户界面，轻松配置模型、管理技能、查看日志。
🌏 中国优化
- 8 个国产 AI 模型 · DeepSeek、Kimi、通义千问、智谱、MiniMax、豆包、硅基流动、百度千帆
- 一键配置，开箱即用
- 内置 GitHub 镜像和国内 npm 源
📱 多平台支持
Windows / macOS 系统，同一 U 盘跨平台使用。
🎯 技术架构
核心技术栈
| 技术 | 版本 | 用途 |
|---|---|---|
| Electrobun | 1.16.0 | 跨平台桌面应用框架 |
| Bun | 1.3.11 | JavaScript 运行时 |
| Vue 3 | 3.5.13 | 前端框架 |
| Vite | 6.0.3 | 构建工具 |
| OpenClaw | latest | AI Agent 框架 |
架构优势
Electrobun - 相比 Electron：
- 📦 超小体积：14MB 压缩包（比 Electron 小 90%+）
- ⚡ 极速启动：<50ms 冷启动（Electron 需要 2-5s）
- 🔄 增量更新：14KB 补丁（Electron 需要 100MB+）
- 🎯 纯 TypeScript：主进程和 UI 都用 TypeScript
OpenClaw - 强大的 AI Agent 框架：
- 🧠 Agent 对话
- 🛠️ 技能调用
- 📡 多渠道接入
- 💾 Workspace 管理
📦 预置中文技能
项目内置以下中文 AI 技能：
- 🔍 中国搜索 - 中文搜索引擎
- 🌤️ 中国天气 - 天气预报
- 📝 知乎写作 - 知乎风格文案
- 🍠 小红书作家 - 小红书文案生成
- 🎵 抖音脚本 - 短视频脚本
- 📰 微信文章 - 公众号文章
- 🤖 DeepSeek 助手 - DeepSeek 专用技能
- 📺 B 站助手 - 哔哩哔哩相关功能
🚀 快速开始
下载安装
- 从 Releases 下载对应平台的最新版本
- 解压到任意目录（推荐 U 盘根目录）
- 运行启动文件：
- Windows:
Windows启动.bat - macOS:
VH-Claw-canary.app
- Windows:
首次使用
初始化环境
- 启动 VH-Claw
- 启动服务
配置模型
- 切换到「模型配置」页面
- 选择你的 AI 服务商（DeepSeek、智谱、通义千问等）
- 填入 API Key 和模型名称
- 点击「保存」
启动服务
- 点击「打开 Web 界面」开始使用
🛠️ 开发指南
环境要求
- Bun 1.3.11+
- Git
本地开发
# 克隆项目
git clone https://github.com/uxiaohan/vh-claw.git
cd vh-claw
# 安装依赖
bun install
# 开发模式（带热重载）
bun run dev:hmr
# 或普通开发模式
bun run dev构建
# 构建所有平台
bun run build:all
# 单独构建
bun run build:win # Windows
bun run build:mac # macOS📋 配置说明
支持的模型服务商
| 服务商 | 说明 | 配置类型 |
|---|---|---|
| DeepSeek | 深度求索 | OpenAI 兼容 |
| MiniMax | 智谱 AI | OpenAI 兼容 |
| Kimi | 月之暗面 | OpenAI 兼容 |
| 通义千问 | 阿里云 | OpenAI 兼容 |
| 豆包 | 字节跳动 | OpenAI 兼容 |
| 硅基流动 | SiliconFlow | OpenAI 兼容 |
| 智谱 GLM | 智谱 AI | 内置 Provider |
| OpenAI | OpenAI | OpenAI 兼容 |
| Claude | Anthropic | OpenAI 兼容 |
| Groq | Groq | OpenAI 兼容 |
| 自定义 | 任意 OpenAI 兼容接口 | 自定义 |
配置文件位置
配置文件保存在 运行目录/config/.openclaw/openclaw.json，跨平台共享。
❓ 常见问题
Q: 支持哪些 OpenClaw 功能？
A: 支持所有 OpenClaw 核心功能，包括：
- Agent 对话
- 技能调用
- 多渠道接入
- Workspace 管理