🦞 U-Claw（虾盘）

虾盘 — 全球首个 U 盘里运行的 AI 助手 | The world's first AI assistant that runs from a USB drive 制作「插上就能用」的 AI 助手 U 盘 — 教程与源代码 Build a plug-and-play AI assistant USB drive — Tutorial & Source Code

中文 | English | 📖 完整教程

---

中文

这是什么

U-Claw（虾盘）是一个制作教程 + 全套源代码，教你把 OpenClaw（开源 AI 助手框架）做成 U 盘——插上任意电脑，双击就能用 AI。为什么叫虾盘？U-Claw = USB + Claw（虾钳），U 盘 + AI = 虾盘。

代码库本身就是 U 盘的文件骨架，运行 setup.sh 补齐大依赖后，整个 portable/ 目录直接拷贝到 U 盘即可。

📖 完整教程 — 从零开始的手工安装指南、模型配置、聊天平台接入，小白也能看懂。

---

⚠️ 新手提示： 本仓库为开源 1.0 版本，构建需要一定的技术基础（Node.js / 命令行 / 脚本）和编程工具，不建议零基础用户贸然下载自行折腾。想省事的话，推荐直接购买商业版（2.0），开箱即用，无需折腾。

🚀 2.0 商业版 是全面升级版，包含 U 盘内运行的本地模型（离线可用，无需联网 API），更多端侧 AI 能力持续迭代。我们也在搭建端侧 AI 落地社区，致力于成为便携式端侧 AI 的中国领跑者。

🔧 我们同时在推进端侧 AI 硬件开发，目标是打造真正属于个人的便携式 AI 助理。这个方向还很早期，但商业机会已经在路上——欢迎技术极客加入，一起把端侧 AI 和个人助理 AI 做出来。有想法、有技术、想一起把握机会的，欢迎联系：微信 hecare888

---

一键安装（推荐）

不需要 U 盘，一行命令直接装到电脑：

# Mac / Linux
curl -fsSL https://u-claw.org/install.sh | bash

# Windows (PowerShell 管理员)
irm https://u-claw.org/install.ps1 | iex

自动完成: Node.js 下载 → OpenClaw 安装 → 10 个中国技能 → 模型配置 → 启动脚本生成。全程国内镜像，无需翻墙。

详见 install/README.md。

快速开始：制作便携版 U 盘

# 1. 克隆代码
git clone https://github.com/dongsheng123132/u-claw.git

# 2. 补齐大依赖（Node.js + OpenClaw，国内镜像，约 1 分钟）
cd u-claw/portable && bash setup.sh

# 3. 拷贝到 U 盘
cp -R portable/ /Volumes/你的U盘/U-Claw/   # Mac
# 或 Windows 资源管理器直接拖过去

完成！ 插上 U 盘，双击启动脚本就能用。

U 盘功能一览

功能	Mac	Windows
免安装运行	Mac-Start.command	Windows-Start.bat
功能菜单	Mac-Menu.command	Windows-Menu.bat
安装到电脑	Mac-Install.command	Windows-Install.bat
首次配置	Config.html	Config.html

U 盘文件结构

U-Claw/                          ← 整个拷到 U 盘
├── Mac-Start.command             Mac 免安装运行
├── Mac-Menu.command              Mac 功能菜单
├── Mac-Install.command           安装到 Mac
├── Windows-Start.bat             Windows 免安装运行
├── Windows-Menu.bat              Windows 功能菜单
├── Windows-Install.bat           安装到 Windows
├── Config.html                   首次配置页面
├── setup.sh                      补齐依赖（开发者用）
├── app/                          ← 大依赖（setup.sh 下载，不进 git）
│   ├── core/                        OpenClaw + QQ 插件
│   └── runtime/
│       ├── node-mac-arm64/          Mac Apple Silicon
│       ├── node-mac-x64/           Mac Intel
│       └── node-win-x64/           Windows 64-bit
└── data/                         ← 用户数据（不进 git）
    ├── .openclaw/                   配置文件
    ├── memory/                      AI 记忆
    └── backups/                     备份

Linux 可启动版

连操作系统都没有？没关系。可启动版可以让任意电脑从 U 盘直接启动 Ubuntu + AI：

