🦞 U-Claw 虾盘 - OpenClaw AI 助手离线安装 U 盘 | 提供远程维护·定制开发·企业私有化部署服务 | Remote support & custom AI development
# Add to your Claude Code skills
git clone https://github.com/dongsheng123132/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
U-Claw(虾盘)是一个制作教程 + 全套源代码,教你把 OpenClaw(开源 AI 助手框架)做成 U 盘——插上任意电脑,双击就能用 AI。为什么叫虾盘?U-Claw = USB + Claw(虾钳),U 盘 + AI = 虾盘。
代码库本身就是 U 盘的文件骨架,运行 setup.sh 补齐大依赖后,整个 portable/ 目录直接拷贝到 U 盘即可。
📖 完整教程 — 从零开始的手工安装指南、模型配置、聊天平台接入,小白也能看懂。
不需要 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 个中国技能 → 模型配置 → 启动脚本生成。全程国内镜像,无需翻墙。
# 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 盘,双击启动脚本就能用。
No comments yet. Be the first to share your thoughts!
| 功能 | 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-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/ 目录(与其他模块完全独立,互不影响)基于 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
国产模型(无需翻墙):
| 模型 | 推荐场景 | |------|----------| | DeepSeek | 编程首选,极便宜 | | Kimi K2.5 | 长文档,256K 上下文 | | 通义千问 Qwen | 免费额度大 | | 智谱 GLM | 学术场景 | | MiniMax | 语音多模态 | | 豆包 Doubao | 火山引擎 |
国际模型: 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 是一个快速成长的开源项目,目前已有不少商业合作机会。
我们正在寻找:
如果你对 AI 工具的落地和商业化感兴趣,欢迎联系:
Q: 需要翻墙吗? 不需要。安装和运行全程使用国内镜像,国产模型 API 直连。
Q: U 盘需要多大? 4GB+(完整约 2.3GB)。
Q: 能分发吗? MIT 协议,随便复制分发。
Q: Mac 提示"未验证的开发者"? 右键脚本 → 打开。
Q: setup.bat / setup.sh 执行失败,提示模块找不到?
通常是 npm install 过程中网络中断导致 node_modules 不完整。解决步骤:
rmdir /s /q portable\app\core\node_modules(Windows)或 rm -rf portable/app/core/node_modules(Mac)cd portable/app/core && npm install --registry=https://registry.npmmirror.comQ: 系统已有 Node.js v24,安装失败? Node.js v24 是最新开发版,部分依赖尚不兼容。需要 v20 或 v22 LTS。删除已下载的 runtime 目录后重新运行 setup,它会自动下载内置的 Node v22:
# Windows
rmdir /s /q portable\app\runtime\node-win-x64
setup.bat
# Mac
rm -rf portable/app/runtime/node-mac-arm64
bash setup.sh
Q: Mac 上提示 .toSorted is not a function?
系统旧版 Node.js 被检测到并跳过了内置版本下载,但旧版 Node 不支持 .toSorted()(需要 v20+)。删除 runtime 目录让脚本重新下载内置 Node v22:
rm -rf portable/app/runtime/node-mac-arm64
bash setup.sh
Q: 如何同时配置多个 AI 模型并切换?
支持同时配置多个 provider!打开 Config.html → 在 Providers 区域点击「添加」,逐个填入各模型的 API Key 和地址(如 DeepSeek、Kimi、通义等)→ 保存后,在聊天界面左上角下拉菜单随时切换。配置持久保存在 U 盘上。
Q: U 盘安装后无法创建文件 / 写入失败? 两种可能:① U 盘侧面有物理写保护开关,拨到解锁位置;② U 盘格式不兼容,建议格式化为 exFAT(Mac/Windows/Linux 三端均支持读写)。
Q: 从 Ubuntu 向 U 盘复制时符号链接丢失?
node_modules/.bin/ 下有大量符号链接,FAT32/exFAT 在直接 cp -R 时会跳过。用 rsync -aL 可将符号链接展开为真实文件:
rsync -aL --progress portable/ /media/YOUR_USB/U-Claw/
Q: QQbot 报错 Unknown channel: qqbot?
Bundle 里的 @sliverp/qqbot 是未编译的 TypeScript 源码,需要先编译:
cd portable/app/core/node_modules/@sliverp/qqbot
npm install && npm run build
正式 Release 包已修复此问题,建议从 Releases 下载最新版。
🤝 招募代理 / 带货合作
虾盘 3.0 体验极佳,退货率极低,售后由我们负责——你只管卖货:
有意向请微信联系(备注「代理合作」优先处理)。
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.
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.
| 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 |
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:
bootable/ directory (fully independent from other modules)Based on Ventoy + Ubuntu 24.04 LTS + pers