# U-Claw: An Open Source USB Drive That Carries Your AI Workspace

> U-Claw turns a USB stick into a portable AI assistant environment, bundling OpenClaw, Node.js, and your configuration into a folder you can carry between computers. The project is a file skeleton plus setup scripts, not a polished product, and its real value depends on how much you trust a single maintainer's mirror-heavy workflow.

**dongsheng123132/u-claw** — U-Claw: an offline installer USB drive for the OpenClaw AI assistant - one-click installs Claude Code, Codex and OpenClaw, plug-and-play with no internet needed. See u-king.org for the new U-King AI setup assistant; remote support and custom AI development also available.

- Repository: https://github.com/dongsheng123132/u-claw
- Website: https://www.u-claw.org/
- Stars: 1,757 · Forks: 417
- Language: JavaScript
- License: MIT
- Published: 2026-08-23 · Updated: 2026-08-23 · Language: en
- Canonical page: https://hysenlabs.com/projects/dongsheng123132-u-claw

## What U-Claw Actually Is

U-Claw, also called 虾盘, is not a USB creation tool. The repository is the file skeleton of a USB drive. You run setup.sh to download Node.js and OpenClaw, then copy the portable/ directory to a USB stick. The README stresses this distinction: the repo itself is the drive's content, not a program that makes drives. The project targets people who want a portable AI workspace, meaning they can plug the drive into any computer and have their configuration, memory, and sessions available without reinstalling anything. It is aimed at OpenClaw users, and the README mentions it bundles OpenClaw plus a QQ plugin. The primary language is JavaScript, and the license is MIT.

## How the Portable Workspace Is Structured

The portable/ directory contains startup scripts for Mac and Windows: Mac-Start.command, Windows-Start.bat, and menu and install variants. The app/ subdirectory holds the large dependencies, which setup.sh downloads and which are not tracked in git. Within app/, core/ contains OpenClaw and the QQ plugin, and runtime/ holds Node.js binaries for different architectures, such as node-mac-arm64. The configuration lives in data/.openclaw/openclaw.json on the USB drive. The README explains that browser caches and V8 compilation caches are written to the local machine to avoid slow IO on exFAT or FAT32, while the SQLite sessions, device identity, and authorization remain on the drive. This split is the key mechanism: high-frequency, rebuildable data goes to the host, and persistent state stays portable.

## Getting It Running: Commands and Requirements

There are two paths. The simplest is to download a Windows portable release from GitHub Releases, unzip it to a USB drive, and double-click Windows-Start.bat. The source path is: git clone, then cd u-claw/portable, then bash setup.sh. That script downloads Node.js and OpenClaw, reportedly in about a minute using Chinese mirrors. On Mac, you then double-click Mac-Start.command. The README also offers a one-line installer for Mac/Linux: curl -fsSL https://u-claw.org/install.sh | bash, and a PowerShell equivalent for Windows. The drive must be NTFS, not exFAT or FAT32, because Node.js performs poorly on exFAT and does not support symbolic links. The README includes a table from version v2.1.20 showing that exFAT can still work for basic gateway startup and conversation, but it recommends NTFS for reliability.

## Model and Chat Platform Support

The configuration page lets you pick a model and enter an API key. The README lists Chinese models like DeepSeek, Kimi K2.5, Qwen, Zhipu GLM, MiniMax, and Doubao, plus international ones like Claude, GPT, and Gemini, with a note that international models may require a VPN or a relay. There is also a promoted relay service called 虾盘云, which provides one key for multiple models. Chat platforms include QQ, Feishu, Telegram, WhatsApp, and Discord, with WeChat marked as temporarily unavailable due to an upstream plugin issue. The setup script reportedly installs ten Chinese skills automatically. This section is where the project's commercial angle appears: the README heavily promotes a paid cloud service and a sibling product, U-King, which is an installer for Claude Code, Codex, OpenClaw, and Hermes.

## The Linux Bootable Variant

Beyond the portable folder, the repository includes a bootable/ directory that creates a Linux USB drive based on Ventoy and Ubuntu 24.04 LTS with persistent storage. The README says you can run a four-step PowerShell script on Windows to create it. There is also a separate repository, u-claw-linux, that contains the same content. This variant targets computers that do not even have an operating system. The bootable module is independent of the portable module, so changes to one do not affect the other. This is a notable feature because it extends the portability concept to the entire OS, not just the AI tools. However, the README provides no details on how the AI assistant is integrated into that Ubuntu image, so you would need to inspect the bootable/ directory yourself.

## What Happened to the Desktop App and What That Signals

