U-Claw（虾盘）

把 AI 工作空间装进 U 盘：插上任意电脑，配置、记忆和工具都跟着走。

下载便携版 · 完整教程 · 从源码制作 · 企业服务 · English

[!IMPORTANT] 这不是 U 盘制作工具。这个仓库就是 U 盘的文件骨架：运行一次 setup.sh 补齐运行时，再把整个 portable/ 拷到盘里即可。

三步开始

仅 Windows 使用时推荐 NTFS。 v2.3.0 加入 Windows exFAT 兼容：自动选择文件系统适配，配置与会话仍留在 U 盘。FAT32 不支持。Mac/Windows 共盘尚待 Mac 实机验收，不能把 Windows 原生运行时直接当作 Mac 运行时。格式化会清空盘内文件，操作前请备份。

📺 图文教程：docs/快速上手.md（含真实界面截图，5 步从插 U 盘到开始对话）

1. 从 Releases 下载 Windows 便携版，解压到 U 盘后双击 Windows-Start.bat。
2. 或克隆仓库，在 portable/ 运行 bash setup.sh，下载 Node.js 与 OpenClaw。
3. 首次启动在本地配置模型 Key；配置只保存在 U 盘的 data/.openclaw/openclaw.json。

平台支持：Windows ✅（免部署完整包）· macOS ✅ —— 详见下方平台支持表。

[!TIP]

👑 同作者新品：U-King · AI 装机管家

一键装好 Claude Code / Codex / OpenClaw / Hermes 四大 AI 神器，驱动自动配好——一个 Key 直用 Claude、GPT、DeepSeek、Kimi 等 24+ 全球模型，免翻墙。绿色版仅几 MB，双击即用，还带 AI 作图 / 视频 / 本地大模型 / 多终端工作台。

免费下载：www.u-king.org（国内镜像 cloud.u-claw.org/uking）

U-Claw 让 AI 住进 U 盘；U-King 帮你把全套 AI 编程神器装进电脑。 EN: U-King — one-click installer for Claude Code / Codex / OpenClaw, with one API key for 24+ global models → u-king.org

---

中文

这是什么

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

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

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

🧩 模型随便选：国内外大模型都能用

U-Claw 是纯开源工具，不绑定设备、不打指纹、不上传任何数据。首次启动会自动打开「配置中心」，选一个模型、填入自己的 API Key（或一键领取虾盘云额度 / 充值）即可开始使用：

• 虾盘云（首选 · 中转站）：一个 Key 调用 DeepSeek / Claude / GPT / 通义 等国内外全部大模型，无需翻墙。注册并充值：u-claw.org/cloud.html
• 各家官方 Key 也行：DeepSeek、通义千问、Kimi、智谱 GLM、豆包、MiniMax（国内）/ OpenAI、Claude、Groq（国外）/ 硅基流动、任意 OpenAI 兼容地址（自定义）
• 配置只存在本地 data/.openclaw/openclaw.json，拔盘不留痕

一键安装（推荐）

不需要 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 盘同时只会启动一个 U-Claw 实例。重复双击会打开已运行的 Dashboard，不会另起端口或并发写入会话；如需重启，请先退出原启动窗口。

U 盘功能一览

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
├── 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 可启动版

Linux 可启动 U 盘套件已移出本仓库，在独立仓库 u-claw-linux 中维护。

关于桌面安装版（Electron）：Electron 桌面版（.exe 安装版 / 绿色版 / .dmg）已于 2026-06-19 停止发布，并已从仓库移除（见 tag archive/pre-scope-razor-2026-10-05）。U-Claw 现在只发布「便携 U 盘版」——这才是产品的本质：插上 U 盘、解压即用。

直接下载发行版

GitHub Releases 提供便携 U 盘版：

