Home
avatar

.𝙃𝙖𝙣

🦞 VH-Claw：便携式 OpenClaw 管理工具，零配置开箱即用

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 盘跨平台使用。

🎯 技术架构

核心技术栈

技术版本用途
Electrobun1.16.0跨平台桌面应用框架
Bun1.3.11JavaScript 运行时
Vue 33.5.13前端框架
Vite6.0.3构建工具
OpenClawlatestAI 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 站助手 - 哔哩哔哩相关功能

🚀 快速开始

下载安装

  1. 从 Releases 下载对应平台的最新版本
  2. 解压到任意目录（推荐 U 盘根目录）
  3. 运行启动文件：
    • Windows: Windows启动.bat
    • macOS: VH-Claw-canary.app

首次使用

  1. 初始化环境

    • 启动 VH-Claw
    • 启动服务

  2. 配置模型

    • 切换到「模型配置」页面
    • 选择你的 AI 服务商（DeepSeek、智谱、通义千问等）
    • 填入 API Key 和模型名称
    • 点击「保存」

  3. 启动服务

    • 点击「打开 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智谱 AIOpenAI 兼容
Kimi月之暗面OpenAI 兼容
通义千问阿里云OpenAI 兼容
豆包字节跳动OpenAI 兼容
硅基流动SiliconFlowOpenAI 兼容
智谱 GLM智谱 AI内置 Provider
OpenAIOpenAIOpenAI 兼容
ClaudeAnthropicOpenAI 兼容
GroqGroqOpenAI 兼容
自定义任意 OpenAI 兼容接口自定义

配置文件位置

配置文件保存在 运行目录/config/.openclaw/openclaw.json，跨平台共享。

❓ 常见问题

Q: 支持哪些 OpenClaw 功能？

A: 支持所有 OpenClaw 核心功能，包括：

  • Agent 对话
  • 技能调用
  • 多渠道接入
  • Workspace 管理
OpenClaw VH-Claw 便携式龙虾