• 本仓库内：bootable/ 目录（与其他模块完全独立，互不影响）
• 独立仓库：u-claw-linux（内容一致，方便单独克隆）

基于 Ventoy + Ubuntu 24.04 LTS + 持久化存储，在 Windows 上运行 4 步 PowerShell 脚本即可制作。详见 bootable/README.md。

桌面安装版（Electron App）

除了 U 盘便携版，还有桌面 App 版本：

cd u-claw-app
bash setup.sh            # 一键安装开发环境（国内镜像）
npm run dev              # 开发模式运行
npm run build:mac-arm64  # 打包 → release/*.dmg
npm run build:win        # 打包 → release/*.exe

支持的 AI 模型

国产模型（无需翻墙）：

模型	推荐场景
DeepSeek	编程首选，极便宜
Kimi K2.5	长文档，256K 上下文
通义千问 Qwen	免费额度大
智谱 GLM	学术场景
MiniMax	语音多模态
豆包 Doubao	火山引擎

大模型聚合平台

SophNet，提供DS，GLM，Qwen，MiniMax，Kimi等多家开源大模型，多达50多种，一个API Key可以体验多个顶级大模型。

可以通过https://www.sophnet.com/#?code=4T6VKY注册了解。

LLM(最新版本)

国内/国外	模型厂商	模型	模型id（对外）	规格
国内	深度求索	DeepSeek V3.2 Fast	DeepSeek-V3.2-Fast	SophNet独家供给，DeepSeek满血版 TPS 峰值100以上
国内	深度求索	DeepSeek V3.2 Exp	DeepSeek-V3.2-Exp	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	深度求索	DeepSeek V3.2	DeepSeek-V3.2	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	深度求索	DeepSeek R1	DeepSeek-R1	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	深度求索	DeepSeek-R1-Distill-Qwen-7B	DeepSeek-R1-Distill-Qwen-7B	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	深度求索	DeepSeek-R1-Distill-Qwen-32B	DeepSeek-R1-Distill-Qwen-32B	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	QwQ-32B	QwQ-32B	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen3.5-397B-A17B	Qwen3.5-397B-A17B	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	月之暗面	Kimi-K2.5	Kimi-K2.5-global	开绿网版本
国内	月之暗面	Kimi-k2.5	Kimi-K2.5	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	智谱	GLM-5	GLM-5	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	MiniMax	MiniMax-M2.5	MiniMax-M2.5	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	字节跳动	Seed-OSS-36B-Instruct	Seed-OSS-36B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	小米	MiMo-V2-Flash	MiMo-V2-Flash	SophNet算力供给，性能对标火山阿里，超高并发支持
海外	openai	GPT-OSS-120B	GPT-OSS-120B	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	美团	LongCat-Flash-Chat	LongCat-Flash-Chat	SophNet算力供给，性能对标火山阿里，超高并发支持

视觉模型(最新版本)

国内/国外	模型厂商	模型	模型id（对外）	规格
国内	阿里	Qwen3-VL-235B-A22B-Instruct	Qwen3-VL-235B-A22B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen2.5-VL-7B-Instruct	Qwen2.5-VL-7B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen2.5-VL-72B-Instruct	Qwen2.5-VL-72B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen2.5-VL-32B-Instruct	Qwen2.5-VL-32B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen2-VL-7B-Instruct	Qwen2-VL-7B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen2-VL-72B-Instruct	Qwen2-VL-72B-Instruct	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	qwen-image-edit	Qwen-Image-Edit-2509	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Qwen-Image	Qwen-Image	SophNet算力供给，性能对标火山阿里，超高并发支持
国内	阿里	Z-Image-Turbo	Z-Image-Turbo	SophNet算力供给，性能对标火山阿里，超高并发支持

更多开闭源模型，请Contact: WeChat: hecare888

国际模型： Claude · GPT · Gemini（需翻墙或中转）

支持的聊天平台

平台	状态	说明
QQ	✅ 已预装	输入 AppID + Secret 即可
飞书	✅ 内置	企业首选
Telegram	✅ 内置	海外推荐
WhatsApp	✅ 内置	Baileys 协议
Discord	✅ 内置	—
微信	✅ 社区插件	iPad 协议

国内镜像

所有脚本默认走国内镜像，无需翻墙：

