# OpenClaw U盘版

**Repository Path**: Kuaima-tech/upanclaw

## Basic Information

- **Project Name**: OpenClaw U盘版
- **Description**: UpanClaw 是一个面向 U 盘便携场景的 OpenClaw 封装项目，适合做结构梳理、二次拆分、脚本维护和发布链路整理。最终构建产物：OpenClaw U盘版，无需安装任何依赖！将整个文件夹复制到 U 盘，插到任意 Windows 电脑上即可使用。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 便携版（U盘版）

UpanClaw 是一个面向 U 盘便携场景的 OpenClaw 封装项目，适合做结构梳理、二次拆分、脚本维护和发布链路整理。

它不是完整运行包，也不是一份开箱即用的开发环境。它的目标是把便携版真正有价值的项目结构和初始化逻辑单独保留下来，去掉大体积运行时和交付产物。


## 最终构建产物

**无需安装任何依赖！** 将整个文件夹复制到 U 盘，插到任意 Windows 电脑上即可使用：

- **零依赖** — 内置 Node.js 运行时，无需额外安装
- **零配置** — 首次启动自动初始化
- **零残留** — 所有数据存储在文件夹内，拔出 U 盘不留痕迹
- **随身携带** — 配置、聊天记录、技能全部随盘走

## 版本信息

| 项目               | 版本          |
| ---------------- | ----------- |
| Package Version  | 0.1.0       |
| OpenClaw Version | 2026.3.26   |
| Platform         | windows-x64 |
| Default Onboard  | portable-cn |

## 项目概要

这个项目当前主要分成 3 层：

- `launch\`
  PowerShell 公共逻辑和启动链路。这里负责初始化目录、检查运行时、首装配置、网关启停、插件同步、微信登录等。
- `windows\`
  给最终用户使用的 `.bat` 入口。它们本身很薄，主要是转调 `launch\` 里的 PowerShell 脚本。
- `app\`
  运行时相关内容。完整项目里这里会包含 Node 运行时、OpenClaw core、bundled 插件和便携启动 runner。

这份骨架当前保留了：

- `launch\`
- `windows\`
- `scripts\`
- `skills\`
- `app\portable-gateway-runner.cjs`
- `app\core\openclaw.mjs`
- `app\core\package.json`
- `app\bundled-extensions\openclaw-weixin\` 的源码和元数据

这份骨架当前不包含：

- `app\runtime\`
- `app\core\dist\`
- 真实运行时生成的 `data\` 内容
- panel 运行产物
- panel 源码

特别说明：

- `windows\准备环境.bat` 不会安装 npm、dotnet、pip 包。
- 它只是执行初始化检查，确认便携运行时是否完整，并同步 `skills`。
- 所以这份骨架更适合整理项目和提炼结构，不适合直接双击运行。

## 初始化步骤

如果你要基于这份骨架继续整理项目，建议按下面顺序理解和初始化：

1. 先看入口脚本\
   从 `windows\准备环境.bat`、`windows\启动网关.bat`、`windows\微信扫码授权.bat` 开始，先理解用户是怎么进入系统的。
2. 再看公共初始化\
   重点看 `launch\Setup-Portable.ps1` 和 `launch\Common.ps1`。\
   `Setup-Portable.ps1` 本身很薄，真正的初始化逻辑基本都在 `Common.ps1`。
3. 理解初始化会做什么\
   初始化主要包含：
   - 创建 `data\`、`data\.openclaw\`、`data\logs\`
   - 设置 `OPENCLAW_HOME`、`OPENCLAW_STATE_DIR` 等环境变量
   - 检查便携运行时是否完整
   - 同步 `skills`
   - 在配置文件已存在时，同步 bundled 插件并修复插件元数据
4. 明确运行时必需文件\
   `Common.ps1` 当前会检查这些关键路径：
   - `app\runtime\node.exe`
   - `app\portable-gateway-runner.cjs`
   - `app\core\openclaw.mjs`
   - `app\core\package.json`
   - `app\core\dist\`
5. 明确微信插件的最小结构\
   便携版当前依赖预置微信插件 `openclaw-weixin`。\
   运行时至少要有：
   - `app\bundled-extensions\openclaw-weixin\package.json`
   - `app\bundled-extensions\openclaw-weixin\openclaw.plugin.json`
   - `node_modules\zod`
   - `node_modules\qrcode-terminal`

## 使用须知

- 1、本项目仅用于学习用途，商用必须取得版权所有者的授权；
- 2、禁止将本项目的代码和资源进行任何形式的出售，产生的一切任何后果责任由侵权者自负。

## 联系方式

- 如果您想基于UpanClaw进行定制开发，我们提供有偿定制服务支持！
- 其他合作模式不限，欢迎来撩！联系微信客服：**huanglieabc** 专业解答！
- 联系邮箱：5984971@qq.com

## 联系邮箱
 UpanClaw 已构建好的完整版（即插即用版本）可以联系客服微信获取。

## 版权信息

- 本项目包含的第三方源码和二进制文件之版权信息另行标注。