u-claw is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by dongsheng123132. U-Claw 虾盘 — OpenClaw AI 助手离线安装 U 盘：一键装好 Claude Code/Codex/OpenClaw，无需联网即插即用；新品 U-King AI 装机管家详见 u-king.org，另有远程支持与定制 AI 开发。. It has 1,756 GitHub stars.

Is u-claw safe to use?

Yes. u-claw passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install u-claw?

Clone the repository with "git clone https://github.com/dongsheng123132/u-claw" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is u-claw written in?

u-claw is primarily written in JavaScript. It is open-source under dongsheng123132 on GitHub, so you can review or fork the full source.

Are there alternatives to u-claw?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh u-claw against similar tools.

u-claw - AI Agents on GitHub (1.8k★)

Name: u-claw
Author: dongsheng123132

[!IMPORTANT] 这不是 U 盘制作工具。这个仓库就是 U 盘的文件骨架：运行一次 setup.sh 补齐运行时，再把整个 portable/ 拷到盘里即可。

[!TIP] AI 装电脑，U 盘管随身。 在 U 盘里直接跑完整 OpenClaw 很耗 IO（实测见装电脑还是放 U 盘）：长期用建议装电脑版；U 盘版只留给「换台电脑配置跟着走」和「不能装软件的电脑」。

三步开始

仅 Windows 使用时推荐 NTFS。 v2.3.0 加入 Windows exFAT 兼容：自动选择文件系统适配，配置与会话仍留在 U 盘。FAT32 不支持。Mac/Windows 共盘尚待 Mac 实机验收，不能把 Windows 原生运行时直接当作 Mac 运行时。格式化会清空盘内文件，操作前请备份。

📺 图文教程：docs/快速上手.md（含真实界面截图，5 步从插 U 盘到开始对话）

从 Releases 下载 Windows 便携版，解压到 U 盘后双击 Windows-Start.bat。
或克隆仓库，在 portable/ 运行 bash setup.sh，下载 Node.js 与 OpenClaw。
首次启动在本地配置模型 Key；配置只保存在 U 盘的 data/.openclaw/openclaw.json。

你得到什么	为什么重要
随身 AI 工作空间	换电脑时带走配置、记忆、会话与设备授权；仅可重建的浏览器缓存留在主机。
本地优先	不绑定设备、不打指纹、不上传本地配置。
多种使用方式	便携 U 盘、在线一键安装，两种方式各自独立。

平台支持：Windows ✅（免部署完整包）· macOS ✅ —— 详见下方平台支持表。

[!TIP]

👑 同作者新品：U-King · AI 装机管家

一键装好 Claude Code / Codex / OpenClaw / Hermes 四大 AI 神器，驱动自动配好——一个 Key 直用 Claude、GPT、DeepSeek、Kimi 等 24+ 全球模型，免翻墙。绿色版仅几 MB，双击即用，还带 AI 作图 / 视频 / 本地大模型 / 多终端工作台。

免费下载：www.u-king.org（国内镜像 cloud.u-claw.org/uking）

U-Claw 让 AI 住进 U 盘；U-King 帮你把全套 AI 编程神器装进电脑。 EN: U-King — one-click installer for Claude Code / Codex / OpenClaw, with one API key for 24+ global models → u-king.org

中文

这是什么

U-Claw（虾盘）是一个制作教程 + 全套源代码，教你把 OpenClaw（开源 AI 助手框架）做成 U 盘——插上任意电脑，双击就能用 AI。为什么叫虾盘？U-Claw = USB + Claw（虾钳），U 盘 + AI = 虾盘。

代码库本身就是 U 盘的文件骨架，运行 setup.sh 补齐大依赖后，整个 portable/ 目录直接拷贝到 U 盘即可。

📖 完整教程 — 从零开始的手工安装指南、模型配置、聊天平台接入，小白也能看懂。

🧩 模型随便选：国内外大模型都能用

U-Claw 是纯开源工具，不绑定设备、不打指纹、不上传任何数据。首次启动会自动打开「配置中心」，选一个模型、填入自己的 API Key（或一键领取虾盘云额度 / 充值）即可开始使用：

