U-Claw 把 OpenClaw 打包成 U 盘便携版。这个代码库就是 U 盘里的全部内容，只是不上传大依赖（Node.js、node_modules）。运行 setup.sh 补齐依赖后，直接拷贝到 U 盘就能用。
使用方式
git clone https://gitee.com/dr_eric/u-claw.git
cd u-claw/portable
bash setup.sh # 补齐大依赖（Node.js + OpenClaw，国内镜像，约 1 分钟）
完成后 portable/ 就是完整的 U 盘内容。 拷贝到 U 盘即可：
# Mac
cp -R portable/ /Volumes/你的U盘/U-Claw/
# 或直接在 Finder 拖过去
U 盘上能做什么
| | | |
|---|
| 免安装运行 | 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 功能菜单（8 项）
├── Mac-Install.command 安装到 Mac
├── Windows-Start.bat 双击 = Windows 免安装运行
├── Windows-Menu.bat 功能菜单
├── Windows-Install.bat 安装到 Windows
├── Config.html 首次配置页面
├── setup.sh 补齐依赖用（开发者用）
├── app/ ← 大依赖（setup.sh 下载，不进 git）
│ ├── core/ OpenClaw + QQ 插件
│ └── runtime/
│ ├── node-mac-arm64/ Mac Apple Silicon
│ └── node-win-x64/ Windows 64-bit
└── data/ ← 用户数据（不进 git）
├── .openclaw/ 配置文件
├── memory/ AI 记忆
└── backups/ 备份
代码库 = U 盘内容 - 大依赖。app/ 和 data/ 在 .gitignore 里。
桌面安装版（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 模型
国产模型（无需翻墙）
国际模型
Claude · GPT · Gemini（需翻墙或中转）
支持的聊天平台
国内镜像
所有脚本默认走国内镜像，无需翻墙：
| |
|---|
| registry.npmmirror.com |
| npmmirror.com/mirrors/node |
| npmmirror.com/mirrors/electron |
开发 & 测试
# 克隆
git clone https://gitee.com/dr_eric/u-claw.git
# 补依赖
cd u-claw/portable && bash setup.sh
# 测试启动
bash Mac-Start.command # Mac
# 或 Windows-Start.bat # Windows
# 测试没问题 → 拷到 U 盘
# 有问题 → 修代码 → 重新测试
提交代码
git checkout -b feat/your-feature
git add -A
git commit -m "feat: your change"
git push -u origin feat/your-feature
FAQ
Q: 需要翻墙吗？安装不需要。运行需要联网调 API，国产模型无需翻墙。
Q: U 盘需要多大？建议 4GB 以上（完整版约 2.3GB）。
Q: 能分发吗？MIT 协议，随便复制。
Q: Mac 提示"未验证的开发者"？右键脚本 → 打开。
License
MIT
粤ICP备14082021号
免费POC，
零成本试错