• u-claw-portable-windows-vX.Y.Z.zip — Windows 便携完整版（已预装 Node + OpenClaw，解压到 U 盘双击 Windows-Start.bat 即用）
• Mac：源码在 portable/ 目录，bash setup.sh 自动下载 Node + OpenClaw（国内镜像约 1 分钟），双击 Mac-Start.command 启动

仅 Windows 使用时推荐 NTFS。 v2.3.0 加入 Windows exFAT 兼容：自动选择文件系统适配，配置与会话仍留在 U 盘。FAT32 不支持。Mac/Windows 共盘尚待 Mac 实机验收，不能把 Windows 原生运行时直接当作 Mac 运行时。格式化会清空盘内文件，操作前请备份。

浏览器网站登录状态不会自动随盘迁移，换电脑后需要重新登录。部分界面缓存和运行时依赖仍会读写 U 盘。Windows NTFS 与 exFAT 的隔离测试已完成真实对话和重启读回；exFAT 的目录监听会降级为轮询，部分插件技能链接不能创建，启动可能更慢。发布成品仍须单独验收，这不代表所有电脑或 Mac 共盘已通过。

支持的 AI 模型

国产模型（无需翻墙）：

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

支持的聊天平台

QQ、飞书、Telegram、WhatsApp、Discord 等聊天平台由 OpenClaw 自带的命令接入，配置中心不提供聊天平台入口。双击 OpenClaw-CLI.bat（Windows）/ Mac-OpenClaw-CLI.command（Mac）打开命令行，然后运行 openclaw channels add（添加）、openclaw channels login（登录 / 扫码）、openclaw channels status（查看状态）、openclaw channels remove（移除）。已有的 channels 配置在配置中心保存模型时会被保留。QQ 插件已随包预装；微信插件暂不可用（上游兼容问题，修复后随更新恢复）。

国内镜像

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

开发 & 贡献

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

平台支持：

欢迎 PR！特别需要：教程翻译、文档完善。

🦞 寻找技术伙伴

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

我们正在寻找：

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

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

• 微信: hecare888
• Telegram: @dsds8848
• Twitter/X: @Bitplus888
• Email: [email protected]
• GitHub: @dongsheng123132
• 官网: u-claw.org

FAQ

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

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

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

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

Q: setup.bat / setup.sh 执行失败，提示模块找不到？ 通常是 npm install 过程中网络中断导致 node_modules 不完整。解决步骤：

1. 删除不完整的依赖：rmdir /s /q portable\app\core\node_modules（Windows）或 rm -rf portable/app/core/node_modules（Mac）
2. 切换淘宝镜像重新安装：cd portable/app/core && npm install --registry=https://registry.npmmirror.com

Q: 电脑已有其他版本的 Node.js，应该用哪个？ 本版内置并验证的是 Node.js 24.16.0 + OpenClaw 2026.10.2。优先使用发行包自带的启动脚本和 Node，不需要更换电脑上的 Node。若运行时缺失，重新解压完整发行包，或从源码运行 setup.bat / setup.sh；不要单独升级 OpenClaw 后继续沿用旧运行时。

Q: Mac 上提示 .toSorted is not a function？ 系统旧版 Node.js 被检测到并跳过了内置版本下载，但旧版 Node 不支持 .toSorted()（需要 v20+）。删除 runtime 目录让脚本重新下载内置 Node v24：

rm -rf portable/app/runtime/node-mac-arm64
bash setup.sh

Q: 如何同时配置多个 AI 模型并切换？ 启动 Windows-Start.bat / Mac-Start.command 后使用配置中心（首次启动自动打开，之后可从启动页进入）。它一次只配置一个模型服务（保存后作为主模型），再次保存会替换原有的模型配置。需要同时保留多个 provider（如 DeepSeek、Kimi、通义等）时，请用 OpenClaw 自带的 openclaw configure（双击 OpenClaw-CLI.bat / Mac-OpenClaw-CLI.command 打开命令行）或直接编辑 data/.openclaw/openclaw.json，之后在聊天界面左上角下拉菜单切换；此后不要再在配置中心保存模型，否则会覆盖 models。配置持久保存在 U 盘上。

