🦞 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 陪跑服务。淘宝 👉 虾盘 U 盘（作者出品）（口令 HU293）· 拼多多 👉 点此购买。📩 微信：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   # Mac / Linux
# Windows 用户：双击 setup.bat，或 PowerShell 中运行 setup.ps1

# 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	火山引擎

国际模型： 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, we recommend the commercial 2.0 edition — no setup needed.

🚀 Version 2.0 features on-device local models (offline, no API key needed), now available — includes AI onboarding support. Taobao 👉 U-Claw USB Drive (by author) (code HU293) · Pinduoduo 👉 Buy here. 📩 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. 下载依赖（Node.js + OpenClaw，约1分钟）
cd u-claw/portable && bash setup.sh   # Mac / Linux
# Windows：双击 setup.bat，或在 PowerShell 中运行 setup.ps1

# 3. 复制到 U 盘
cp -R portable/ /Volumes/YOUR_USB/U-Claw/   # Mac
# 或者在 Windows 上直接拖放

完成！ 插上 U 盘，双击启动脚本，即可运行 AI。

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-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位
└── data/                         ← 用户数据（不在 Git 中）
    ├── .openclaw/                   配置文件
    ├── memory/                      AI 记忆
    └── backups/                     备份

Linux 可引导 U 盘

没有操作系统？没关系。通过 U 盘将任意电脑引导至 Ubuntu + AI：

• 在本仓库中：bootable/ 目录（完全独立于其他模块）
• 独立仓库：u-claw-linux（内容相同，更便于单独克隆）

基于 Ventoy + Ubuntu 24.04 LTS + 持久化存储。Windows 上有 4 步 PowerShell 脚本。详情请参阅 bootable/README.md。

桌面应用（Electron）

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

支持的 AI 模型

中文模型（无需 VPN）：

模型	最适合
DeepSeek	编码，成本极低
Kimi K2.5	长文档，256K 上下文
Qwen	大量免费用量
GLM (智谱)	学术用途
MiniMax	语音及多模态
Doubao	字节跳动生态

国际模型： Claude · GPT · Gemini（在中国需使用 VPN 或代理）

支持的聊天平台

平台	状态	备注
QQ	✅ 已预装	输入 AppID + Secret
Feishu (Lark)	✅ 内置	企业首选
Telegram	✅ 内置	国际
WhatsApp	✅ 内置	Baileys 协议
Discord	✅ 内置	—
WeChat	✅ 社区插件	iPad 协议

中国镜像

所有脚本默认使用中国镜像——无需 VPN：

资源	镜像
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 脚本和文档方面。

🔧 专业服务 / 专业服务

需要帮助吗？我们提供远程支持和定制开发：

服务	描述	价格
远程安装	我们为您远程安装 OpenClaw + 技能 + 模型配置	免费
故障排除	启动失败、端口冲突、网络问题	从 ¥50 起
模型调优	API 密钥设置、模型切换、提示优化	从 ¥50 起
定制开发	自定义技能、企业私有部署、QQ/WeChat/Feishu 机器人集成	从 ¥200 起
U 盘精简版	预先构建的便携式 U 盘，包含您的自定义技能和模型	从 ¥100 起

一键远程支持——只需运行一条命令，我们就会连接并解决问题：

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

# Windows（管理员 PowerShell）
irm https://u-claw.org/remote.ps1 | iex

微信：hecare888（备注「U-Claw 远程」优先处理）

👉 查看完整服务详情 / 查看完整服务详情

🦞 寻求合作伙伴

U-Claw 是一个快速发展的开源项目，目前已有实际的商业机会摆在面前。但作为独自负责的产品经理，我无法单枪匹马抓住这些机会。

现寻找：

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

如果您对将 AI 工具推向市场充满热情，请联系我们：

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

常见问题

问：我需要 VPN 吗？ 不需要。所有下载都使用中国镜像。中文 AI 模型的 API 可直接使用。

问：U 盘需要多大容量？ 4GB 以上（总大小约 2.3GB）。

问：我可以重新分发吗？ MIT 许可证——可自由复制和分享。

问：Mac 提示“未验证开发者”？ 右键点击脚本→打开。

联系方式

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

---

---

日语

これは何？

U-Claw（虾盘 / シャーパン）は、OpenClaw（オープンソース AI アシスタントフレームワーク）を USB メモリに入れて持ち運べるようにするチュートリアル + ソースコード一式です。任意の PC に差し込み、ダブルクリックするだけで AI が使えます。

コードベースがそのまま USB のファイル構造になっています。setup.sh で大きな依存ファイルをダウンロードした後、portable/ ディレクトリを USB にコピーすれば完成です。

📖 完全チュートリアル — ゼロからの手動インストール、モデル設定、チャットプラットフォーム連携。

ワンラインインストール（推奨）

USB 不要。コマンド一行で PC に直接インストール：

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

# Windows（PowerShell を管理者として実行）
irm https://u-claw.org/install.ps1 | iex

自動で Node.js ダウンロード → OpenClaw インストール → スキル設定 → AI モデル設定 → 起動スクリプト生成まで完了します。中国ミラーを使用。

詳細は install/README.md を参照。

クイックスタート：ポータブル USB の作成

# 1. クローン
git clone https://github.com/dongsheng123132/u-claw.git

# 2. 依存ファイルをダウンロード（Node.js + OpenClaw、約1分）
cd u-claw/portable && bash setup.sh

# 3. 复制到 USB
cp -R portable/ /Volumes/YOUR_USB/U-Claw/   # Mac
# Windows 请使用资源管理器拖放

完成！ 插上 USB，双击启动脚本即可。

USB 功能一览

