夜雨聆风自制 U-Claw 虾盘教程
从零开始打包你自己的 OpenClaw 离线安装盘
🦞 为什么要自制虾盘？
U-Claw 虾盘的核心价值是「离线安装包」，把 OpenClaw 的全部依赖打包好，让国内用户直接就能安装。
如果你有动手能力，完全可以自己制作：
• 完全免费 — 不需要购买任何硬件
• 自由定制 — 选择你想预装的技能和模型
• 随时更新 — 自己控制版本和依赖
• 分享给朋友 — MIT 协议允许自由分发
📋 准备工作
你需要：
• 一台能访问 GitHub 的电脑
• Node.js 18+ 环境
• 至少 4GB 可用磁盘空间
• 一个 U 盘（推荐 8GB+，USB 3.0）
• 耐心（首次打包约 30-60 分钟）
步骤一：下载 OpenClaw 源码
1. 克隆官方仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
2. 切换到稳定版本
git checkout v2.1.0 # 或其他稳定版本
💡 提示：如果 GitHub 访问困难，可以使用 Gitee 镜像或代理下载。
步骤二：安装依赖
1. 安装 Node.js 依赖
npm install
# 或 yarn install
2. 构建项目
npm run build
⚠️ 注意：npm install 可能需要 10-30 分钟，取决于网络速度。如果卡住，可以尝试切换 npm 镜像源。
步骤三：下载常用技能
OpenClaw 的技能是独立的，需要单独下载。以下是推荐的技能清单：
# 创建 skills 目录
mkdir -p skills
cd skills
# 下载常用技能
git clone https://github.com/openclaw/skills-qqbot.git
git clone https://github.com/openclaw/skills-wechat.git
git clone https://github.com/openclaw/skills-email.git
git clone https://github.com/openclaw/skills-pdf.git
git clone https://github.com/openclaw/skills-github.git
# ... 根据需要添加更多
推荐预装的 10 个核心技能：
1. qqbot — QQ 机器人
2. wechat — 微信机器人
3. email — 邮件收发
4. pdf — PDF 处理
5. github — GitHub 操作
6. weather — 天气查询
7. news — 新闻摘要
8. schedule — 日程管理
9. translate — 翻译
10. image — AI 绘图
步骤四：制作启动菜单
创建启动脚本，让用户可以一键安装：
Mac/Linux 版本（启动菜单.sh）
#!/bin/bash
echo "U-Claw 启动菜单"
echo "1) 一键安装 OpenClaw"
echo "2) 修复安装"
echo "3) 备份配置"
echo "4) 退出"
read -p "请选择: " choice
case $choice in
1) ./install.sh ;;
2) ./repair.sh ;;
3) ./backup.sh ;;
4) exit ;;
esac
Windows 版本（启动菜单.bat）
@echo off
echo U-Claw 启动菜单
echo [1] 一键安装 OpenClaw
echo [2] 修复安装
echo [3] 备份配置
echo [4] 退出
set /p choice=请选择:
if "%choice%"=="1" goto install
if "%choice%"=="2" goto repair
if "%choice%"=="3" goto backup
if "%choice%"=="4" exit
:install
call install.bat
goto end
步骤五：打包到 U 盘
1. 准备 U 盘
• 格式化 U 盘为 exFAT（Mac/Win 通用）
• 确保有至少 2GB 可用空间
2. 复制文件
# 创建 U-Claw 目录结构
U-Claw/
├── openclaw/ # 主程序
├── skills/ # 技能包
├── models/ # 本地模型（可选）
├── install.sh # Mac/Linux 安装脚本
├── install.bat # Windows 安装脚本
├── 启动菜单.sh # Mac/Linux 启动菜单
3. 编写安装脚本
#!/bin/bash<br># install.sh<br>echo "正在安装 OpenClaw..."<br>cp -r ./openclaw ~/openclaw<br>cp -r ./skills ~/openclaw/skills<br>echo 'export PATH="$HOME/openclaw/bin:$PATH"' >> ~/.bashrc<br>echo "安装完成！请重启终端或运行 source ~/.bashrc"
步骤六：测试和优化
1. 在干净环境测试
• 找一台没有 OpenClaw 的电脑
• 插入 U 盘，运行启动菜单
• 检查安装是否顺利
2. 常见问题修复
• Node.js 版本不兼容 → 内置 Node 或使用 nvm
• 权限问题 → 添加 chmod +x 脚本
• 路径问题 → 使用绝对路径
3. 添加国产模型配置
创建预设配置文件，方便用户一键启用国产模型：
# config/china-models.yaml
models:
- name: deepseek
provider: deepseek-ai
api_key: "YOUR_API_KEY"
- name: kimi
provider: moonshot
api_key: "YOUR_API_KEY"
🚀 进阶技巧
制作多系统启动盘
使用 Ventoy 工具，一个 U 盘支持 Windows/Mac/Linux 三系统安装
添加本地模型（离线运行）
下载 Ollama + 本地模型（如 Llama 3、Qwen），实现完全离线使用
自动更新机制
编写检查更新脚本，连接 Gitee 镜像源获取最新版本
✅ 总结
自制 U-Claw 虾盘的核心流程：
1️⃣ 下载 OpenClaw 源码
2️⃣ 安装依赖并构建
3️⃣ 下载常用技能
4️⃣ 制作启动菜单和安装脚本
5️⃣ 打包到 U 盘
6️⃣ 测试和优化
完成后，你就拥有了一个完全自制的 OpenClaw 离线安装盘！可以自用，也可以分享给朋友。
💡 提示：U-Claw 采用 MIT 开源协议，允许自由分发和修改。如果你制作了更好的版本，欢迎分享给社区！
📖 OpenClaw 官方文档：https://docs.openclaw.ai | 🦞 U-Claw 官网：https://www.u-claw.org
