U-Claw
装在 U 盘里的 AI 工作空间。插到任何一台电脑上，设置、记忆和工具都跟着走。
下载 ·
三步开始 ·
从源码构建 ·
English
> [!IMPORTANT]
> 这个仓库不是"做 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) 下载便携版，解压到 U 盘，双击 `START HERE - Windows.bat`（或 `START HERE - Mac.command`）
2. 设置页会自动打开。**粘贴一个 API 密钥就行** —— U-Claw 会自己认出是哪家的，并在接受之前先测一下通不通
3. 开始对话
**还没有密钥？** [Google Gemini](https://aistudio.google.com/apikey) 最容易拿：用 Google 账号登录，不用绑卡，有免费额度。想一个密钥用多种模型的话，[OpenRouter](https://openrouter.ai/keys) 是不错的第二选择。
## 用哪个模型
| 模型 | 适合 |
|---|---|
| **Claude** | 综合最强 |
| **GPT** | 用的人最多 |
| **Gemini** | 有免费额度，注册最简单 |
| **SEA-LION** | 马来语、泰米尔语、Singlish —— AI Singapore 做的 |
| **本地模型** | 离线。数据不出这台机器。 |
其他模型（DeepSeek、Kimi、通义、GLM 等）在设置页的「高级」里填自己的接口地址即可。
> **关于 SEA-LION**：托管 API 免费，但目前限流 **每人每分钟 10 次请求**，且官方没公布付费档。聊天够用，agent 类工作量偏紧 —— 所以它是特色选项而不是默认。
## 聊天软件
| 平台 | 状态 | 说明 |
|---|---|---|
| Telegram | ✅ 内置 | — |
| WhatsApp | ⚠️ 内置 | 用的是 Baileys 非官方协议，**账号有被封的真实风险**。接入之前先看设置页里的提示，不要接你离不开的号码 |
| Discord | ✅ 内置 | — |
| Slack | ✅ 内置 | — |
| 微信 · QQ · 飞书 · 钉钉 | 可选 | 主要给在中国的用户，在设置页的折叠区里 |
## 自己构建
```bash
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 上直接把文件夹拖到盘里
```
## 盘上有什么
U 盘里**只有三个能点的文件**，其余都在 `advanced/` 里。
| | 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/
```
## Linux 可启动 U 盘
目标电脑上连操作系统都没有？从盘启动进 Ubuntu，U-Claw 已经装好。见 [`bootable/`](bootable/)，基于 Ventoy + Ubuntu 24.04 LTS + 持久化。
> Electron 桌面版（`u-claw-app/`）**已于 2026-06-19 停止发布**，代码仅作存档，见 [`u-claw-app/DEPRECATED.md`](u-claw-app/DEPRECATED.md)。便携 U 盘版才是产品本体。
## 这安全吗
- **你的 API 密钥只写在盘上。** 除了你自己选的那家模型服务商，不会发到任何地方。
- **没有任何遥测。** 不打设备指纹、不上报使用情况、不需要注册账号 —— 这些代码在这个版本里根本不存在。
- **对话记录留在盘上的 `data/` 里。**
- **确实会离开这台机器的**：你发的消息会到你配置的那家模型服务商，和你直接用他们的 App 是一样的。如果这对你的数据不可接受，请用本地模型。
## U 盘用什么格式
**exFAT。不要用 NTFS。**
macOS 对 NTFS **只读**，用 NTFS 的话「配置跟着盘走」这件事在 Mac 上直接失效 —— 首次启动连配置都写不进去。
exFAT 处理大量小文件确实慢，所以 U-Claw 启动时会把可重建的缓存挪到主机本地磁盘。你的实际数据仍然留在盘上。
## 参与开发
见 [CONTRIBUTING.md](CONTRIBUTING.md)。每次 push 前会跑测试：
```bash
node --test
```
> 不是 `node --test tests/` —— Node 会把那个路径当模块加载并报 `Cannot find module`，一个测试都不跑。
它检查的是那些会悄悄坏掉的东西：启动器有没有保持精简、`.bat` 有没有保持纯 ASCII、有没有中国下载源溜回来、两个安装器对技能的处理是否一致、每个界面字符串是不是在每种语言里都有。
## 常见问题
**需要安装什么吗？**
不需要。这就是重点。
**Mac 和 Windows 都能用吗？**
同一个盘，两边都能用。Windows 版发布时已经带好运行时；Mac 第一次启动会自己下载，约一分钟。
**我的设置存在哪？**
盘上的 `data/.openclaw/openclaw.json`。复制这个盘，就复制了你的整套配置。
**能离线用吗？**
可以，用本地模型。其他都需要能连上你的模型服务商。
**界面语言能改吗？**
能，设置页里。而且**语言记在盘上而不是浏览器里** —— 你把盘插到同事的英文系统上，看到的仍然是中文。
## 关于这个分支
这是 [dongsheng123132/u-claw](https://github.com/dongsheng123132/u-claw) 的一个 fork，面向新加坡 / 东南亚市场做了改造：默认值国际化、界面双语、降低非技术用户的上手门槛。
**我们不向上游提交改动** —— 这个版本移除的中国市场默认值，恰恰是上游项目存在的意义。
## 联系
- Issues — [gitea.fanghe.it.com/zhenghy/u-claw/issues](https://gitea.fanghe.it.com/zhenghy/u-claw/issues)
---
English · 中文
MIT License