资源	镜像
npm 包	registry.npmmirror.com
Node.js	npmmirror.com/mirrors/node
Electron	npmmirror.com/mirrors/electron

开发 & 贡献

git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw/portable && bash setup.sh
bash Mac-Start.command   # Mac 测试

平台支持：

平台	状态	说明
Mac Apple Silicon (M1-M4)	✅	便携版 + 桌面版
Mac Intel (x64)	✅	便携版 + 桌面版
Windows x64	🚧 开发中	便携版 + 桌面版
Linux x64（可启动 U 盘）	✅	bootable/ 目录

欢迎 PR！特别需要：Windows 脚本完善、教程翻译。

🦞 寻找技术伙伴

U-Claw 是一个快速成长的开源项目，目前已有不少商业合作机会。

我们正在寻找：

• 技术伙伴 — 全栈 / Node.js / Electron / 脚本自动化
• 资源合作 — 渠道、内容、社区运营

如果你对 AI 工具的落地和商业化感兴趣，欢迎联系：

• 微信: hecare888
• GitHub: @dongsheng123132
• 官网: u-claw.org

FAQ

Q: 需要翻墙吗？ 不需要。安装和运行全程使用国内镜像，国产模型 API 直连。

Q: U 盘需要多大？ 4GB+（完整约 2.3GB）。

Q: 能分发吗？ MIT 协议，随便复制分发。

Q: Mac 提示"未验证的开发者"？ 右键脚本 → 打开。

联系

• 微信: hecare888
• GitHub: @dongsheng123132
• 官网: u-claw.org

---

English

What is this

U-Claw (aka "虾盘" / "Xia Pan" in Chinese, meaning "Claw Drive") is a tutorial + complete source code for building an OpenClaw (open-source AI assistant framework) USB drive — plug it into any computer, double-click, and start using AI.

The codebase itself is the USB file skeleton. Run setup.sh to download large dependencies, then copy the entire portable/ directory to a USB drive.

📖 Full Tutorial — Step-by-step manual installation, model setup, chat platform integration.

---

⚠️ Heads up for beginners: This repo is the open-source 1.0 version. Building it requires technical knowledge (Node.js / CLI / scripting). If you just want something that works out of the box, we recommend purchasing the commercial 2.0 edition instead — no setup hassle.

🚀 Version 2.0 (commercial) is a major upgrade featuring on-device local models that run entirely inside the USB drive — no internet or API key required. We're building an edge AI community in China, aiming to be the leading platform for portable edge AI.

🔧 We're also working on edge AI hardware — building a truly personal, portable AI assistant device. It's early days, but real commercial opportunities are emerging. We're looking for tech enthusiasts and hackers to join us in making edge AI and personal AI assistants a reality. Interested? WeChat: hecare888

---

One-Line Install (Recommended)

No USB needed — install directly to your computer:

# Mac / Linux
curl -fsSL https://u-claw.org/install.sh | bash

# Windows (PowerShell as Admin)
irm https://u-claw.org/install.ps1 | iex

Automatically downloads Node.js, installs OpenClaw, configures 10 Chinese-optimized skills, and sets up your AI model. All downloads use China mirrors.

See install/README.md for details.

Quick Start: Build a Portable USB

# 1. Clone
git clone https://github.com/dongsheng123132/u-claw.git

# 2. Download dependencies (Node.js + OpenClaw, ~1 min)
cd u-claw/portable && bash setup.sh

# 3. Copy to USB drive
cp -R portable/ /Volumes/YOUR_USB/U-Claw/   # Mac
# Or drag & drop on Windows

Done! Plug in the USB, double-click the start script, and you're running AI.

USB Features

Feature	Mac	Windows
Run (no install)	Mac-Start.command	Windows-Start.bat
Menu	Mac-Menu.command	Windows-Menu.bat
Install to PC	Mac-Install.command	Windows-Install.bat
First-time config	Config.html	Config.html

File Structure