虾盘云（首选 · 中转站）：一个 Key 调用 DeepSeek / Claude / GPT / 通义等国内外全部大模型，无需翻墙。注册并充值：u-claw.org/cloud.html
各家官方 Key 也行：DeepSeek、通义千问、Kimi、智谱 GLM、豆包、MiniMax（国内）/ OpenAI、Claude、Groq（国外）/ 硅基流动、任意 OpenAI 兼容地址（自定义）
配置只存在本地 data/.openclaw/openclaw.json，拔盘不留痕

一键安装（推荐）

不需要 U 盘，一行命令直接装到电脑：

# Mac / Linux
curl -fsSL https://u-claw.org/install.sh | bash

# Windows (PowerShell 管理员)
irm https://u-claw.org/install.ps1 | iex

自动完成: Node.js 下载 → OpenClaw 安装 → 10 个中国技能 → 模型配置 → 启动脚本生成。全程国内镜像，无需翻墙。

详见 install/README.md。

装电脑还是放 U 盘？先看 IO

结论：AI 引擎（OpenClaw）装电脑，U 盘负责「随身」。

U 盘版的价值是「换台电脑，配置、钱包、会话、记忆跟着走」，而不是「把 AI 运行时塞进 U 盘」。完整便携包是约 620 MB、4.4 万个文件；把它放进 U 盘、每次插上启动，都要付出实打实的 IO 成本。同版本、同机器实测（2026-10-21，Windows 11 x64 / i9-12900H / USB 3.0 exFAT U 盘；单机单盘，不同 U 盘主控差异可能很大）：

对比项	装电脑（同一个包拷到本机 NVMe）	完整便携包放 U 盘	U 盘轻壳（方向）
占盘空间 / 文件数	620 MB / 4.4 万	620 MB / 4.4 万	约 9 MB / 几十个
投盘（复制/解压到盘上）	15 秒	实测 56 分钟（4.4 万个小文件）	约 7 秒
启动到可用	首次 168 秒；之后约 67 秒	首次 90 秒¹；之后 67~78 秒	0.1 秒
启动期间读盘	约 145 MB²	约 69 MB¹	约 0.1 MB
启动期间写盘	约 412 MB²	约 7 MB，首启后还要再写约 45 MB UI 资源¹	0 MB
启动后静置 1 分钟	背景噪声大，不可比²	首启 ≈ 61 / 40 MB；之后 < 2 MB	≈ 0
换台电脑再启动	—	再冷启动一次（本机缓存不随盘）	常驻，秒开
U 盘格式要求	—	NTFS 最佳；exFAT 可跑但更慢；FAT32 不支持	exFAT / FAT32 / NTFS 都行

¹ 冷启动「只读 69 MB」偏小：解压刚写完，Windows 文件缓存还热（本机 64 GB 内存）；重启或换台电脑拔插的冷读会明显更大（未测）。exFAT 上还实测到慢 SQLite 事务告警：启动单步 checkpoint 8.5 秒（正常阈值 1 秒）。 ² 本机盘是系统盘，读写计数含其它程序的背景 IO，只作量级参考。

注意：启动秒数两边都在一分钟上下——OpenClaw 本身就不轻，这不是 U 盘版的短板。U 盘版真正的代价是投盘要一小时、每次换电脑都要重新冷启动并读写 U 盘、exFAT 上的慢事务、以及 U 盘损耗；这些在轻壳上基本不存在（投盘 7 秒、启动 0.1 秒）。

为什么差这么多：

小文件随机 IO 是 U 盘的死穴。 这只 U 盘实测小文件创建约 43 个/秒（投盘并发时 13 个/秒）、顺序写约 7~13 MB/s；4.4 万个 node_modules 小文件投进去实测 56 分钟，同一份东西拷到本机 NVMe 只要 15 秒。
每次换电脑都要重新冷启动。 process.bootstrap（加载 OpenClaw 模块图）是启动的大头；热启动之所以能和本机 SSD 打平，是因为 V8 编译缓存、npm 缓存、日志、临时文件都搬到了本机盘——但换一台电脑，这些缓存不跟着走，冷启动要重来，首次还要再往 U 盘写约 45 MB UI 资源。
写入磨损与文件系统能力。 日志、SQLite、索引一直在写；exFAT 没有文件身份（inode）和符号链接，要靠兼容补丁绕，慢且能力受限（实测启动 SQLite 单步 8.5 秒）。U 盘是消耗品，别拿它当系统盘用。
通配性。 轻壳是一个几 MB 的原生程序：不装 Node、不建链接，所以 exFAT/FAT32/NTFS、任何盘符、Windows/macOS 都能直接开——这才是真正的「插哪台都能用」。完整包在 exFAT 上能跑但更慢，FAT32 直接不支持。

