{"id":47188753,"url":"https://github.com/dongsheng123132/u-claw","last_synced_at":"2026-05-02T13:01:06.368Z","repository":{"id":343135042,"uuid":"1176414483","full_name":"dongsheng123132/u-claw","owner":"dongsheng123132","description":"🦞 U-Claw 虾盘 - OpenClaw AI 助手离线安装 U 盘 | 提供远程维护·定制开发·企业私有化部署服务 | Remote support \u0026 custom AI development","archived":false,"fork":false,"pushed_at":"2026-04-30T11:50:19.000Z","size":41676,"stargazers_count":1434,"open_issues_count":3,"forks_count":322,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-04-30T13:20:15.280Z","etag":null,"topics":["ai-assistant","china","deepseek","feishu","international","kimi","offline-ai","offline-installer","openclaw","plug-and-play","portable","qq-bot","usb","usb-portable","vietnam"],"latest_commit_sha":null,"homepage":"https://www.u-claw.org/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dongsheng123132.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T02:01:51.000Z","updated_at":"2026-04-30T12:32:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dongsheng123132/u-claw","commit_stats":null,"previous_names":["dongsheng123132/u-claw"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/dongsheng123132/u-claw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dongsheng123132%2Fu-claw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dongsheng123132%2Fu-claw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dongsheng123132%2Fu-claw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dongsheng123132%2Fu-claw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dongsheng123132","download_url":"https://codeload.github.com/dongsheng123132/u-claw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dongsheng123132%2Fu-claw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32534972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","china","deepseek","feishu","international","kimi","offline-ai","offline-installer","openclaw","plug-and-play","portable","qq-bot","usb","usb-portable","vietnam"],"created_at":"2026-03-13T10:12:21.622Z","updated_at":"2026-05-02T13:01:06.360Z","avatar_url":"https://github.com/dongsheng123132.png","language":"HTML","funding_links":[],"categories":["云部署方案","🚀 Deployment \u0026 Operations"],"sub_categories":["上下文管理"],"readme":"# 🦞 U-Claw（虾盘）\n\n\u003e **虾盘 — 全球首个 U 盘里运行的 AI 助手 | The world's first AI assistant that runs from a USB drive**\n\u003e **制作「插上就能用」的 AI 助手 U 盘 — 教程与源代码**\n\u003e **Build a plug-and-play AI assistant USB drive — Tutorial \u0026 Source Code**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[中文](#中文) | [English](#english) | [📖 完整教程](https://u-claw.org/tutorial.html)\n\n---\n\n\u003ca id=\"中文\"\u003e\u003c/a\u003e\n\n## 中文\n\n### 这是什么\n\nU-Claw（虾盘）是一个**制作教程 + 全套源代码**，教你把 [OpenClaw](https://github.com/openclaw/openclaw)（开源 AI 助手框架）做成 U 盘——插上任意电脑，双击就能用 AI。为什么叫虾盘？U-Claw = USB + Claw（虾钳），U 盘 + AI = 虾盘。\n\n代码库本身就是 U 盘的文件骨架，运行 `setup.sh` 补齐大依赖后，整个 `portable/` 目录直接拷贝到 U 盘即可。\n\n\u003e 📖 **[完整教程](https://u-claw.org/tutorial.html)** — 从零开始的手工安装指南、模型配置、聊天平台接入，小白也能看懂。\n\n### 🔗 内置虾盘云：开箱即用\n\n每个 U-Claw 实例首次启动会**自动**根据当前 U 盘 / 硬盘的指纹生成一个 `sk-...` 形式的虾盘云 apiKey，并写入 `data/.openclaw/openclaw.json`。打开 Config.html 就能看到这张「已绑定虾盘云」横幅（指纹来源、Key、余额）。\n\n- **不送 token**：余额初始为 0，需自行充值（[u-claw.org/cloud.html](https://u-claw.org/cloud.html)）\n- **指纹规则**：\n  - 从 U 盘根目录启动 → 绑定该 U 盘的硬件指纹（USB Serial + PNPDeviceID）\n  - 从硬盘启动（电脑安装版 / Electron App）→ 绑定主板 + 系统盘指纹\n  - Mac/Linux 走 Hardware UUID / `/etc/machine-id` + 启动盘 UUID\n- **换机 / 换盘**：换 U 盘或换电脑后，新的指纹会生成新的 Key；旧 Key 的余额仍归属原指纹（在 Config.html 点「解绑」可触发重新绑定）\n- **隐私**：指纹只用于本地生成 Key，不上传，无登录\n\n### 一键安装（推荐）\n\n不需要 U 盘，一行命令直接装到电脑：\n\n```bash\n# Mac / Linux\ncurl -fsSL https://u-claw.org/install.sh | bash\n\n# Windows (PowerShell 管理员)\nirm https://u-claw.org/install.ps1 | iex\n```\n\n自动完成: Node.js 下载 → OpenClaw 安装 → 10 个中国技能 → 模型配置 → 启动脚本生成。全程国内镜像，无需翻墙。\n\n详见 [`install/README.md`](install/README.md)。\n\n### 快速开始：制作便携版 U 盘\n\n```bash\n# 1. 克隆代码\ngit clone https://github.com/dongsheng123132/u-claw.git\n\n# 2. 补齐大依赖（Node.js + OpenClaw，国内镜像，约 1 分钟）\ncd u-claw/portable \u0026\u0026 bash setup.sh\n\n# 3. 拷贝到 U 盘\ncp -R portable/ /Volumes/你的U盘/U-Claw/   # Mac\n# 或 Windows 资源管理器直接拖过去\n```\n\n**完成！** 插上 U 盘，双击启动脚本就能用。\n\n### U 盘功能一览\n\n| 功能 | Mac | Windows |\n|------|-----|---------|\n| **免安装运行** | `Mac-Start.command` | `Windows-Start.bat` |\n| **功能菜单** | `Mac-Menu.command` | `Windows-Menu.bat` |\n| **安装到电脑** | `Mac-Install.command` | `Windows-Install.bat` |\n| **首次配置** | `Config.html` | `Config.html` |\n\n### U 盘文件结构\n\n```\nU-Claw/                          ← 整个拷到 U 盘\n├── Mac-Start.command             Mac 免安装运行\n├── Mac-Menu.command              Mac 功能菜单\n├── Mac-Install.command           安装到 Mac\n├── Windows-Start.bat             Windows 免安装运行\n├── Windows-Menu.bat              Windows 功能菜单\n├── Windows-Install.bat           安装到 Windows\n├── Config.html                   首次配置页面\n├── setup.sh                      补齐依赖（开发者用）\n├── app/                          ← 大依赖（setup.sh 下载，不进 git）\n│   ├── core/                        OpenClaw + QQ 插件\n│   └── runtime/\n│       ├── node-mac-arm64/          Mac Apple Silicon\n│       ├── node-mac-x64/           Mac Intel\n│       └── node-win-x64/           Windows 64-bit\n└── data/                         ← 用户数据（不进 git）\n    ├── .openclaw/                   配置文件\n    ├── memory/                      AI 记忆\n    └── backups/                     备份\n```\n\n### Linux 可启动版\n\n连操作系统都没有？没关系。可启动版可以让任意电脑从 U 盘直接启动 Ubuntu + AI：\n\n- 本仓库内：[`bootable/`](bootable/) 目录（与其他模块完全独立，互不影响）\n- 独立仓库：[u-claw-linux](https://github.com/dongsheng123132/u-claw-linux)（内容一致，方便单独克隆）\n\n基于 Ventoy + Ubuntu 24.04 LTS + 持久化存储，在 Windows 上运行 4 步 PowerShell 脚本即可制作。详见 [`bootable/README.md`](bootable/README.md)。\n\n### 桌面安装版（Electron App）\n\n除了 U 盘便携版，还有桌面 App 版本：\n\n```bash\ncd u-claw-app\nbash setup.sh            # 一键安装开发环境（国内镜像）\nnpm run dev              # 开发模式运行\nnpm run build:mac-arm64  # 打包 → release/*.dmg\nnpm run build:win        # 打包 → release/*.exe\n```\n\n### 直接下载发行版\n\n[GitHub Releases](https://github.com/dongsheng123132/u-claw/releases) 提供四种打包好的产物：\n\n- `u-claw-portable-windows-vX.Y.Z.zip` — Windows 便携版（解压即用）\n- `u-claw-portable-mac-vX.Y.Z.zip` — Mac 便携版\n- `U-Claw Setup vX.Y.Z.exe` — Windows 桌面安装包\n- `U-Claw-vX.Y.Z-arm64.dmg` — Mac 桌面安装包\n\n\u003e ⚠️ 安装包未签名：\n\u003e - **Windows**：双击 `.exe` 时 SmartScreen 会拦，点「更多信息」→「仍要运行」\n\u003e - **Mac**：首次启动如被 Gatekeeper 拦，执行 `xattr -rd com.apple.quarantine /Applications/U-Claw.app` 或在 Finder 里右键→打开\n\n### 支持的 AI 模型\n\n**国产模型（无需翻墙）：**\n\n| 模型 | 推荐场景 |\n|------|----------|\n| DeepSeek | 编程首选，极便宜 |\n| Kimi K2.5 | 长文档，256K 上下文 |\n| 通义千问 Qwen | 免费额度大 |\n| 智谱 GLM | 学术场景 |\n| MiniMax | 语音多模态 |\n| 豆包 Doubao | 火山引擎 |\n\n**国际模型：** Claude · GPT · Gemini（需翻墙或中转）\n\n### 支持的聊天平台\n\n| 平台 | 状态 | 说明 |\n|------|------|------|\n| QQ | ✅ 已预装 | 输入 AppID + Secret 即可 |\n| 飞书 | ✅ 内置 | 企业首选 |\n| Telegram | ✅ 内置 | 海外推荐 |\n| WhatsApp | ✅ 内置 | Baileys 协议 |\n| Discord | ✅ 内置 | — |\n| 微信 | ✅ 社区插件 | iPad 协议 |\n\n### 国内镜像\n\n所有脚本默认走国内镜像，无需翻墙：\n\n| 资源 | 镜像 |\n|------|------|\n| npm 包 | `registry.npmmirror.com` |\n| Node.js | `npmmirror.com/mirrors/node` |\n| Electron | `npmmirror.com/mirrors/electron` |\n\n### 开发 \u0026 贡献\n\n```bash\ngit clone https://github.com/dongsheng123132/u-claw.git\ncd u-claw/portable \u0026\u0026 bash setup.sh\nbash Mac-Start.command   # Mac 测试\n```\n\n**平台支持：**\n\n| 平台 | 状态 | 说明 |\n|------|------|------|\n| Mac Apple Silicon (M1-M4) | ✅ | 便携版 + 桌面版 |\n| Mac Intel (x64) | ✅ | 便携版 + 桌面版 |\n| Windows x64 | 🚧 开发中 | 便携版 + 桌面版 |\n| Linux x64（可启动 U 盘） | ✅ | [`bootable/`](bootable/) 目录 |\n\n欢迎 PR！特别需要：Windows 脚本完善、教程翻译。\n\n### 🦞 寻找技术伙伴\n\nU-Claw 是一个快速成长的开源项目，目前已有不少商业合作机会。\n\n我们正在寻找：\n- **技术伙伴** — 全栈 / Node.js / Electron / 脚本自动化\n- **资源合作** — 渠道、内容、社区运营\n\n如果你对 AI 工具的落地和商业化感兴趣，欢迎联系：\n\n- 微信: hecare888\n- Telegram: [@dsds8848](https://t.me/dsds8848)\n- Twitter/X: [@Bitplus888](https://x.com/Bitplus888)\n- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com)\n- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)\n- 官网: [u-claw.org](https://u-claw.org)\n\n### FAQ\n\n**Q: 需要翻墙吗？**\n不需要。安装和运行全程使用国内镜像，国产模型 API 直连。\n\n**Q: U 盘需要多大？**\n4GB+（完整约 2.3GB）。\n\n**Q: 能分发吗？**\nMIT 协议，随便复制分发。\n\n**Q: Mac 提示\"未验证的开发者\"？**\n右键脚本 → 打开。\n\n**Q: setup.bat / setup.sh 执行失败，提示模块找不到？**\n通常是 npm install 过程中网络中断导致 `node_modules` 不完整。解决步骤：\n1. 删除不完整的依赖：`rmdir /s /q portable\\app\\core\\node_modules`（Windows）或 `rm -rf portable/app/core/node_modules`（Mac）\n2. 切换淘宝镜像重新安装：`cd portable/app/core \u0026\u0026 npm install --registry=https://registry.npmmirror.com`\n\n**Q: 系统已有 Node.js v24，安装失败？**\nNode.js v24 是最新开发版，部分依赖尚不兼容。需要 **v20 或 v22 LTS**。删除已下载的 runtime 目录后重新运行 setup，它会自动下载内置的 Node v22：\n```bash\n# Windows\nrmdir /s /q portable\\app\\runtime\\node-win-x64\nsetup.bat\n\n# Mac\nrm -rf portable/app/runtime/node-mac-arm64\nbash setup.sh\n```\n\n**Q: Mac 上提示 `.toSorted is not a function`？**\n系统旧版 Node.js 被检测到并跳过了内置版本下载，但旧版 Node 不支持 `.toSorted()`（需要 v20+）。删除 runtime 目录让脚本重新下载内置 Node v22：\n```bash\nrm -rf portable/app/runtime/node-mac-arm64\nbash setup.sh\n```\n\n**Q: 如何同时配置多个 AI 模型并切换？**\n支持同时配置多个 provider！打开 `Config.html` → 在 Providers 区域点击「添加」，逐个填入各模型的 API Key 和地址（如 DeepSeek、Kimi、通义等）→ 保存后，在聊天界面左上角下拉菜单随时切换。配置持久保存在 U 盘上。\n\n**Q: U 盘安装后无法创建文件 / 写入失败？**\n两种可能：① U 盘侧面有物理写保护开关，拨到解锁位置；② U 盘格式不兼容，建议格式化为 **exFAT**（Mac/Windows/Linux 三端均支持读写）。\n\n**Q: 从 Ubuntu 向 U 盘复制时符号链接丢失？**\n`node_modules/.bin/` 下有大量符号链接，FAT32/exFAT 在直接 `cp -R` 时会跳过。用 `rsync -aL` 可将符号链接展开为真实文件：\n```bash\nrsync -aL --progress portable/ /media/YOUR_USB/U-Claw/\n```\n\n**Q: QQbot 报错 `Unknown channel: qqbot`？**\nBundle 里的 `@sliverp/qqbot` 是未编译的 TypeScript 源码，需要先编译：\n```bash\ncd portable/app/core/node_modules/@sliverp/qqbot\nnpm install \u0026\u0026 npm run build\n```\n正式 Release 包已修复此问题，建议从 [Releases](https://github.com/dongsheng123132/u-claw/releases) 下载最新版。\n\n### 联系 \u0026 合作\n\n\u003cimg src=\"assets/wechat-qr.jpg\" width=\"220\" alt=\"微信二维码 — 贺去病 ai 工作室\" align=\"right\" /\u003e\n\n- 微信: hecare888（或扫右侧二维码）\n- Telegram: [@dsds8848](https://t.me/dsds8848)\n- Twitter/X: [@Bitplus888](https://x.com/Bitplus888)\n- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com)\n- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)\n- 官网: [u-claw.org](https://u-claw.org)\n\n**🤝 招募代理 / 带货合作**\n\n虾盘 3.0 体验极佳，退货率极低，售后由我们负责——你只管卖货：\n\n- **抖店 / 直播带货**：提供最高佣金比例，产品已在多个直播间验证转化\n- **代理分销**：买断或按单分润均可谈，支持定制版本\n- **技术合作**：有开发能力者欢迎深度合作\n\n有意向请微信联系（备注「代理合作」优先处理）。\n\n---\n\n\u003ca id=\"english\"\u003e\u003c/a\u003e\n\n## English\n\n### What is this\n\nU-Claw (aka \"虾盘\" / \"Xia Pan\" in Chinese, meaning \"Claw Drive\") is a **tutorial + complete source code** for building an [OpenClaw](https://github.com/openclaw/openclaw) (open-source AI assistant framework) USB drive — plug it into any computer, double-click, and start using AI.\n\nThe codebase itself is the USB file skeleton. Run `setup.sh` to download large dependencies, then copy the entire `portable/` directory to a USB drive.\n\n\u003e 📖 **[Full Tutorial](https://u-claw.org/tutorial.html)** — Step-by-step manual installation, model setup, chat platform integration.\n\n### One-Line Install (Recommended)\n\nNo USB needed — install directly to your computer:\n\n```bash\n# Mac / Linux\ncurl -fsSL https://u-claw.org/install.sh | bash\n\n# Windows (PowerShell as Admin)\nirm https://u-claw.org/install.ps1 | iex\n```\n\nAutomatically downloads Node.js, installs OpenClaw, configures 10 Chinese-optimized skills, and sets up your AI model. All downloads use China mirrors.\n\nSee [`install/README.md`](install/README.md) for details.\n\n### Quick Start: Build a Portable USB\n\n```bash\n# 1. Clone\ngit clone https://github.com/dongsheng123132/u-claw.git\n\n# 2. Download dependencies (Node.js + OpenClaw, ~1 min)\ncd u-claw/portable \u0026\u0026 bash setup.sh\n\n# 3. Copy to USB drive\ncp -R portable/ /Volumes/YOUR_USB/U-Claw/   # Mac\n# Or drag \u0026 drop on Windows\n```\n\n**Done!** Plug in the USB, double-click the start script, and you're running AI.\n\n### USB Features\n\n| Feature | Mac | Windows |\n|---------|-----|---------|\n| **Run (no install)** | `Mac-Start.command` | `Windows-Start.bat` |\n| **Menu** | `Mac-Menu.command` | `Windows-Menu.bat` |\n| **Install to PC** | `Mac-Install.command` | `Windows-Install.bat` |\n| **First-time config** | `Config.html` | `Config.html` |\n\n### File Structure\n\n```\nU-Claw/                          ← Copy entire folder to USB\n├── Mac-Start.command             Mac launcher\n├── Mac-Menu.command              Mac menu\n├── Mac-Install.command           Install to Mac\n├── Windows-Start.bat             Windows launcher\n├── Windows-Menu.bat              Windows menu\n├── Windows-Install.bat           Install to Windows\n├── Config.html                   First-time config page\n├── setup.sh                      Download dependencies (dev use)\n├── app/                          ← Large deps (downloaded by setup.sh, not in git)\n│   ├── core/                        OpenClaw + QQ plugin\n│   └── runtime/\n│       ├── node-mac-arm64/          Mac Apple Silicon\n│       ├── node-mac-x64/           Mac Intel\n│       └── node-win-x64/           Windows 64-bit\n└── data/                         ← User data (not in git)\n    ├── .openclaw/                   Config file\n    ├── memory/                      AI memory\n    └── backups/                     Backups\n```\n\n### Linux Bootable USB\n\nNo operating system? No problem. Boot any computer from USB into Ubuntu + AI:\n\n- In this repo: [`bootable/`](bootable/) directory (fully independent from other modules)\n- Standalone repo: [u-claw-linux](https://github.com/dongsheng123132/u-claw-linux) (same content, easier to clone separately)\n\nBased on Ventoy + Ubuntu 24.04 LTS + persistence. 4-step PowerShell scripts on Windows. See [`bootable/README.md`](bootable/README.md) for details.\n\n### Desktop App (Electron)\n\n```bash\ncd u-claw-app\nbash setup.sh            # One-click dev setup (China mirrors)\nnpm run dev              # Dev mode\nnpm run build:mac-arm64  # Build → release/*.dmg\nnpm run build:win        # Build → release/*.exe\n```\n\n### Supported AI Models\n\n**Chinese models (no VPN needed):**\n\n| Model | Best for |\n|-------|----------|\n| DeepSeek | Coding, extremely cheap |\n| Kimi K2.5 | Long documents, 256K context |\n| Qwen | Large free tier |\n| GLM (Zhipu) | Academic use |\n| MiniMax | Voice \u0026 multimodal |\n| Doubao | Volcengine ecosystem |\n\n**International models:** Claude · GPT · Gemini (VPN or relay required in China)\n\n### Supported Chat Platforms\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| QQ | ✅ Pre-installed | Enter AppID + Secret |\n| Feishu (Lark) | ✅ Built-in | Enterprise favorite |\n| Telegram | ✅ Built-in | International |\n| WhatsApp | ✅ Built-in | Baileys protocol |\n| Discord | ✅ Built-in | — |\n| WeChat | ✅ Community plugin | iPad protocol |\n\n### China Mirrors\n\nAll scripts use China mirrors by default — no VPN needed:\n\n| Resource | Mirror |\n|----------|--------|\n| npm packages | `registry.npmmirror.com` |\n| Node.js | `npmmirror.com/mirrors/node` |\n| Electron | `npmmirror.com/mirrors/electron` |\n\n### Development \u0026 Contributing\n\n```bash\ngit clone https://github.com/dongsheng123132/u-claw.git\ncd u-claw/portable \u0026\u0026 bash setup.sh\nbash Mac-Start.command   # Test on Mac\n```\n\n**Platform Support:**\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| Mac Apple Silicon (M1-M4) | ✅ | Portable + Desktop |\n| Mac Intel (x64) | ✅ | Portable + Desktop |\n| Windows x64 | 🚧 In progress | Portable + Desktop |\n| Linux x64 (Bootable USB) | ✅ | [`bootable/`](bootable/) directory |\n\nPRs welcome! Especially: Windows scripts, documentation.\n\n### 🔧 Professional Services / 专业服务\n\nNeed help? We offer remote support and custom development:\n\n| Service | Description | Price |\n|---------|-------------|-------|\n| **Remote Installation** | We remotely install OpenClaw + skills + model config for you | Free |\n| **Troubleshooting** | Startup failures, port conflicts, network issues | From ¥50 |\n| **Model Tuning** | API key setup, model switching, prompt optimization | From ¥50 |\n| **Custom Development** | Custom skills, enterprise private deployment, QQ/WeChat/Feishu bot integration | From ¥200 |\n| **USB Green Edition** | Pre-built portable USB with your custom skills \u0026 models | From ¥100 |\n\n**One-click remote support** — run one command, we connect and fix it:\n\n```bash\n# Mac / Linux\ncurl -fsSL https://u-claw.org/remote.sh | bash\n\n# Windows (Admin PowerShell)\nirm https://u-claw.org/remote.ps1 | iex\n```\n\nWeChat: **hecare888** (备注「U-Claw 远程」优先处理)\n\n👉 [View full service details / 查看完整服务详情](https://u-claw.org/guide.html#remote-support)\n\n### 🦞 Looking for Partners\n\nU-Claw is a fast-growing open-source project with real commercial opportunities.\n\nWe're looking for:\n- **Technical partners** — Full-stack / Node.js / Electron / scripting\n- **Resource partners** — Distribution, content, community\n\nIf you're interested in AI tooling and commercialization, let's talk:\n\n- Telegram: [@dsds8848](https://t.me/dsds8848)\n- Twitter/X: [@Bitplus888](https://x.com/Bitplus888)\n- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com)\n- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)\n- WeChat: hecare888\n- Website: [u-claw.org](https://u-claw.org)\n\n### FAQ\n\n**Q: Do I need a VPN?**\nNo. All downloads use China mirrors. Chinese AI model APIs work directly.\n\n**Q: How big should the USB drive be?**\n4GB+ (~2.3GB full).\n\n**Q: Can I redistribute?**\nMIT license — copy and share freely.\n\n**Q: Mac says \"unverified developer\"?**\nRight-click the script → Open.\n\n**Q: setup.bat / setup.sh fails with \"module not found\"?**\nUsually caused by a network interruption during `npm install`, leaving `node_modules` incomplete. Fix:\n1. Delete incomplete dependencies: `rmdir /s /q portable\\app\\core\\node_modules` (Windows) or `rm -rf portable/app/core/node_modules` (Mac)\n2. Reinstall using China mirror: `cd portable/app/core \u0026\u0026 npm install --registry=https://registry.npmmirror.com`\n\n**Q: Already have Node.js v24 and installation fails?**\nNode.js v24 is a dev release — some dependencies aren't compatible yet. You need **v20 or v22 LTS**. Delete the runtime folder to force a fresh download of the bundled Node v22:\n```bash\n# Windows\nrmdir /s /q portable\\app\\runtime\\node-win-x64\nsetup.bat\n\n# Mac\nrm -rf portable/app/runtime/node-mac-arm64\nbash setup.sh\n```\n\n**Q: Mac shows `.toSorted is not a function`?**\nYour system Node.js was detected and the bundled version was skipped, but the system version is too old (needs v20+). Delete the runtime folder to re-download the bundled Node v22:\n```bash\nrm -rf portable/app/runtime/node-mac-arm64\nbash setup.sh\n```\n\n**Q: How do I use multiple AI models / providers?**\nMultiple providers are supported! Open `Config.html` → click \"Add\" in the Providers section → enter API Key and endpoint for each model (DeepSeek, Kimi, Qwen, etc.) → save. Switch between models via the dropdown in the chat interface. Config is saved persistently on the USB drive.\n\n**Q: USB drive shows \"cannot create file\" / write errors?**\nTwo possibilities: ① The USB drive has a physical write-protect switch on the side — slide it to unlock; ② Format incompatibility — format the drive as **exFAT** (supported on Mac/Windows/Linux).\n\n**Q: Symlinks missing when copying from Ubuntu to USB?**\n`node_modules/.bin/` contains many symlinks that get skipped during direct `cp -R`. Use `rsync -aL` to expand symlinks into real files:\n```bash\nrsync -aL --progress portable/ /media/YOUR_USB/U-Claw/\n```\n\n**Q: QQbot error: `Unknown channel: qqbot`?**\nThe bundled `@sliverp/qqbot` is uncompiled TypeScript source. Compile it manually:\n```bash\ncd portable/app/core/node_modules/@sliverp/qqbot\nnpm install \u0026\u0026 npm run build\n```\nThis is fixed in the latest [Release](https://github.com/dongsheng123132/u-claw/releases) — downloading the pre-built release is recommended.\n\n### Contact \u0026 Partnership\n\n\u003cimg src=\"assets/wechat-qr.jpg\" width=\"220\" alt=\"WeChat QR — He Qubing AI Studio\" align=\"right\" /\u003e\n\n- WeChat: hecare888 (or scan QR on the right)\n- Telegram: [@dsds8848](https://t.me/dsds8848)\n- Twitter/X: [@Bitplus888](https://x.com/Bitplus888)\n- Email: [hefangsheng@gmail.com](mailto:hefangsheng@gmail.com)\n- GitHub: [@dongsheng123132](https://github.com/dongsheng123132)\n- Website: [u-claw.org](https://u-claw.org)\n\n**🤝 Reseller / Affiliate Program**\n\nU-Claw 3.0 delivers excellent user experience with very low return rates. We handle all after-sales support — you focus on selling:\n\n- **Live commerce / TikTok shop**: Top commission rates, proven conversion in live streams\n- **Reseller / distribution**: Revenue share or wholesale, custom branded versions available\n- **Technical partnership**: Deep collaboration welcome for developers\n\nInterested? WeChat hecare888 (mention \"partnership\" for priority response).\n\n---\n\n**Made with 🦞 by [贺去病 ai 工作室](https://github.com/dongsheng123132)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdongsheng123132%2Fu-claw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdongsheng123132%2Fu-claw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdongsheng123132%2Fu-claw/lists"}