🦞 Z-Claw 虾整

📌 简介 📌 Introduction

Z-Claw 是 OpenClaw AI 助手的离线安装 U 盘。就像当年的雨林木风，把 AI 助手的安装简化到"插 U 盘，双击运行"。 Node.js + OpenClaw + 所有依赖 + 52个技能，全部打包。插上 U 盘，双击即用。

Z-Claw is the OpenClaw AI assistant offline installer USB drive. Like legendary YuLinMuFeng Windows discs, but for AI. Node.js runtime, OpenClaw source, all npm dependencies, 52 pre-installed skills — everything bundled on a USB drive. Plug in, double-click, done.

❓ 为什么需要 Z-Claw？ ❓ Why Z-Claw?

OpenClaw 是最强的开源 AI 助手框架，但在中国安装它是个噩梦：

OpenClaw is the most powerful open-source AI assistant framework, but installing it in China is a nightmare:

• ❌ GitHub 访问不了GitHub blocked
• ❌ npm install 超时npm install timeout
• ❌ Node.js 下载慢Node.js download slow
• ❌ 依赖装不上Dependencies fail

Z-Claw 解决所有这些问题。

Z-Claw solves all of this.

✨ 特性 ✨ Features

🚀 快速开始 🚀 Quick Start

选项 1: 下载发布版（推荐） Option 1: Download Release (Recommended)

从 Releases 下载：

Download from Releases:

https://github.com/ClearZhu/u-claw/releases

解压后：

After extracting:

• Mac: 双击 "Mac-从U盘启动.command"Mac: double-click "Mac-从U盘启动.command"
• Linux: bash ./Linux-从U盘启动.shLinux: bash ./Linux-从U盘启动.sh"
• Win: 双击 "Windows-从U盘启动.bat"Win: double-click "Windows-从U盘启动.bat"

选项 2: 自己构建 Option 2: Build Your Own

# 克隆仓库 / Clone this repo
git clone https://github.com/ClearZhu/u-claw.git
cd u-claw

# 下载 OpenClaw 源码 / Download OpenClaw source
git clone https://github.com/openclaw/openclaw.git openclaw-2026.3.7

# 构建（自动下载 Node.js + 安装依赖 + 构建）
# Build (downloads Node.js + installs deps + builds)
chmod +x build-uclaw.sh
./build-uclaw.sh

# 把 U-Claw/ 文件夹复制到 U 盘
# Copy U-Claw/ folder to USB drive

选项 3: 复制别人的 Option 3: Copy from a Friend

直接把 U-Claw/ 文件夹复制一份就行。

Just copy of U-Claw/ folder. That's it.

📁 U 盘内容 📁 USB Contents

U-Claw/ (~1.3GB, 8GB USB minimum)

U-Claw/
├── Mac-从U盘启动.command             ← macOS: run from USB
├── Windows-从U盘启动.bat            ← Windows: run from USB
├── Linux-从U盘启动.sh               ← Linux: 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-linux-x64/             ← Linux x64
│   └── 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

🎮 启动菜单 🎮 Launcher Menu

17 个功能，灵感来自雨林木风安装界面：

17 functions, inspired by YuLinMuFeng installer UI:

═════════════════════════════════════════════════════════
═════════════════════════════════════════════════════════
     🦞  Z-Claw 虾整 v1.1
     🦞  Z-Claw v1.1
     专为中国打造 · 离线 · 一键
     Optimized for China · Offline · One-click
═════════════════════════════════════════════════════════
═════════════════════════════════════════════════════════

  ━━ 安装 ━━━━ Install ━━
  [1] 从 U 盘运行Run from USB           [2] 安装到电脑Install to computer
  [3] 系统信息System info            [4] OpenClaw 状态OpenClaw status

  ━━ 中国优化 ━━━━ China Optimization ━━
  [5] 设置向导（模型/平台/API Key）Setup wizard (model/platform/API Key)
  [6] 聊天平台（QQ/飞书/微信）Chat platforms (QQ/Feishu/WeChat)
  [7] 管理通道Manage channels

  ━━ 维护 ━━━━ Maintenance ━━
  [8] 诊断与修复Diagnose & repair      [9] 更新 OpenClawUpdate OpenClaw
  [10] 技能Skills   [11] 工具 (MCP)Tools (MCP)   [12] 插件Plugins

  ━━ 技能与使用 ━━━━ Skills & Usage ━━
  [13] 浏览技能市场Browse skills market  [14] 中国用户指南China user guide
  [15] 使用说明Instructions          [16] 关于About
  [17] 打开网页控制台Open web dashboard
        

🤖 支持的 AI 模型 🤖 Supported AI Models

国产模型（无需翻墙） Chinese Models (no VPN needed)

国际模型International Models

💬 支持的聊天平台 💬 Supported Chat Platforms

QQ 接入（1 分钟） span class="en hidden">QQ Setup (1 minute)

腾讯官方支持：

Tencent officially supports:

# 1. 注册 / Register:
# http://q.qq.com/qqbot/openclaw/login.html
# 2. 创建机器人，获取 AppID:AppSecret / Create bot, get AppID:AppSecret

# 3. 运行3条命令 / Run 3 commands:
openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart

# 4. 设置白名单！ / Set allowlist!
openclaw config set channels.qqbot.allowFrom "your_qq_number"

⚙️ 系统要求 ⚙️ System Requirements

• macOS: 12+ (Intel or Apple Silicon)
• Linux: x64 with glibc and bash
• 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 build script does

• 下载 4 个平台的 Node.js 22（Mac ARM64 + Mac x64 + Linux x64 + Win x64），优先使用中国镜像Downloads Node.js 22 for 4 platforms (Mac ARM64 + Mac x64 + Linux x64 + Win x64), prefers China mirror
• 复制 OpenClaw 源码到 U-Claw/openclaw/Copies OpenClaw source to U-Claw/openclaw/
• 安装 pnpm 并使用中国镜像（registry.npmmirror.com）运行 pnpm installInstalls pnpm and runs pnpm install with China mirror (registry.npmmirror.com)
• 运行 pnpm build 构建 OpenClawRuns pnpm build to build OpenClaw
• 复制启动脚本和文档Copies launcher scripts and docs

输出Output: ~1.3GB 可直接复制到 U 盘ready to copy to USB

🔄 更新🔄 Updating

# 下载新的 OpenClaw 源码，替换 openclaw-2026.3.7/
# Download new OpenClaw source, replace openclaw-2026.3.7/
./build-uclaw.sh

# 复制新的 U-Claw/ 到 U 盘
# Copy new U-Claw/ to USB

🤝 参与贡献🤝 Contributing

欢迎 PR！特别需要：

PRs welcome! Especially needed:

• 🔧 更多平台修复脚本More platform repair scripts
• 📖 教程和指南Tutorials and guides
• 💬 更多聊天桥接（企业微信、钉钉）More chat bridges (WeCom, DingTalk)
• 🎯 实用技能Useful skills
• 🌐 翻译Translations

# Fork → Branch → Commit → PR
git checkout -b feature/my-feature
git commit -m "feat: add xxx"
git push origin feature/my-feature

🔗 相关项目🔗 Related Projects

❓ 常见问题 ❓ FAQ