U-Claw/                          ← Copy entire folder to USB
├── Mac-Start.command             Mac launcher
├── Mac-Menu.command              Mac menu
├── Mac-Install.command           Install to Mac
├── Windows-Start.bat             Windows launcher
├── Windows-Menu.bat              Windows menu
├── Windows-Install.bat           Install to Windows
├── Config.html                   First-time config page
├── setup.sh                      Download dependencies (dev use)
├── app/                          ← Large deps (downloaded by setup.sh, not in git)
│   ├── core/                        OpenClaw + QQ plugin
│   └── runtime/
│       ├── node-mac-arm64/          Mac Apple Silicon
│       ├── node-mac-x64/           Mac Intel
│       └── node-win-x64/           Windows 64-bit
└── data/                         ← User data (not in git)
    ├── .openclaw/                   Config file
    ├── memory/                      AI memory
    └── backups/                     Backups

Linux Bootable USB

No operating system? No problem. Boot any computer from USB into Ubuntu + AI:

• In this repo: bootable/ directory (fully independent from other modules)
• Standalone repo: u-claw-linux (same content, easier to clone separately)

Based on Ventoy + Ubuntu 24.04 LTS + persistence. 4-step PowerShell scripts on Windows. See bootable/README.md for details.

Desktop App (Electron)

cd u-claw-app
bash setup.sh            # One-click dev setup (China mirrors)
npm run dev              # Dev mode
npm run build:mac-arm64  # Build → release/*.dmg
npm run build:win        # Build → release/*.exe

Supported AI Models

Chinese models (no VPN needed):

Model	Best for
DeepSeek	Coding, extremely cheap
Kimi K2.5	Long documents, 256K context
Qwen	Large free tier
GLM (Zhipu)	Academic use
MiniMax	Voice & multimodal
Doubao	Volcengine ecosystem

International models: Claude · GPT · Gemini (VPN or relay required in China)

Supported Chat Platforms

Platform	Status	Notes
QQ	✅ Pre-installed	Enter AppID + Secret
Feishu (Lark)	✅ Built-in	Enterprise favorite
Telegram	✅ Built-in	International
WhatsApp	✅ Built-in	Baileys protocol
Discord	✅ Built-in	—
WeChat	✅ Community plugin	iPad protocol

China Mirrors

All scripts use China mirrors by default — no VPN needed:

Resource	Mirror
npm packages	registry.npmmirror.com
Node.js	npmmirror.com/mirrors/node
Electron	npmmirror.com/mirrors/electron

Development & Contributing

git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw/portable && bash setup.sh
bash Mac-Start.command   # Test on Mac

Platform Support:

Platform	Status	Notes
Mac Apple Silicon (M1-M4)	✅	Portable + Desktop
Mac Intel (x64)	✅	Portable + Desktop
Windows x64	🚧 In progress	Portable + Desktop
Linux x64 (Bootable USB)	✅	bootable/ directory

PRs welcome! Especially: Windows scripts, documentation.

🔧 Professional Services / 专业服务

Need help? We offer remote support and custom development:

Service	Description	Price
Remote Installation	We remotely install OpenClaw + skills + model config for you	Free
Troubleshooting	Startup failures, port conflicts, network issues	From ¥50
Model Tuning	API key setup, model switching, prompt optimization	From ¥50
Custom Development	Custom skills, enterprise private deployment, QQ/WeChat/Feishu bot integration	From ¥200
USB Green Edition	Pre-built portable USB with your custom skills & models	From ¥100

One-click remote support — run one command, we connect and fix it:

# Mac / Linux
curl -fsSL https://u-claw.org/remote.sh | bash

# Windows (Admin PowerShell)
irm https://u-claw.org/remote.ps1 | iex

WeChat: hecare888 (备注「U-Claw 远程」优先处理)

👉 View full service details / 查看完整服务详情

🦞 Looking for Partners

U-Claw is a fast-growing open-source project with real commercial opportunities.

We're looking for:

• Technical partners — Full-stack / Node.js / Electron / scripting
• Resource partners — Distribution, content, community

If you're interested in AI tooling and commercialization, let's talk:

• WeChat: hecare888
• GitHub: @dongsheng123132
• Website: u-claw.org

FAQ

Q: Do I need a VPN? No. All downloads use China mirrors. Chinese AI model APIs work directly.

Q: How big should the USB drive be? 4GB+ (~2.3GB full).

Q: Can I redistribute? MIT license — copy and share freely.

Q: Mac says "unverified developer"? Right-click the script → Open.

Contact

• WeChat: hecare888
• GitHub: @dongsheng123132
• Website: u-claw.org

---

Made with 🦞 by dongsheng