虾盘 — 全球首个 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），开箱即用，无需折腾。当然，AI 就像骑自行车，多折腾多用，上手了自然就会了。

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

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

💡 关于这个项目： 我是产品经理，1个月前借助 AI 协助，针对国内环境打造了 U-Claw 虾盘——全球首个 U 盘形态的 OpenClaw，让 AI 即插即用。目前在快速迭代（也有不少 bug），2.0 正在重构，目标是做成一个真正可用的端侧 AI 产品。

🚀 AI 正在爆发，这是一个很少见的窗口期。与其围观，不如一起下场。虾盘只是开始，我们想做下一个真正影响世界的产品——AI 新入口级别的机会，值得 OpenAI、Meta 关注的那种。

🤝 目前人手急缺，诚邀技术极客和产品极客加入。不需要完美，需要有想法、敢下场、愿意一起把事情做成的人。

📩 微信：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。

# 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-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/                     备份

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

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

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

除了 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

国产模型（无需翻墙）：

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

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

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

平台支持：

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

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

我们正在寻找：

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

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

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

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

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

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

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

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

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. That said, AI is like riding a bike — tinker with it and it'll click.

🚀 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. Interested? WeChat: hecare888

💡 About this project: I'm a product manager who built U-Claw with AI assistance — the world's first OpenClaw in USB form, purpose-built for China. Still iterating fast (yes, there are bugs). V2.0 is being rebuilt into a truly production-ready edge AI product.

🚀 AI is exploding. This is a rare window. Stop watching — come build with us. U-Claw is just the beginning. We're aiming for the next world-changing product — the kind of AI entry point that OpenAI or Meta would take notice of.

🤝 We're urgently looking for builders — tech hackers and product thinkers who have ideas, move fast, and want to make things happen.

📩 WeChat: hecare888

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.

# 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.

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

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.

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

Chinese models (no VPN needed):

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

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

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:

PRs welcome! Especially: Windows scripts, documentation.

Need help? We offer remote support and custom development:

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 / 查看完整服务详情

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

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.

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

Made with 🦞 by dongsheng