u-claw/README.zh-CN.md

U-Claw（虾盘）

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

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

Important

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

三步开始

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

你得到什么	为什么重要
随身 AI 工作空间	换电脑时带走配置、记忆与工具，不在主机残留用户数据。
本地优先	不绑定设备、不打指纹、不上传本地配置。
多种使用方式	便携 U 盘、在线一键安装、可启动 Linux U 盘各自独立。

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 是纯开源工具，不绑定设备、不打指纹、不上传任何数据。首次启动会自动打开 Config 页面，选一个模型、填入自己的 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://gitea.fanghe.it.com/zhenghy/u-claw.git

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

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

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

U 盘功能一览

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

U 盘文件结构

U-Claw/                          ← 整个拷到 U 盘
├── START HERE - Mac.command             Mac 免安装运行
├── Mac-Menu.command              Mac 功能菜单
├── Mac-Install.command           安装到 Mac
├── START HERE - Windows.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）：u-claw-app/ 的 Electron 桌面版（.exe 安装版 / 绿色版 / .dmg）已于 2026-06-19 停止发布并归档，原因见 u-claw-app/DEPRECATED.md。U-Claw 现在只发布「便携 U 盘版」——这才是产品的本质：插上 U 盘、解压即用。

直接下载发行版

GitHub Releases 提供便携 U 盘版：

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

⚠️ U 盘请用 NTFS 格式（不要 exFAT/FAT32）：Node.js 在 exFAT 上 IO 极慢且不支持符号链接，可能导致启动失败。

支持的 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://gitea.fanghe.it.com/zhenghy/u-claw.git
cd u-claw/portable/advanced && bash setup.sh
bash "START HERE - Mac.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
• Telegram: @dsds8848
• Twitter/X: @Bitplus888
• Email: hefangsheng@gmail.com
• 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 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 下载最新版。

联系 & 合作

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

🤝 招募代理 / 带货合作

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

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

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

---

---

English · 中文