+
-
+
把 AI 工作空间装进 U 盘：插上任意电脑，配置、记忆和工具都跟着走。
+装在 U 盘里的 AI 工作空间。插到任何一台电脑上，设置、记忆和工具都跟着走。
- 下载便携版 · - 完整教程 · - 从源码制作 · + 下载 · + 三步开始 · + 从源码构建 · English
@@ -20,293 +20,146 @@ > [!IMPORTANT] -> 这不是 U 盘制作工具。这个仓库就是 U 盘的文件骨架：运行一次 `setup.sh` 补齐运行时，再把整个 `portable/` 拷到盘里即可。 +> 这个仓库不是"做 U 盘的工具"，**它本身就是 U 盘里的内容**。跑一次 `setup.sh` 把运行时补齐，然后把 `portable/` 整个拷到盘里就行。 + +## 为什么是 U 盘 + +三个理由，也就是这个产品的全部卖点： + +1. **公司电脑经常不让装软件。** 金融、政府外包和多数受监管行业都锁得很死。U 盘不需要安装程序，也不需要管理员权限。 +2. **你的配置跟着你走。** 模型密钥、聊天记录、项目记忆都在盘上的 `data/` 里，不在你临时借用的那台机器上。 +3. **主机上不留东西。** 拔盘走人。（有一条要说清楚：为了让慢速 U 盘启动不至于难以忍受，U-Claw 会往主机本地磁盘写一份可重建的缓存。`advanced/` 里有一键清理。） ## 三步开始 -1. 从 [Releases](https://gitea.fanghe.it.com/zhenghy/u-claw/releases) 下载 Windows 便携版，解压到 U 盘后双击 `START HERE - Windows.bat`。 -2. 或克隆仓库，在 `portable/` 运行 `bash setup.sh`，下载 Node.js 与 OpenClaw。 -3. 首次启动在本地配置模型 Key；配置只保存在 U 盘的 `data/.openclaw/openclaw.json`。 +1. 从 [Releases](https://gitea.fanghe.it.com/zhenghy/u-claw/releases) 下载便携版，解压到 U 盘，双击 `START HERE - Windows.bat`（或 `START HERE - Mac.command`） +2. 设置页会自动打开。**粘贴一个 API 密钥就行** —— U-Claw 会自己认出是哪家的，并在接受之前先测一下通不通 +3. 开始对话 -| 你得到什么 | 为什么重要 | -| --- | --- | -| 随身 AI 工作空间 | 换电脑时带走配置、记忆与工具，不在主机残留用户数据。 | -| 本地优先 | 不绑定设备、不打指纹、不上传本地配置。 | -| 多种使用方式 | 便携 U 盘、在线一键安装、可启动 Linux U 盘各自独立。 | +**还没有密钥？** [Google Gemini](https://aistudio.google.com/apikey) 最容易拿：用 Google 账号登录，不用绑卡，有免费额度。想一个密钥用多种模型的话，[OpenRouter](https://openrouter.ai/keys) 是不错的第二选择。 -> [!TIP] -> ### 👑 同作者新品：U-King · AI 装机管家 -> 一键装好 **Claude Code / Codex / OpenClaw / Hermes** 四大 AI 神器，驱动自动配好——一个 Key 直用 Claude、GPT、DeepSeek、Kimi 等 24+ 全球模型，免翻墙。绿色版仅几 MB，双击即用，还带 AI 作图 / 视频 / 本地大模型 / 多终端工作台。 -> -> **免费下载：[www.u-king.org](https://www.u-king.org)**（国内镜像 [cloud.u-claw.org/uking](https://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](https://www.u-king.org)* +## 用哪个模型 ---- +| 模型 | 适合 | +|---|---| +| **Claude** | 综合最强 | +| **GPT** | 用的人最多 | +| **Gemini** | 有免费额度，注册最简单 | +| **SEA-LION** | 马来语、泰米尔语、Singlish —— AI Singapore 做的 | +| **本地模型** | 离线。数据不出这台机器。 | - +其他模型（DeepSeek、Kimi、通义、GLM 等）在设置页的「高级」里填自己的接口地址即可。 -## 中文 +> **关于 SEA-LION**：托管 API 免费，但目前限流 **每人每分钟 10 次请求**，且官方没公布付费档。聊天够用，agent 类工作量偏紧 —— 所以它是特色选项而不是默认。 -### 这是什么 - -U-Claw（虾盘）是一个**制作教程 + 全套源代码**，教你把 [OpenClaw](https://github.com/openclaw/openclaw)（开源 AI 助手框架）做成 U 盘——插上任意电脑，双击就能用 AI。为什么叫虾盘？U-Claw = USB + Claw（虾钳），U 盘 + AI = 虾盘。 - -代码库本身就是 U 盘的文件骨架，运行 `setup.sh` 补齐大依赖后，整个 `portable/` 目录直接拷贝到 U 盘即可。 - -> 📖 **[完整教程](https://u-claw.org/tutorial.html)** — 从零开始的手工安装指南、模型配置、聊天平台接入，小白也能看懂。 - -### 🧩 模型随便选：国内外大模型都能用 - -U-Claw 是纯开源工具，**不绑定设备、不打指纹、不上传任何数据**。首次启动会自动打开 Config 页面，选一个模型、填入自己的 API Key 即可一键启动： - -- **虾盘云（首选 · 中转站）**：一个 Key 调用 DeepSeek / Claude / GPT / 通义 等国内外全部大模型，无需翻墙。注册并充值：[u-claw.org/cloud.html](https://u-claw.org/cloud.html) -- **各家官方 Key 也行**：DeepSeek、通义千问、Kimi、智谱 GLM、豆包、MiniMax（国内）/ OpenAI、Claude、Groq（国外）/ 硅基流动、任意 OpenAI 兼容地址（自定义） -- **配置只存在本地** `data/.openclaw/openclaw.json`，拔盘不留痕 - -### 一键安装（推荐） - -不需要 U 盘，一行命令直接装到电脑： - -```bash -# 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`](install/README.md)。 - -### 快速开始：制作便携版 U 盘 - -```bash -# 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/`](bootable/) 目录（与其他模块完全独立，互不影响） -- 独立仓库：[u-claw-linux](https://gitea.fanghe.it.com/zhenghy/u-claw-linux)（内容一致，方便单独克隆） - -基于 Ventoy + Ubuntu 24.04 LTS + 持久化存储，在 Windows 上运行 4 步 PowerShell 脚本即可制作。详见 [`bootable/README.md`](bootable/README.md)。 - -> **关于桌面安装版（Electron）**：`u-claw-app/` 的 Electron 桌面版（`.exe` 安装版 / 绿色版 / `.dmg`）**已于 2026-06-19 停止发布并归档**，原因见 [`u-claw-app/DEPRECATED.md`](u-claw-app/DEPRECATED.md)。U-Claw 现在只发布「便携 U 盘版」——这才是产品的本质：插上 U 盘、解压即用。 - -### 直接下载发行版 - -[GitHub Releases](https://gitea.fanghe.it.com/zhenghy/u-claw/releases) 提供便携 U 盘版： - -- `u-claw-portable-windows-vX.Y.Z.zip` — Windows 便携完整版（已预装 Node + OpenClaw，**解压到 U 盘双击 `START HERE - Windows.bat` 即用**） -- **Mac**：源码在 [`portable/`](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 协议 | +|---|---|---| +| Telegram | ✅ 内置 | — | +| WhatsApp | ⚠️ 内置 | 用的是 Baileys 非官方协议，**账号有被封的真实风险**。接入之前先看设置页里的提示，不要接你离不开的号码 | | Discord | ✅ 内置 | — | -| 微信 | ✅ 社区插件 | iPad 协议 | +| Slack | ✅ 内置 | — | +| 微信 · QQ · 飞书 · 钉钉 | 可选 | 主要给在中国的用户，在设置页的折叠区里 | -### 国内镜像 - -所有脚本默认走国内镜像，无需翻墙： - -| 资源 | 镜像 | -|------|------| -| npm 包 | `registry.npmmirror.com` | -| Node.js | `npmmirror.com/mirrors/node` | -| Electron | `npmmirror.com/mirrors/electron` | - -### 开发 & 贡献 +## 自己构建 ```bash -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 测试 +git clone ssh://git@gitea.fanghe.it.com:222/zhenghy/u-claw.git +cd u-claw/portable/advanced && bash setup.sh # 下载 Node.js + OpenClaw，约一分钟 + +cp -R portable/ /Volumes/你的U盘/U-Claw/ # Mac +# Windows 上直接把文件夹拖到盘里 ``` -**平台支持：** +## 盘上有什么 -| 平台 | 状态 | 说明 | -|------|------|------| -| Mac Apple Silicon (M1-M4) | ✅ | 便携版 | -| Mac Intel (x64) | ✅ | 便携版 | -| Windows x64 | 🚧 开发中 | 便携版 | -| Linux x64（可启动 U 盘） | ✅ | [`bootable/`](bootable/) 目录 | +U 盘里**只有三个能点的文件**，其余都在 `advanced/` 里。 -欢迎 PR！特别需要：Windows 脚本完善、教程翻译。 +| | Mac | Windows | +|---|---|---| +| **启动** | `START HERE - Mac.command` | `START HERE - Windows.bat` | +| **看说明** | `Read me first.html` | `Read me first.html` | +| **设置** | 首次启动自动打开 | 首次启动自动打开 | +| *诊断、命令行、装到本机* | `advanced/` | `advanced/` | -### 🦞 寻找技术伙伴 +``` +U-Claw/ +├── START HERE - Windows.bat ← 双击这个 +├── START HERE - Mac.command ← 或这个 +├── Read me first.html 三步上手 +├── advanced/ 诊断、命令行、装到电脑、构建脚本 +├── skills/ 技能内容和 manifest.json +├── lib/ 启动器、i18n、辅助脚本 +├── app/ 运行时（setup.sh 下载，不在 git 里） +└── data/ 你的数据（不在 git 里） + ├── .openclaw/ 配置 + ├── memory/ AI 记住的东西 + └── backups/ +``` -U-Claw 是一个快速成长的开源项目，目前已有不少商业合作机会。 +## Linux 可启动 U 盘 -我们正在寻找： -- **技术伙伴** — 全栈 / Node.js / Electron / 脚本自动化 -- **资源合作** — 渠道、内容、社区运营 +目标电脑上连操作系统都没有？从盘启动进 Ubuntu，U-Claw 已经装好。见 [`bootable/`](bootable/)，基于 Ventoy + Ubuntu 24.04 LTS + 持久化。 -如果你对 AI 工具的落地和商业化感兴趣，欢迎联系： +> Electron 桌面版（`u-claw-app/`）**已于 2026-06-19 停止发布**，代码仅作存档，见 [`u-claw-app/DEPRECATED.md`](u-claw-app/DEPRECATED.md)。便携 U 盘版才是产品本体。 -- 微信: hecare888 -- Telegram: [@dsds8848](https://t.me/dsds8848) -- Twitter/X: [@Bitplus888](https://x.com/Bitplus888) -- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com) -- GitHub: [@dongsheng123132](https://github.com/dongsheng123132) -- 官网: [u-claw.org](https://u-claw.org) +## 这安全吗 -### FAQ +- **你的 API 密钥只写在盘上。** 除了你自己选的那家模型服务商，不会发到任何地方。 +- **没有任何遥测。** 不打设备指纹、不上报使用情况、不需要注册账号 —— 这些代码在这个版本里根本不存在。 +- **对话记录留在盘上的 `data/` 里。** +- **确实会离开这台机器的**：你发的消息会到你配置的那家模型服务商，和你直接用他们的 App 是一样的。如果这对你的数据不可接受，请用本地模型。 -**Q: 需要翻墙吗？** -不需要。安装和运行全程使用国内镜像，国产模型 API 直连。 +## U 盘用什么格式 -**Q: U 盘需要多大？** -4GB+（完整约 2.3GB）。 +**exFAT。不要用 NTFS。** -**Q: 能分发吗？** -MIT 协议，随便复制分发。 +macOS 对 NTFS **只读**，用 NTFS 的话「配置跟着盘走」这件事在 Mac 上直接失效 —— 首次启动连配置都写不进去。 -**Q: Mac 提示"未验证的开发者"？** -右键脚本 → 打开。 +exFAT 处理大量小文件确实慢，所以 U-Claw 启动时会把可重建的缓存挪到主机本地磁盘。你的实际数据仍然留在盘上。 -**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` +## 参与开发 + +见 [CONTRIBUTING.md](CONTRIBUTING.md)。每次 push 前会跑测试： -**Q: 系统已有 Node.js v24，安装失败？** -Node.js v24 是最新开发版，部分依赖尚不兼容。需要 **v20 或 v22 LTS**。删除已下载的 runtime 目录后重新运行 setup，它会自动下载内置的 Node v22： ```bash -# Windows -rmdir /s /q portable\app\runtime\node-win-x64 -setup.bat - -# Mac -rm -rf portable/app/runtime/node-mac-arm64 -bash setup.sh +node --test ``` -**Q: Mac 上提示 `.toSorted is not a function`？** -系统旧版 Node.js 被检测到并跳过了内置版本下载，但旧版 Node 不支持 `.toSorted()`（需要 v20+）。删除 runtime 目录让脚本重新下载内置 Node v22： -```bash -rm -rf portable/app/runtime/node-mac-arm64 -bash setup.sh -``` +> 不是 `node --test tests/` —— Node 会把那个路径当模块加载并报 `Cannot find module`，一个测试都不跑。 -**Q: 如何同时配置多个 AI 模型并切换？** -支持同时配置多个 provider！打开 `Config.html` → 在 Providers 区域点击「添加」，逐个填入各模型的 API Key 和地址（如 DeepSeek、Kimi、通义等）→ 保存后，在聊天界面左上角下拉菜单随时切换。配置持久保存在 U 盘上。 +它检查的是那些会悄悄坏掉的东西：启动器有没有保持精简、`.bat` 有没有保持纯 ASCII、有没有中国下载源溜回来、两个安装器对技能的处理是否一致、每个界面字符串是不是在每种语言里都有。 -**Q: U 盘安装后无法创建文件 / 写入失败？** -两种可能：① U 盘侧面有物理写保护开关，拨到解锁位置；② U 盘格式不兼容，建议格式化为 **exFAT**（Mac/Windows/Linux 三端均支持读写）。 +## 常见问题 -**Q: 从 Ubuntu 向 U 盘复制时符号链接丢失？** -`node_modules/.bin/` 下有大量符号链接，FAT32/exFAT 在直接 `cp -R` 时会跳过。用 `rsync -aL` 可将符号链接展开为真实文件： -```bash -rsync -aL --progress portable/ /media/YOUR_USB/U-Claw/ -``` +**需要安装什么吗？** +不需要。这就是重点。 -**Q: QQbot 报错 `Unknown channel: qqbot`？** -Bundle 里的 `@sliverp/qqbot` 是未编译的 TypeScript 源码，需要先编译： -```bash -cd portable/app/core/node_modules/@sliverp/qqbot -npm install && npm run build -``` -正式 Release 包已修复此问题，建议从 [Releases](https://gitea.fanghe.it.com/zhenghy/u-claw/releases) 下载最新版。 +**Mac 和 Windows 都能用吗？** +同一个盘，两边都能用。Windows 版发布时已经带好运行时；Mac 第一次启动会自己下载，约一分钟。 -### 联系 & 合作 +**我的设置存在哪？** +盘上的 `data/.openclaw/openclaw.json`。复制这个盘，就复制了你的整套配置。 -
+**能离线用吗？**
+可以，用本地模型。其他都需要能连上你的模型服务商。
-- 微信: hecare888（或扫右侧二维码）
-- Telegram: [@dsds8848](https://t.me/dsds8848)
-- Twitter/X: [@Bitplus888](https://x.com/Bitplus888)
-- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com)
-- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)
-- 官网: [u-claw.org](https://u-claw.org)
+**界面语言能改吗？**
+能，设置页里。而且**语言记在盘上而不是浏览器里** —— 你把盘插到同事的英文系统上，看到的仍然是中文。
-**🤝 招募代理 / 带货合作**
+## 关于这个分支
-虾盘 3.0 体验极佳，退货率极低，售后由我们负责——你只管卖货：
+这是 [dongsheng123132/u-claw](https://github.com/dongsheng123132/u-claw) 的一个 fork，面向新加坡 / 东南亚市场做了改造：默认值国际化、界面双语、降低非技术用户的上手门槛。
-- **抖店 / 直播带货**：提供最高佣金比例，产品已在多个直播间验证转化
-- **代理分销**：买断或按单分润均可谈，支持定制版本
-- **技术合作**：有开发能力者欢迎深度合作
-- **👑 U-King 装机管家分销（新）**：[U-King](https://www.u-king.org) 软件本身免费送客户，客户按用量给 AI 模型 API 充值，你拿**持续分润**——不压货、零售后（我们负责），赚的是长期流水。适合装机店、AI 培训、社群主理人
+**我们不向上游提交改动** —— 这个版本移除的中国市场默认值，恰恰是上游项目存在的意义。
-有意向请微信联系（备注「代理合作」优先处理）。
-
----
-
-
+## 联系
+- Issues — [gitea.fanghe.it.com/zhenghy/u-claw/issues](https://gitea.fanghe.it.com/zhenghy/u-claw/issues)
---
English · 中文
+ +MIT License
diff --git a/tests/i18n-pages.test.mjs b/tests/i18n-pages.test.mjs index 504c9e8..1b138bf 100644 --- a/tests/i18n-pages.test.mjs +++ b/tests/i18n-pages.test.mjs @@ -310,3 +310,32 @@ test('persona skills install through the one shared installer', () => { assert.match(server, /'\.\.', '\.\.', 'lib', 'install-skills\.mjs'/, 'the checkout fallback path is missing'); assert.match(server, /'--persona', persona/, 'it should filter by persona'); }); + +test('the two READMEs describe the same product', () => { + // They drifted badly before: the English one had been rewritten for the fork + // while the Chinese one still pitched the upstream China-market build — + // relay service first, ten China-platform skills, QQ pre-installed. + const en = read('README.md'); + const zh = read('README.zh-CN.md'); + + for (const [name, body] of [['README.md', en], ['README.zh-CN.md', zh]]) { + // Both must link to the other, or half the audience is stranded. + assert.match(body, name === 'README.md' ? /README\.zh-CN\.md/ : /README\.md/, `${name} should link to the other language`); + // Both must say this is a fork. Claiming otherwise misrepresents whose work it is. + assert.match(body, /dongsheng123132\/u-claw/, `${name} should name the upstream project`); + // The file-system guidance is a correctness issue, not a preference: + // macOS cannot write NTFS, so an NTFS drive breaks the whole premise. + assert.match(body, /exFAT/, `${name} should say to format the drive exFAT`); + assert.doesNotMatch( + body, + /(use|请用|格式化).{0,12}NTFS/i, + `${name} appears to recommend NTFS, which macOS cannot write to`, + ); + } + + // Anything the English one dropped for being upstream's pitch must be gone + // from the Chinese one too. + for (const stale of ['虾盘云', '免翻墙', '国内镜像', '小红书', 'hecare888']) { + assert.ok(!zh.includes(stale), `README.zh-CN.md still carries upstream's "${stale}"`); + } +});