# U-OpenClaw

**Repository Path**: LumeCode/uopenclaw

## Basic Information

- **Project Name**: U-OpenClaw
- **Description**: OpenClaw（小龙虾） 是一套可插拔 U 盘运行的 AI Agent 便携版，支持 Mac / Windows 四端免预装启动。内置 DeepSeek 默认模型、Web 控制台与国内 IM 通道插件，配置与会话随盘携带，开箱即可自检、启动与运维。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-26
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: openclaw, U盘小龙虾, u-openclaw, 小龙虾

## README

<h1 align="center">OpenClaw 小龙虾 · 多系统便携版</h1>

<p align="center">
  <img src="assets/logo.png" alt="OpenClaw 小龙虾 Logo" width="180"/>
</p>

<p align="center">
  <b>U-OpenClaw</b><br/>
  插上 U 盘即可用的本地 AI 助手发行包
</p>

<p align="center">
  <a href="https://gitee.com/LumeCode/uopenclaw">🏠 Gitee</a> ·
  <a href="https://mmsai.cn">🦞 MMS-AI 官网</a> ·
  <a href="LICENSE">📄 MIT License</a>
</p>

<p align="center">
  <img src="assets/poster.png" alt="U-OpenClaw 小龙虾宣传海报" width="860"/>
</p>

<p align="center">
  <img src="assets/icon-macos.png" alt="macOS" width="64"/>
  &nbsp;&nbsp;
  <img src="assets/icon-windows.png" alt="Windows" width="64"/>
</p>

## 这是什么

U-OpenClaw 是一套可放在 U 盘 / 便携目录里的 **OpenClaw** 运行环境，支持：

| 平台 | 架构 |
|------|------|
| macOS | Apple Silicon（arm64）、Intel（x64） |
| Windows | x64、ARM64 |

目标电脑 **无需预装** Node.js 或 OpenClaw。首次运行会校验离线包，并把当前平台环境释放到本机用户缓存；配置、密钥与会话仍保存在便携目录，可跨机携带。

> 开源仓库 **不含** 真实 API Key、网关 Token、设备私钥。首次「环境自检」会自动生成空白本地配置。

当前版本：**Node.js 22.22.3** · **OpenClaw 2026.7.1-2** · 默认模型按菜单 2 配置（DeepSeek / MMS-AI / 阿里云百炼）

## 新手三步上手

建议放到 **exFAT** 介质，便于 Mac / Windows 共用读写。

```bash
git clone https://gitee.com/LumeCode/uopenclaw.git
cd uopenclaw
```

| 步骤 | 做什么 | 菜单 |
|------|--------|------|
| ① | 双击启动入口 | Mac：`🍎 Mac版-小龙虾.command` · Windows：`🖥️ Windows版-小龙虾.cmd` |
| ② | 释放环境 + 生成空白配置 | **1. 环境自检** |
| ③ | 选 DeepSeek / **MMSAI** / **阿里云百炼**，填密钥（MMS 可网页登录授权） | **2. 配置默认模型** |
| ④ | 启动并打开控制台 | **3. 启动 OpenClaw** → **4. 打开 Web 控制台** |

改完模型后若服务已在跑，请用 **6. 重启 OpenClaw** 再对话。

图文教程：[模型配置教程](脚本与数据/文档/模型配置教程.md)（含 MMSAI / 阿里云百炼）

本机缓存（可删，下次自检会重建）：

| 系统 | 路径 |
|------|------|
| macOS | `~/Library/Caches/OpenClawUSB` |
| Windows | `%LOCALAPPDATA%\OpenClawUSB` |

**不要**在两台电脑上同时写入同一份便携数据。

## 菜单一览

菜单按 **日常 / 维护 / 更多** 分组；主界面会显示当前 Gateway 是否运行。

### 日常（建议：1 → 2 → 3 → 4）

| 序号 | 功能 |
|------|------|
| 1 | 环境自检（校验 / 释放 / 生成配置） |
| 2 | 配置默认模型（DeepSeek / MMSAI / 阿里云百炼） |
| 3 | 启动 OpenClaw |
| 4 | 打开 Web 控制台 |
| 5 | 停止 OpenClaw |
| 6 | 重启 OpenClaw（改模型后常用） |

### 维护

| 序号 | 功能 |
|------|------|
| 7 | 一键修复当前系统环境 |
| 8 | 版本升级 / 切换说明 |
| 9 | 安装 / 修复国内 IM 插件 |

### 更多

| 序号 | 功能 |
|------|------|
| 10 | 查看日志目录 |
| 11 | OpenClaw 命令行 |
| 12 | 备份配置与聊天数据 |
| 13 | 显示版本与路径信息 |
| 14 | 打开配置文件夹 |
| 15 | 开机自启动设置 |
| 16 | 帮助（常用 CLI 命令） |
| 17 | 进程检查 / 强杀端口（端口被占时用） |
| 18 | 打开官网（https://mmsai.cn） |
| 0 | 退出 |