我们已经做的优化（完整便携包仍然有效）：把「可再生成」的东西搬出 U 盘——受管浏览器资料、V8 编译缓存、npm 缓存、临时文件都走本机盘（lib/portable-cache.mjs，Windows 在 %LOCALAPPDATA%\U-Claw），只有配置、会话、设备身份、钱包留在 U 盘随盘走。即便如此，运行时本体还是要从 U 盘读。

怎么选：

你的场景	建议
天天用、要快	装电脑版：`irm https://u-claw.org/install.ps1 \| iex`（macOS / Linux 用 `install.sh`）
多台电脑之间带着配置和钱包走	电脑装 OpenClaw，U 盘只带配置；或等 U 盘轻壳
别人的电脑上不能装任何东西	完整便携包放 U 盘（它就是为这个场景留的）
老电脑 / 慢 U 盘	别在 U 盘上跑 OpenClaw，装电脑版

U 盘轻壳（u-claw-lite，开发中）：U 盘里只放一个几 MB 的原生程序，提供一个本地页面管钱包、模型设置、会话入口和维护工具；电脑上装好 OpenClaw 后一键拉起。轻壳不内置 OpenClaw——所以「实在需要 OpenClaw」时，直接在电脑上装电脑版即可，不必从 U 盘引导。当前是预览阶段（只有 WebUI 与服务端动作，不含 OpenClaw 启动与钱包共享），落地后本仓 U 盘版会以它为主形态。

完整便携包不会删除：它是「免安装、可离线、救急」的形态，继续按现有方式发布。

快速开始：制作便携版 U 盘

# 1. 克隆代码
git clone https://github.com/dongsheng123132/u-claw.git

# 2. 补齐大依赖（Node.js + OpenClaw，国内镜像，约 1 分钟）
cd u-claw/portable && bash setup.sh

# 3. 拷贝到 U 盘
cp -R portable/ /Volumes/你的U盘/U-Claw/   # Mac
# 或 Windows 资源管理器直接拖过去

完成！ 插上 U 盘，双击启动脚本就能用。

同一支 U 盘同时只会启动一个 U-Claw 实例。重复双击会打开已运行的 Dashboard，不会另起端口或并发写入会话；如需重启，请先退出原启动窗口。

U 盘功能一览

功能	Mac	Windows
免安装运行	`Mac-Start.command`	`Windows-Start.bat`
功能菜单	`Mac-Menu.command`	`Windows-Menu.bat`
安装到电脑	`Mac-Install.command`	`Windows-Install.bat`
首次配置	首次启动自动打开「配置中心」	首次启动自动打开「配置中心」

U 盘文件结构

U-Claw/                          ← 整个拷到 U 盘
├── Mac-Start.command             Mac 免安装运行
├── Mac-Menu.command              Mac 功能菜单
├── Mac-Install.command           安装到 Mac
├── Windows-Start.bat             Windows 免安装运行
├── Windows-Menu.bat              Windows 功能菜单
├── Windows-Install.bat           安装到 Windows
├── setup.sh                      补齐依赖（开发者用）
├── app/                          ← 大依赖（setup.sh 下载，不进 git）
│   ├── core/                        OpenClaw + QQ 插件
│   └── runtime/
│       ├── node-mac-arm64/          Mac Apple Silicon
│       ├── node-mac-x64/           Mac Intel
│       └── node-win-x64/           Windows 64-bit
└── data/                         ← 用户数据（不进 git）
    ├── .openclaw/                   配置文件
    ├── memory/                      AI 记忆
    └── backups/                     备份

Linux 可启动版

Linux 可启动 U 盘套件已移出本仓库，在独立仓库 u-claw-linux 中维护。