Q: U 盘安装后无法创建文件 / 写入失败？ 先检查写保护、剩余空间和目录权限。仅在 Windows 使用时推荐 NTFS；exFAT 需要使用带有兼容补丁的完整新版，不能只替换旧版启动脚本。不要把所有写入失败都归因于格式，先运行诊断工具并保存错误信息；需要格式化时请先备份数据。

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 下载最新版。

💼 企业 AI 落地服务（付费）

U-Claw 免费开源，自己装了用完全够，不用买任何东西。

但如果你要把 AI 落进公司的业务流程——客服、文档、质检、报价、内部知识库—— 那是另一件事。我是 贺去病，独立 AI 产品开发者，做过 50+ 个交付项目， 方案到上线一个人能兜住。这部分按项目收费：

从免费诊断开始，不合适我会直接说不合适 —— 微信 hecare888 · [email protected] · hequbing.com

---

联系 & 合作

• 微信: hecare888（或扫右侧二维码）
• Telegram: @dsds8848
• Twitter/X: @Bitplus888
• Email: [email protected]
• GitHub: @dongsheng123132
• 官网: u-claw.org

🤝 招募代理 / 带货合作

虾盘 3.0 体验极佳，退货率极低，售后由我们负责——你只管卖货：

• 抖店 / 直播带货：提供最高佣金比例，产品已在多个直播间验证转化
• 代理分销：买断或按单分润均可谈，支持定制版本
• 技术合作：有开发能力者欢迎深度合作
• 👑 U-King 装机管家分销（新）：U-King 软件本身免费送客户，客户按用量给 AI 模型 API 充值，你拿持续分润——不压货、零售后（我们负责），赚的是长期流水。适合装机店、AI 培训、社群主理人

有意向请微信联系（备注「代理合作」优先处理）。

---

English

Download · Full tutorial · Enterprise services

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.

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

Windows-only USB use: NTFS is recommended. v2.3.0 adds Windows exFAT compatibility while keeping configuration and sessions on the drive. FAT32 is unsupported. Shared-drive operation on macOS still needs real-device acceptance; Windows native dependencies are not a Mac runtime. Formatting erases the drive; back up your files first.

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

Only one U-Claw instance runs per USB drive. A second click reopens the existing Dashboard instead of selecting another port or writing sessions concurrently. To restart, exit the original launcher first.

USB Features

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
├── 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

The Linux bootable USB kit has moved out of this repo and is maintained in the standalone u-claw-linux repo.

About the Electron desktop app: the Electron desktop app (the .exe installer / portable / .dmg builds) was deprecated and is no longer published as of 2026-06-19, and has been removed from the repo (see tag archive/pre-scope-razor-2026-10-05). U-Claw now ships only the portable USB build, which is the product's essence: plug in the USB and run.

Supported AI Models

Chinese models (no VPN needed):

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

Supported Chat Platforms

Chat platforms (QQ, Feishu/Lark, Telegram, WhatsApp, Discord, etc.) are connected with OpenClaw's own commands; the Config Center has no chat-platform entry. Double-click OpenClaw-CLI.bat (Windows) / Mac-OpenClaw-CLI.command (Mac) to open a shell, then run openclaw channels add (add), openclaw channels login (log in / scan QR), openclaw channels status (check status) or openclaw channels remove (remove). Existing channels entries are preserved when you save a model in the Config Center. The QQ plugin is pre-installed; the WeChat plugin is currently unavailable (upstream compatibility issue, it will return once fixed upstream).

China Mirrors

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

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:

PRs welcome! Especially: documentation, tutorials.

🔧 Professional Services / 专业服务

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

🦞 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:

• Telegram: @dsds8848
• Twitter/X: @Bitplus888
• Email: [email protected]
• GitHub: @dongsheng123132
• WeChat: hecare888
• 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.