## 遇到问题怎么办

| 现象 | 建议 |
|------|------|
| 首次打不开 / 缺环境 | 菜单 **1**；仍失败再 **7 一键修复** |
| 不会配模型 | 菜单 2 内「打开配置教程」，或看 [模型配置教程](脚本与数据/文档/模型配置教程.md) |
| 默认端口被占用 / 多个小龙虾 | 菜单 **17** 查看进程与端口，可强杀释放 **18789–18809** |
| 改完密钥控制台还是旧模型 | 菜单 **6 重启** |
| 想查官方命令 | 菜单 **16 帮助**，或菜单 **11** 进入命令行 |

**技术支持**：打开 [MMS AI 官网 https://mmsai.cn](https://mmsai.cn) 联系在线客服。

## 默认模型

- **出厂 / 空白配置**的默认模型仍是 **DeepSeek**：`deepseek/deepseek-v4-pro`（见 `openclaw.json.example`）。
- 菜单 **2** 配完哪家，默认模型就切到哪家（脚本自动 `GET /v1/models`）。

| 提供商 | 密钥变量 | 说明 |
|--------|----------|------|
| DeepSeek 官方 | `DEEPSEEK_API_KEY` | [platform.deepseek.com](https://platform.deepseek.com) |
| MMSAI 官方 | `MMS_API_KEY` | 固定官网 / API：`https://mmsai.cn`（支持网页登录授权自动回传密钥） |
| 阿里云百炼 | `DASHSCOPE_API_KEY` | [bailian.console.aliyun.com](https://bailian.console.aliyun.com/)；OpenAI 兼容，含 VL 看图 |

- 教程：[模型配置教程](脚本与数据/文档/模型配置教程.md)
- 一般无需改；临时换域名可用 `MMS_SITE_URL` / `MMS_API_BASE_URL` / `DASHSCOPE_API_BASE_URL` 覆盖

六个国内 IM 插件默认 **关闭**；说明见 [国内 IM 插件配置说明](脚本与数据/文档/国内IM插件配置说明.md)。

## 分卷安装包（Apple Silicon）

Gitee 单文件上限约 100MB。`node-v22.22.3-darwin-arm64.tar.gz`（约 103MB）在仓库中拆成：

```
脚本与数据/安装包/macOS/
  node-v22.22.3-darwin-arm64.tar.gz.part1
  node-v22.22.3-darwin-arm64.tar.gz.part2
```

环境自检时会自动合并、校验 SHA-256 再解压。详见 [安装包说明](脚本与数据/安装包/macOS/README.md)。

## 目录结构

```
.
├── 🍎 Mac版-小龙虾.command
├── 🖥️ Windows版-小龙虾.cmd
├── LICENSE / README.md
├── assets/                          # Logo、海报（英文路径，便于 Gitee 渲染）
└── 脚本与数据/
    ├── 安装包/                      # 四平台离线包 + SHA-256（含分卷）
    ├── 配置/
    │   ├── secrets.env.example      # 密钥模板（可提交）
    │   ├── openclaw.json.example    # 状态配置模板
    │   ├── openclaw.yml / runtime.* # 业务与版本基线
    │   └── …                        # secrets.env 本地生成，勿提交
    ├── 状态/                        # 运行时生成，勿提交密钥
    ├── 脚本/macOS|Windows|common/
    ├── 文档/
    ├── 日志/ · 缓存/ · 资源/
```

## 安全说明

请勿提交（已由 `.gitignore` 排除）：

| 路径 | 内容 |
|------|------|
| `脚本与数据/配置/secrets.env` | API Key / IM 凭据 |
| `脚本与数据/状态/openclaw.json` | 本地 gateway token |
| `脚本与数据/状态/identity/` | 设备密钥对 |
| `脚本与数据/状态/devices/` | 配对与 operator token |
| 日志、会话、npm 缓存 | 运行时数据 |

exFAT 无法设置 Unix `600` 权限，请妥善保管便携介质，并建议在服务商侧设置用量限额、定期轮换密钥。

## 文档

- [使用说明](脚本与数据/文档/使用说明.md) — 最短上手
- [模型配置教程](脚本与数据/文档/模型配置教程.md) — DeepSeek / MMS AI
- [多系统便携版使用说明](脚本与数据/文档/多系统便携版使用说明.md)
- [便携环境与修复说明](脚本与数据/文档/便携环境与修复说明.md)
- [国内 IM 插件配置说明](脚本与数据/文档/国内IM插件配置说明.md)
- [配置目录说明](脚本与数据/配置/README.md)

## 升级原则

升级 Node / OpenClaw 时，须同时更新 **四个平台** 离线包与对应 `SHA256SUMS.txt`。版本信息见 `脚本与数据/配置/build-info.yml`、`runtime.env`。

## 贡献

欢迎 Issue / PR。请勿附带密钥、会话日志或本机缓存。

## License

[MIT](LICENSE) © 2026 MrShanDev