功能	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/                          ← 整个文件夹复制到 USB
├── 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位
└── data/                         ← 用户数据（不在 git 管理范围内）
    ├── .openclaw/                   配置文件
    ├── memory/                      AI 记忆
    └── backups/                     备份

Linux 可引导 USB

即使没有操作系统也没关系。你可以通过 USB 将任意 PC 引导至 Ubuntu + AI 环境：

• 本仓库内：bootable/ 目录（与其他模块完全独立）
• 独立仓库：u-claw-linux（内容相同，适合单独克隆）

支持 Ventoy + Ubuntu 24.04 LTS + 持久化存储。在 Windows 上只需执行 4 步的 PowerShell 脚本即可创建。详情请参阅 bootable/README.md。

桌面应用（Electron）

cd u-claw-app
bash setup.sh            # 一键搭建开发环境
npm run dev              # 开发模式运行
npm run build:mac-arm64  # 构建 → release/*.dmg
npm run build:win        # 构建 → release/*.exe

支持的 AI 模型

中国国产模型（无需 VPN）：

模型	推荐用途
DeepSeek	编程最佳，超低价
Kimi K2.5	长文档处理，256K 上下文
Qwen (通义千问)	免费额度较大
GLM (智谱)	学术用途
MiniMax	语音与多模态
Doubao (豆包)	火山引擎

国际模型： Claude、GPT、Gemini（从中国访问需使用 VPN 或代理）

支持的聊天平台

平台	状态	备注
QQ	✅ 预装	输入 AppID + Secret
飞书 (Lark)	✅ 内置	企业级
Telegram	✅ 内置	海外用户
WhatsApp	✅ 内置	Baileys 协议
Discord	✅ 内置	—
WeChat	✅ 社区插件	iPad 协议

开发与贡献

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（可引导 USB）	✅	bootable/ 目录

欢迎提交 PR！尤其是改进 Windows 脚本和文档翻译。

常见问题解答

Q: 需要 VPN 吗？ 不需要。安装和运行都使用国内镜像。国产模型的 API 可直接连接。

Q: USB 存储器需要多大容量？ 4GB 以上（完整约 2.3GB）。

Q: 可以重新分发吗？ 采用 MIT 许可证，您可以自由复制和分发。

**Q: 在 Mac 上显示“未确认的开发者”怎么办？ 请右键点击脚本 → 选择“打开”。

联系方式

• 微信：hecare888
• GitHub：@dongsheng123132
• 网站：u-claw.org

---

由 dongsheng 使用 🦞 制作

U-Claw（虾盘）快速上手指南

U-Claw 是一个开源项目，旨在将 OpenClaw AI 助手框架制作成“插上即用”的 U 盘应用。本指南将帮助你快速在本地部署或制作便携版 AI 助手。

1. 环境准备

系统要求

• macOS: 支持 Apple Silicon (M1-M4) 及 Intel (x64) 架构
• Windows: 支持 x64 架构（部分功能开发中）
• Linux: 支持 x64 架构（含可启动 U 盘方案）
• 存储空间: 建议 U 盘或磁盘剩余空间大于 4GB

前置依赖

本项目脚本会自动处理大部分依赖，但需确保：

• 网络连接: 脚本默认配置了国内镜像源，无需翻墙即可快速下载。
• 命令行工具:
  • Mac/Linux: 终端 (Terminal)
  • Windows: PowerShell (建议以管理员身份运行) 或 Git Bash
• Git: 用于克隆代码仓库

2. 安装步骤

你可以选择一键安装到本机（推荐新手），或制作便携版 U 盘。

方案 A：一键安装到本机（无需 U 盘）

直接运行以下命令，脚本将自动完成 Node.js 下载、OpenClaw 安装、技能配置及模型设置。

Mac / Linux:

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

Windows (PowerShell 管理员模式):

irm https://u-claw.org/install.ps1 | iex

方案 B：制作便携版 U 盘

若需制作可随身携带的 AI 助手，请按以下步骤操作：

1. 克隆代码仓库

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

2. 补齐核心依赖 进入 portable 目录并运行初始化脚本（自动使用国内镜像，耗时约 1 分钟）：

Mac / Linux:

cd u-claw/portable && bash setup.sh

Windows: 双击运行 setup.bat，或在 PowerShell 中执行：

cd u-claw/portable; .\setup.ps1

3. 拷贝至 U 盘 将生成的 portable 文件夹整体复制到 U 盘根目录，并重命名为 U-Claw（可选）。

Mac:

cp -R portable/ /Volumes/你的U盘名称/U-Claw/

Windows: 直接在资源管理器中将 portable 文件夹拖拽至 U 盘。

3. 基本使用

启动 AI 助手

插入 U 盘（或直接在本机安装目录下），根据操作系统双击对应的启动脚本：

操作系统	启动文件	功能菜单
macOS	Mac-Start.command	Mac-Menu.command
Windows	Windows-Start.bat	Windows-Menu.bat

注意: macOS 若提示“未验证的开发者”，请右键点击文件选择“打开”。

首次配置

启动后，浏览器会自动打开或请手动打开目录下的 Config.html 进行初始化设置：

1. 选择模型: 推荐使用国产模型（如 DeepSeek、Kimi、通义千问等），无需翻墙且速度快。
2. 填入密钥: 输入对应大模型平台的 API Key。
3. 接入平台: 可选择接入 QQ、飞书、Telegram 等聊天平台（QQ 已预装插件，填入 AppID 和 Secret 即可）。

验证运行

配置完成后，在支持的聊天软件中发送消息，或在启动后的本地界面中输入指令，即可体验 AI 对话、代码生成及文档分析等功能。