The README states that the Electron desktop version, u-claw-app, was deprecated on 2026-06-19 and archived. The reason is given in u-claw-app/DEPRECATED.md, but the README does not summarize it. The project now only publishes the portable USB drive version, which the author argues is the product's essence. This is a clear signal about maintenance priorities: the author is focused on the USB workflow, not on a traditional desktop application. It also means that if you expected a native app, you are out of luck. The deprecation is a limitation because it reduces the options for users who prefer an installed program over a portable folder.

## Limitations and Failure Modes

The most obvious limitation is the NTFS requirement. If you use a USB drive formatted as exFAT or FAT32, you may hit slow IO or startup failures due to missing symbolic link support. The README includes a workaround table, but it still recommends NTFS. Another failure mode is incomplete npm installs. The FAQ warns that setup.bat or setup.sh can fail with 'module not found' if the network drops during npm install, leaving node_modules incomplete. The suggested fix is to delete the incomplete node_modules and reinstall with a different registry. That is a manual, error-prone process. Also, the project depends on Chinese mirrors for downloads, which means users outside China might have slow or blocked access to those mirrors, although the README claims no VPN is needed for Chinese models. Finally, the README mentions that Windows x64 portable support is 'in development,' which means the Windows experience may not be as polished as the Mac one.

## Alternatives and How They Differ

The most direct alternative is to install OpenClaw directly on each machine without a USB drive. OpenClaw is the underlying framework, and U-Claw essentially packages it with Node.js and scripts. The difference is that a direct installation does not give you portability, but it avoids the NTFS constraint and the need to carry a drive. Another alternative is to use a cloud-based AI assistant or a remote development environment, where your configuration lives on a server and you access it from any device. That approach solves the portability problem without hardware, but it requires a network connection and may raise privacy concerns. U-Claw's local-first approach keeps data on the drive, which is a genuine trade-off: you get offline portability but you must manage the drive's filesystem and trust the bundled scripts.

## Maintenance and License Implications

The project is under the MIT license, so you can copy and redistribute it freely, as the FAQ confirms. The repository has recent releases, with v2.1.24 pushed on 2026-08-29, so the author is actively maintaining it. However, the maintenance is concentrated on the portable and bootable modules, not on the deprecated Electron app. The upgrade cost is moderate: you need to re-run setup.sh or download a new release to get updates, and you may need to reinstall node_modules if the network fails. The README does not describe an automated update mechanism, so you would manually check releases. The project also has a commercial side, with a paid cloud service and a sibling product, which means the open source part may serve as a funnel. That is worth considering if you prefer projects with a clear separation between community and commercial interests.

## Conclusion

Adopt U-Claw if you want a self-contained AI assistant workspace that you can carry on a USB stick, especially if you already use OpenClaw and want to avoid reinstalling it on every machine. Skip it if you need a stable, widely maintained tool with a large community, or if you cannot tolerate a project where the README points to a paid cloud service and a commercial sibling product. Before adopting, verify that the setup.sh script still works on your OS, that the NTFS requirement is acceptable for your USB drive, and that the bundled OpenClaw version matches the one you actually use.

## FAQ

### What is dongsheng123132/u-claw?

A portable AI workspace built on OpenClaw. The repository is the file skeleton of a USB stick: run `setup.sh` to fetch the runtime, then copy the whole `portable/` directory onto the drive, so that configuration, memory, and sessions travel between computers. It is MIT licensed.

### Do I need a USB stick to use u-claw?

No. There is a one-command install that runs `curl -fsSL https://u-claw.org/install.sh | bash` on Mac and Linux, or `irm https://u-claw.org/install.ps1 | iex` in PowerShell as administrator. That path handles the Node.js download, the OpenClaw install, ten China-region skills, model configuration, and a launch script.

### What filesystem should the u-claw USB stick use?

NTFS. The README warns against exFAT and FAT32 because Node.js is very slow on exFAT and symlinks are unsupported there. Its own version 2.1.20 comparison table shows gateway startup, chat, the V8 compile cache, and the Chromium profile all working on exFAT, with the cache redirected to the host machine.

### Which chat platforms does u-claw support?

QQ is preinstalled and needs an AppID and a Secret. Feishu, Telegram, WhatsApp over the Baileys protocol, and Discord are built in. WeChat is listed as temporarily unavailable because of an upstream plugin compatibility problem.

### Is the Electron desktop version of u-claw still available?

No. The Electron desktop build stopped being published and was archived on 2026-06-19, with the reason recorded in a file named DEPRECATED.md inside that directory. The project now publishes only the portable USB stick version.

## Sources

- [Official documentation](https://www.u-claw.org/)
- [Official README](https://github.com/dongsheng123132/u-claw#readme)
- [Project repository](https://github.com/dongsheng123132/u-claw)
- [Release notes](https://github.com/dongsheng123132/u-claw/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/dongsheng123132-u-claw