zhenghy/u-claw
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

feat: v1.1 - simplified menus, pre-installed QQ plugin, updated README

Browse Source 
- Simplify menus from 17 to 8 options (config, dashboard, QQ, platforms, diagnostics, backup, restore, sysinfo)
- Pre-install QQ bot plugin (@sliverp/qqbot) - users only need AppID + Secret
- Install scripts now extract next to themselves (works on USB or computer)
- Rename all scripts to English (Mac-Install, Windows-Install, Mac-Start, etc.)
- Add README.txt for USB drive with bilingual instructions
- Rewrite README.md to match current v1.1 structure
- Remove old Chinese-named scripts, build script, test files, QR images
- Add Toolkit/ and U-Claw-CN/ to .gitignore
This commit is contained in:
dongsheng123132
2026-03-11 00:09:10 +08:00
parent c1e94d4dd9
commit 022f4f1f9a
19 changed files with 474 additions and 3747 deletions
Download Patch File Download Diff File Expand all files Collapse all files

346
README.md
View File

@@ -1,291 +1,167 @@
# 🦞 U-Claw
# 🦞 U-Claw 虾盘
**OpenClaw Offline Installer USB — Built for China, Works Everywhere**
**Portable AI Agent — 插上就能用的 AI 助手**
**OpenClaw 离线安装 U 盘 — 专为中国用户打造，全球可用**
> Like the legendary [YuLinMuFeng](https://en.wikipedia.org/wiki/Ylmf) Windows discs, but for AI.
> 就像当年的雨林木风，把 AI 助手的安装简化到"插 U 盘，双击运行"。
> 像当年的雨林木风，把 AI 助手简化到"双击运行"。
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
---
## Why U-Claw? / 为什么需要 U-Claw？
## 为什么需要 U-Claw？
[OpenClaw](https://github.com/openclaw/openclaw) is the most powerful open-source AI assistant framework — 20+ chat platforms, 50+ AI models. But in China, installing it is a nightmare:
[OpenClaw](https://github.com/openclaw/openclaw) 是最强的开源 AI 助手框架，但在中国安装它是个噩梦：GitHub 访问不了、npm 超时、Node.js 下载慢。
[OpenClaw](https://github.com/openclaw/openclaw) 是最强的开源 AI 助手框架，但在中国安装它是个噩梦：
**U-Claw 解决所有问题。** Node.js + OpenClaw + 所有依赖 + QQ 插件，全部打包好。双击即用。
- ❌ GitHub blocked / GitHub 访问不了
- ❌ npm install timeout / npm install 超时
- ❌ Node.js download slow / Node.js 下载慢
- ❌ Dependencies fail / 依赖装不上
## 快速开始
**U-Claw solves all of this.** Node.js runtime, OpenClaw source, all npm dependencies, 52 pre-installed skills — everything bundled on a USB drive. Plug in, double-click, done. For teams and schools, it is often lower-cost than cloud deployment for onboarding and day-to-day use.
### 方法 1：从 Releases 下载（推荐）
**U-Claw 解决所有这些问题。** Node.js + OpenClaw + 所有依赖 + 52个技能，全部打包。插上 U 盘，双击即用。对团队和学校场景，部署和培训成本通常也比云端部署更低。
1. 下载 [U-Claw-v1.1.tar.gz](https://github.com/dongsheng123132/u-claw/releases)
2. 解压到任意位置（U 盘、桌面、文档都行）
3. Mac: 双击 `Mac-Start.command` / Windows: 双击 `Windows-Start.bat`
## Features / 特性
### 方法 2：用 U 盘安装脚本
- 🚀 **Easy startup / 快速启动** — macOS + Windows, ready to run from USB
- 📦 **Fully offline / 完全离线** — No internet needed for installation
- 💸 **Lower TCO / 总成本更低** — For repeated deployments, often cheaper than cloud-only rollout
- 🇨🇳 **China-optimized / 中国优化** — 8 Chinese AI models (DeepSeek, Kimi, Qwen, GLM, MiniMax, Doubao, Qianfan, Mimo)
- 💬 **Multi-platform / 多平台** — QQ (official) / Feishu / WeChat / Telegram / Discord / WhatsApp / Slack
- 🔧 **Maintenance tools / 维护工具** — Diagnose, backup, restore, reset
- 🎯 **52 skills / 52个技能** — Pre-installed productivity skills
- 📖 **Bilingual docs / 双语文档** — Chinese + English
U 盘上有安装脚本，双击自动解压 + 启动：
- Mac: `Mac-Install.command`
- Windows: `Windows-Install.bat`
## Quick Start / 快速开始
### Option 1: Download Release / 下载发布版（推荐）
```bash
# Download from Releases / 从 Releases 下载
# https://github.com/dongsheng123132/u-claw/releases
# After extracting / 解压后：
# Mac: double-click "Mac-从U盘启动.command"
# Win: double-click "Windows-从U盘启动.bat"
```
### Option 2: Build Your Own / 自己构建
```bash
# Clone this repo / 克隆仓库
git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw
# Download OpenClaw source / 下载 OpenClaw 源码
git clone https://github.com/openclaw/openclaw.git openclaw-2026.3.7
# Build (downloads Node.js + installs deps + builds)
# 构建（自动下载 Node.js + 安装依赖 + 构建）
chmod +x build-uclaw.sh
./build-uclaw.sh
# Copy U-Claw/ folder to USB drive
# 把 U-Claw/ 文件夹复制到 U 盘
```
Note: `U-Claw/` is a generated release bundle. Keep the scripts/docs in git, and publish the built `U-Claw/` directory through GitHub Releases instead of committing it to the repository history.
说明：`U-Claw/` 是构建产物。建议把脚本和文档提交到 git，把生成好的 `U-Claw/` 目录通过 GitHub Releases 发布，而不是直接提交到仓库历史。
### Option 3: Copy from a Friend / 复制别人的
Just copy the `U-Claw/` folder. That's it.
### 方法 3：复制别人的
直接把 `U-Claw/` 文件夹复制一份就行。
## USB Contents / U 盘内容
## 目录结构
```
U-Claw/ (~1.3GB, 8GB USB minimum)
│
├── Mac-从U盘启动.command ← macOS: run from USB
├── Windows-从U盘启动.bat ← Windows: run from USB
├── Mac-全部功能.command ← macOS: full feature menu
├── Windows-全部功能.bat ← Windows: full feature menu
├── Mac-安装到电脑.command ← Install to Mac permanently
├── Windows-安装到电脑.bat ← Install to Windows permanently
├── 使用说明.txt ← Basic instructions
├── 中国用户指南.txt ← China quick-start guide
├── 教程-OpenClaw中国区完全指南.md ← Full tutorial (12 chapters)
│
├── runtime/ ← Node.js 22 runtimes
│ ├── node-mac-arm64/ ← Mac Apple Silicon (M1-M4)
│ ├── node-mac-x64/ ← Mac Intel
│ └── node-win-x64/ ← Windows 64-bit
│
├── openclaw/ ← OpenClaw + node_modules + dist
│ ├── skills/ ← 52 pre-installed skills
│ └── extensions/ ← 42 channel extensions
│
├── memory/ ← AI memory (user data)
├── persona/ ← AI personality config
└── backups/ ← Auto-created backups
U-Claw/ (~2.3GB)
├── Mac-Start.command ← Mac 双击启动
├── Windows-Start.bat ← Windows 双击启动
├── Mac-Menu.command ← Mac 配置/维护菜单
├── Windows-Menu.bat ← Windows 配置/维护菜单
├── U-Claw.html ← 导航页面
├── app/
│ ├── core/ ← OpenClaw + 依赖 + QQ 插件
│ └── runtime/
│ ├── node-mac-arm64/ ← Mac Apple Silicon
│ └── node-win-x64/ ← Windows 64-bit
├── data/ ← 用户数据（配置、记忆、备份）
│ ├── .openclaw/
│ ├── memory/
│ └── backups/
└── system/
└── migrate.js ← 配置迁移脚本
```
## Launcher Menu / 启动菜单
## 菜单功能
17 functions, inspired by YuLinMuFeng (雨林木风) installer UI:
精简到 8 个选项：
```
╔════════════════════════════════════════════════════════╗
║ 🦞 U-Claw 虾盘 v1.1 ║
║ Optimized for China · Offline · One-click ║
╠════════════════════════════════════════════════════════╣
━━ Install ━━
[1] Run from USB [2] Install to computer
[3] System info [4] OpenClaw status
━━ China Optimization ━━
[5] Setup wizard (model/platform/API Key)
[6] Chat platforms (QQ/Feishu/WeChat)
[7] Manage channels
━━ Maintenance ━━
[8] Diagnose & repair [9] Update OpenClaw
[10] Skills [11] Tools (MCP) [12] Plugins
━━ Skills & Usage ━━
[13] Browse skills market [14] China user guide
[15] Instructions [16] About
[17] Open web dashboard
[1] 配置向导（选模型、API Key）
[2] 打开网页控制台
[3] QQ 机器人（已预装，只需输入 ID）
[4] 其他平台（飞书/Telegram/微信）
[5] 诊断修复
[6] 备份配置
[7] 恢复备份
[8] 系统信息
```
## Supported AI Models / 支持的 AI 模型
## 支持的 AI 模型
### Chinese Models (no VPN needed) / 国产模型（无需翻墙）
### 国产模型（无需翻墙）
| Model 模型 | Provider 提供商 | Best for 推荐场景 |
|------------|----------------|-------------------|
| DeepSeek | 深度求索 | Coding, best value / 编程，性价比首选 |
| Kimi K2.5 | 月之暗面 Moonshot | Long docs, 256K context / 长文档 |
| Qwen | 阿里通义千问 | Large free tier / 免费额度大 |
| GLM 4.7 | 智谱AI Zhipu | Academic, Chinese NLP / 学术 |
| MiniMax | MiniMax | Voice, multimodal / 语音 |
| Doubao | 字节豆包 ByteDance | Volcano Engine / 火山引擎 |
| Qianfan | 百度千帆 Baidu | Baidu Cloud / 百度云 |
| Mimo | 小米 Xiaomi | Xiaomi ecosystem / 小米生态 |
| 模型 | 推荐场景 |
|------|----------|
| DeepSeek | 编程，性价比首选 |
| Kimi K2.5 | 长文档，256K 上下文 |
| 通义千问 Qwen | 免费额度大 |
| 智谱 GLM | 学术 |
| MiniMax | 语音、多模态 |
| 豆包 Doubao | 火山引擎 |
### International Models / 国际模型
### 国际模型
| Model | Provider | Best for |
|-------|----------|----------|
| Claude | Anthropic | Best overall + coding |
| GPT | OpenAI | Wide compatibility |
| Gemini | Google | Free tier |
Claude (Anthropic) · GPT (OpenAI) · Gemini (Google)
## Supported Chat Platforms / 支持的聊天平台
## 聊天平台
| Platform 平台 | Status 状态 | Notes 说明 |
|---------------|------------|------------|
| QQ | ✅ **Official** 腾讯官方 | 3 commands, 1 min, free / 3条命令搞定 |
| Feishu 飞书 | ✅ Built-in 已内置 | Enterprise best / 企业首选 |
| WeChat 微信 | ✅ Community plugin | iPad protocol |
| Telegram | ✅ Built-in | Recommended for intl users |
| Discord | ✅ Built-in | Gaming / community |
| WhatsApp | ✅ Built-in | International users |
| Slack | ✅ Built-in | Enterprise (intl) |
| WeCom 企业微信 | 🔜 Coming | — |
| DingTalk 钉钉 | 🔜 Coming | — |
| 平台 | 状态 | 说明 |
|------|------|------|
| QQ | ✅ **已预装** | 只需输入 AppID + AppSecret |
| 飞书 | ✅ 内置 | 企业首选 |
| Telegram | ✅ 内置 | 海外推荐 |
| 微信 | ✅ 社区插件 | iPad 协议 |
| Discord | ✅ 内置 | — |
| WhatsApp | ✅ 内置 | — |
### QQ Setup (1 minute) / QQ 接入（1 分钟）
### QQ 接入（1 分钟）
Tencent officially supports OpenClaw QQ bots. 腾讯官方支持：
QQ 插件已预装！只需：
1. 访问 q.qq.com 创建机器人，获取 AppID 和 AppSecret
2. 双击 `Mac-Menu.command`，选 [3] QQ 机器人
3. 输入 AppID 和 AppSecret，完成
```bash
# 1. Register / 注册: http://q.qq.com/qqbot/openclaw/login.html
# 2. Create bot, get AppID:AppSecret / 创建机器人
## 系统要求
# 3. Run 3 commands / 运行3条命令:
openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
- **macOS**: Apple Silicon (M1-M4), macOS 12+
- **Windows**: 10/11, 64-bit
- **内存**: 2GB+（推荐 4GB+）
- **存储**: 3GB+
# 4. Set allowlist! / 设置白名单！
openclaw config set channels.qqbot.allowFrom "your_qq_number"
## 升级
下载新版 `app/` 目录替换旧的，`data/` 不动（用户配置和记忆保留）。
## U 盘结构
```
UCLAW (U盘)
├── Mac-Install.command ← 首次双击（解压+启动）
├── Windows-Install.bat
├── U-Claw.tar.gz ← 压缩包
├── README.txt ← 使用说明
└── Toolkit/ ← 工程师 DIY 素材包
├── node-v22-mac-arm64.pkg
├── node-v22-win-x64.msi
├── openclaw-source.tar.gz
└── npm-cache.tar.gz
```
## System Requirements / 系统要求
## 仓库结构
- **macOS**: 12+ (Intel or Apple Silicon)
- **Windows**: 10/11 (64-bit)
- **RAM**: 2GB+ (4GB+ recommended)
- **USB**: 8GB+ (16GB recommended)
## Build Guide / 构建指南
### Prerequisites / 前提
- macOS or Linux (build environment)
- Internet access (only needed for building, not for end users)
- ~2GB disk space
### What the build script does / 构建脚本做了什么
1. Downloads Node.js 22 for 3 platforms (Mac ARM64 + Mac x64 + Win x64), prefers China mirror
2. Copies OpenClaw source to `U-Claw/openclaw/`
3. Installs `pnpm` and runs `pnpm install` with China mirror (registry.npmmirror.com)
4. Runs `pnpm build` to build OpenClaw
5. Copies launcher scripts and docs
6. Output: ~1.3GB ready to copy to USB
### Updating / 更新
```bash
# Download new OpenClaw source, replace openclaw-2026.3.7/
./build-uclaw.sh
# Copy new U-Claw/ to USB
```
## Contributing / 参与贡献
PRs welcome! Especially needed / 欢迎 PR，特别需要：
- 🔧 More platform repair scripts / 更多平台修复脚本
- 📖 Tutorials and guides / 教程
- 💬 More chat bridges (WeCom, DingTalk) / 企业微信、钉钉桥接
- 🎯 Useful skills / 实用技能
- 🌐 Translations / 翻译
```bash
# Fork → Branch → Commit → PR
git checkout -b feature/my-feature
git commit -m "feat: add xxx"
git push origin feature/my-feature
u-claw/
├── portable/ ← 脚本源码（打包进 U-Claw）
├── uclaw-scripts/ ← U 盘安装脚本
├── website/ ← 官网
├── docs/ ← 文档
└── README.md
```
## Related Projects / 相关项目
| Project 项目 | Stars | Description 说明 |
|-------------|-------|-----------------|
| [OpenClaw](https://github.com/openclaw/openclaw) | — | The AI assistant framework / AI 助手框架 |
| [hello-claw](https://github.com/datawhalechina/hello-claw) | 90+ | Systematic Chinese tutorial / 体系化中文教程 |
| [openclaw-docs](https://github.com/yeuxuan/openclaw-docs) | 500+ | 276 source-level docs / 源码级文档 |
| [awesome-openclaw-skills-zh](https://github.com/clawdbot-ai/awesome-openclaw-skills-zh) | 2500+ | Chinese skill library / 中文技能库 |
| [NapCatQQ](https://github.com/NapNeko/NapCatQQ) | — | QQ bot framework (OneBot v11) |
## FAQ
**Q: Do end users need a VPN? / 用户需要翻墙吗？**
A: No for installation. Runtime needs internet for AI APIs — Chinese models (DeepSeek etc.) work without VPN.
安装不需要。运行需要联网调 API，国产模型无需翻墙。
**Q: 需要翻墙吗？**
安装不需要。运行需要联网调 AI API，国产模型无需翻墙。
**Q: USB drive size? / U 盘要多大？**
A: 8GB minimum, 16GB recommended.
**Q: 能分发吗？**
可以，MIT 协议，随便复制。
**Q: Can I share it? / 能分发吗？**
A: Yes, unlimited. MIT license, copy freely.
可以，无限制，MIT 协议。
**Q: Windows needs WSL? / Windows 需要 WSL 吗？**
A: No. U-Claw bundles Windows Node.js, runs natively via `.bat`.
不需要。自带 Windows 版 Node.js。
**Q: Windows 需要 WSL 吗？**
不需要，自带 Windows 版 Node.js。
## License
[MIT](LICENSE) — Free to use, modify, distribute.
[MIT](LICENSE)
自由使用、修改、分发。
## 联系
## Contact / 联系方式
- **WeChat 微信**: Scan QR below / 扫码添加
<img src="微信二维码.jpg" alt="WeChat QR" width="200">
- **Xiaohongshu 小红书**: [关注主页 / Follow](https://xhslink.com/m/6mf7Mq2M5wP)
- **Email 邮箱**: hefangsheng@gmail.com
- **GitHub**: [@dongsheng123132](https://github.com/dongsheng123132)
- **Website 官网**: [u-claw.org](https://u-claw.org)
- 微信: hecare888
- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)
- 官网: [u-claw.org](https://u-claw.org)
---
**Made with 🦞 by [dongsheng](https://github.com/dongsheng123132) & OpenClaw Community**
**Website: [u-claw.org](https://u-claw.org)** · **Email: hefangsheng@gmail.com**
**Made with 🦞 by [dongsheng](https://github.com/dongsheng123132)**