关于桌面安装版（Electron）：Electron 桌面版（.exe 安装版 / 绿色版 / .dmg）已于 2026-06-19 停止发布，并已从仓库移除（见 tag archive/pre-scope-razor-2026-10-05）。U-Claw 现在只发布「便携 U 盘版」——这才是产品的本质：插上 U 盘、解压即用。

直接下载发行版

GitHub Releases 提供便携 U 盘版：

u-claw-portable-windows-vX.Y.Z.zip — Windows 便携完整版（已预装 Node + OpenClaw，解压到 U 盘双击 Windows-Start.bat 即用）
Mac：源码在 portable/ 目录，bash setup.sh 自动下载 Node + OpenClaw（国内镜像约 1 分钟），双击 Mac-Start.command 启动

仅 Windows 使用时推荐 NTFS。 v2.3.0 加入 Windows exFAT 兼容：自动选择文件系统适配，配置与会话仍留在 U 盘。FAT32 不支持。Mac/Windows 共盘尚待 Mac 实机验收，不能把 Windows 原生运行时直接当作 Mac 运行时。格式化会清空盘内文件，操作前请备份。

数据类型	存放位置
模型配置、钱包、SQLite 会话、工作区	U 盘 `data/.openclaw`
Node 编译缓存、受管浏览器用户目录	当前电脑本地缓存目录

浏览器网站登录状态不会自动随盘迁移，换电脑后需要重新登录。部分界面缓存和运行时依赖仍会读写 U 盘。Windows NTFS 与 exFAT 的隔离测试已完成真实对话和重启读回；exFAT 的目录监听会降级为轮询，部分插件技能链接不能创建，启动可能更慢。发布成品仍须单独验收，这不代表所有电脑或 Mac 共盘已通过。

支持的 AI 模型

国产模型（无需翻墙）：

模型	推荐场景
DeepSeek	编程首选，极便宜
Kimi K2.5	长文档，256K 上下文
通义千问 Qwen	免费额度大
智谱 GLM	学术场景
MiniMax	语音多模态
豆包 Doubao	火山引擎

国际模型： Claude · GPT · Gemini（需翻墙或中转）

支持的聊天平台

QQ、飞书、Telegram、WhatsApp、Discord 等聊天平台由 OpenClaw 自带的命令接入，配置中心不提供聊天平台入口。双击 OpenClaw-CLI.bat（Windows）/ Mac-OpenClaw-CLI.command（Mac）打开命令行，然后运行 openclaw channels add（添加）、openclaw channels login（登录 / 扫码）、openclaw channels status（查看状态）、openclaw channels remove（移除）。已有的 channels 配置在配置中心保存模型时会被保留。QQ 插件已随包预装；微信插件暂不可用（上游兼容问题，修复后随更新恢复）。

国内镜像

所有脚本默认走国内镜像，无需翻墙：

资源	镜像
npm 包	`registry.npmmirror.com`
Node.js	`npmmirror.com/mirrors/node`

开发 & 贡献

git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw/portable && bash setup.sh
bash Mac-Start.command   # Mac 测试

平台支持：

平台	状态	说明
Mac Apple Silicon (M1-M4)	✅	便携版
Mac Intel (x64)	✅	便携版
Windows x64	✅	便携版（含免部署完整包）

欢迎 PR！特别需要：教程翻译、文档完善。

🦞 寻找技术伙伴

U-Claw 是一个快速成长的开源项目，目前已有不少商业合作机会。

我们正在寻找：

技术伙伴 — 全栈 / Node.js / Electron / 脚本自动化
资源合作 — 渠道、内容、社区运营

如果你对 AI 工具的落地和商业化感兴趣，欢迎联系：

微信: hecare888
Telegram: @dsds8848
Twitter/X: @Bitplus888
Email: hefangsheng@gmail.com
GitHub: @dongsheng123132
官网: u-claw.org

FAQ

Q: 需要翻墙吗？ 不需要。安装和运行全程使用国内镜像，国产模型 API 直连。

Q: U 盘需要多大？ 4GB+ 就够（v2.3.x 完整包约 620 MB / 4.4 万个文件；早期全量包约 2.3 GB）。

u-claw

Compare with similar skills

Frequently Asked Questions

What is u-claw?