022f4f1f9a
- 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
168 lines
4.5 KiB
Markdown
168 lines
4.5 KiB
Markdown
# 🦞 U-Claw 虾盘
|
||
|
||
**Portable AI Agent — 插上就能用的 AI 助手**
|
||
|
||
> 像当年的雨林木风，把 AI 助手简化到"双击运行"。
|
||
|
||
[](https://opensource.org/licenses/MIT)
|
||
|
||
---
|
||
|
||
## 为什么需要 U-Claw？
|
||
|
||
[OpenClaw](https://github.com/openclaw/openclaw) 是最强的开源 AI 助手框架，但在中国安装它是个噩梦：GitHub 访问不了、npm 超时、Node.js 下载慢。
|
||
|
||
**U-Claw 解决所有问题。** Node.js + OpenClaw + 所有依赖 + QQ 插件，全部打包好。双击即用。
|
||
|
||
## 快速开始
|
||
|
||
### 方法 1：从 Releases 下载（推荐）
|
||
|
||
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`
|
||
|
||
### 方法 2：用 U 盘安装脚本
|
||
|
||
U 盘上有安装脚本，双击自动解压 + 启动：
|
||
- Mac: `Mac-Install.command`
|
||
- Windows: `Windows-Install.bat`
|
||
|
||
### 方法 3：复制别人的
|
||
|
||
直接把 `U-Claw/` 文件夹复制一份就行。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
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 ← 配置迁移脚本
|
||
```
|
||
|
||
## 菜单功能
|
||
|
||
精简到 8 个选项：
|
||
|
||
```
|
||
[1] 配置向导（选模型、API Key）
|
||
[2] 打开网页控制台
|
||
[3] QQ 机器人（已预装，只需输入 ID）
|
||
[4] 其他平台（飞书/Telegram/微信）
|
||
[5] 诊断修复
|
||
[6] 备份配置
|
||
[7] 恢复备份
|
||
[8] 系统信息
|
||
```
|
||
|
||
## 支持的 AI 模型
|
||
|
||
### 国产模型（无需翻墙）
|
||
|
||
| 模型 | 推荐场景 |
|
||
|------|----------|
|
||
| DeepSeek | 编程，性价比首选 |
|
||
| Kimi K2.5 | 长文档，256K 上下文 |
|
||
| 通义千问 Qwen | 免费额度大 |
|
||
| 智谱 GLM | 学术 |
|
||
| MiniMax | 语音、多模态 |
|
||
| 豆包 Doubao | 火山引擎 |
|
||
|
||
### 国际模型
|
||
|
||
Claude (Anthropic) · GPT (OpenAI) · Gemini (Google)
|
||
|
||
## 聊天平台
|
||
|
||
| 平台 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| QQ | ✅ **已预装** | 只需输入 AppID + AppSecret |
|
||
| 飞书 | ✅ 内置 | 企业首选 |
|
||
| Telegram | ✅ 内置 | 海外推荐 |
|
||
| 微信 | ✅ 社区插件 | iPad 协议 |
|
||
| Discord | ✅ 内置 | — |
|
||
| WhatsApp | ✅ 内置 | — |
|
||
|
||
### QQ 接入（1 分钟）
|
||
|
||
QQ 插件已预装！只需：
|
||
1. 访问 q.qq.com 创建机器人，获取 AppID 和 AppSecret
|
||
2. 双击 `Mac-Menu.command`，选 [3] QQ 机器人
|
||
3. 输入 AppID 和 AppSecret，完成
|
||
|
||
## 系统要求
|
||
|
||
- **macOS**: Apple Silicon (M1-M4), macOS 12+
|
||
- **Windows**: 10/11, 64-bit
|
||
- **内存**: 2GB+（推荐 4GB+）
|
||
- **存储**: 3GB+
|
||
|
||
## 升级
|
||
|
||
下载新版 `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
|
||
```
|
||
|
||
## 仓库结构
|
||
|
||
```
|
||
u-claw/
|
||
├── portable/ ← 脚本源码（打包进 U-Claw）
|
||
├── uclaw-scripts/ ← U 盘安装脚本
|
||
├── website/ ← 官网
|
||
├── docs/ ← 文档
|
||
└── README.md
|
||
```
|
||
|
||
## FAQ
|
||
|
||
**Q: 需要翻墙吗？**
|
||
安装不需要。运行需要联网调 AI API，国产模型无需翻墙。
|
||
|
||
**Q: 能分发吗？**
|
||
可以，MIT 协议，随便复制。
|
||
|
||
**Q: Windows 需要 WSL 吗？**
|
||
不需要，自带 Windows 版 Node.js。
|
||
|
||
## License
|
||
|
||
[MIT](LICENSE)
|
||
|
||
## 联系
|
||
|
||
- 微信: hecare888
|
||
- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)
|
||
- 官网: [u-claw.org](https://u-claw.org)
|
||
|
||
---
|
||
|
||
**Made with 🦞 by [dongsheng](https://github.com/dongsheng123132)**
|