Q: setup.bat / setup.sh fails with "module not found"? Usually caused by a network interruption during npm install, leaving node_modules incomplete. Fix:

1. Delete incomplete dependencies: rmdir /s /q portable\app\core\node_modules (Windows) or rm -rf portable/app/core/node_modules (Mac)
2. Reinstall using China mirror: cd portable/app/core && npm install --registry=https://registry.npmmirror.com

Q: Which Node.js version should I use? This release bundles and validates Node.js 24.16.0 with OpenClaw 2026.10.2. Use the bundled launcher and runtime; you do not need to replace your system Node. If runtime files are missing, extract a fresh full release or run setup.bat / setup.sh from source. Do not upgrade OpenClaw independently of its runtime requirements.

Q: Mac shows .toSorted is not a function? Your system Node.js was detected and the bundled version was skipped, but the system version is too old (needs v20+). Delete the runtime folder to re-download the bundled Node v24:

rm -rf portable/app/runtime/node-mac-arm64
bash setup.sh

Q: How do I use multiple AI models / providers? Launch Windows-Start.bat / Mac-Start.command and use the Config Center (it opens automatically on first start; afterwards it is reachable from the startup page). It configures one model provider at a time (the saved one becomes the primary model); saving again replaces the previous model config. To keep several providers (DeepSeek, Kimi, Qwen, etc.), use OpenClaw's own openclaw configure (double-click OpenClaw-CLI.bat / Mac-OpenClaw-CLI.command to open a shell) or edit data/.openclaw/openclaw.json directly, then switch between models via the dropdown in the chat interface; do not save a model in the Config Center afterwards, or models will be overwritten. Config is saved persistently on the USB drive.

Q: USB drive shows "cannot create file" / write errors? Check write protection, free space, and directory permissions first. NTFS is recommended for Windows-only use; full exFAT compatibility is still being validated. Run diagnostics before assuming the filesystem is the cause, and back up your data before formatting.

Q: Symlinks missing when copying from Ubuntu to USB? node_modules/.bin/ contains many symlinks that get skipped during direct cp -R. Use rsync -aL to expand symlinks into real files:

rsync -aL --progress portable/ /media/YOUR_USB/U-Claw/

Q: QQbot error: Unknown channel: qqbot? The bundled @sliverp/qqbot is uncompiled TypeScript source. Compile it manually:

cd portable/app/core/node_modules/@sliverp/qqbot
npm install && npm run build

This is fixed in the latest Release — downloading the pre-built release is recommended.

💼 Enterprise AI Consulting (paid)

U-Claw is free and MIT-licensed. Installing it for yourself costs nothing and needs nothing from me.

Putting AI into your company's actual workflow — support, documents, QA, quoting, internal knowledge bases — is a different job. I'm He Qubing, an independent AI product developer with 50+ delivered projects; I can carry a project from scoping to production on my own. That part is paid:

Start with the free call — if it's a bad fit I'll say so — [email protected] · hequbing.com

---

Contact & Partnership

• WeChat: hecare888 (or scan QR on the right)
• Telegram: @dsds8848
• Twitter/X: @Bitplus888
• Email: [email protected]
• GitHub: @dongsheng123132
• Website: u-claw.org

🤝 Reseller / Affiliate Program

U-Claw 3.0 delivers excellent user experience with very low return rates. We handle all after-sales support — you focus on selling:

• Live commerce / TikTok shop: Top commission rates, proven conversion in live streams
• Reseller / distribution: Revenue share or wholesale, custom branded versions available
• Technical partnership: Deep collaboration welcome for developers
• 👑 U-King distribution (new): give away U-King (free AI setup manager) — earn recurring revenue share on your customers' API top-ups. No inventory, we handle support

Interested? WeChat hecare888 (mention "partnership" for priority response).

---

Made with 🦞 by 贺去病 ai 工作室