zheng
b076815171
Some checks failed
Tests / test (push) Has been cancelled
按 U-Claw-海外化改造方案.md 与 范围决策记录.md 实施。这是 fork，不回上游： 海外版删掉的正是上游的中国市场默认值。 阶段 0 地基 - 下载源全部改国际：脚本/CI 61 处 + lockfile 880 条 npmmirror URL 归零 （lockfile 那 880 条是 npm 的 resolved 字段，脚本层参数化根本绕不过它） - 移除 install.ps1 里三个第三方 GitHub 加速代理，bundle 改直连 + SHA256 校验 （原来只检查"文件大于 1MB"就解压运行） - 技能内容与分发分离：skills/manifest.json 单一来源，install.sh 1170→658 行、 install.ps1 721→546 行，两者技能内容归零 实测原来是三份不一致：skills-cn 完整、install.sh 约 40%、install.ps1 约 17%， 且 7 个通用技能只有 U 盘版有 —— 一键安装的用户一个能用的技能都没有 - Node 版本三种（v22.14/16/22.1）统一，新建 NODE_VERSION 单一来源 - Config 页三份合一。portable/Config.html 用根相对路径调 API 却只从 file:// 打开， 保存功能已静默失效两个月；现缩为 120 行重定向壳 - 测试接入 CI（此前 node --test 无人运行，所有断言形同虚设） 阶段 1 双语可用 - 浏览器侧 i18n：JSON 为源、生成经典 script（file:// 下 fetch 本地 JSON 被拦） 语言跟盘走不跟机器走：启动器写 data/.openclaw/locale.js - 8 处硬编码 lang="zh-CN" 归零，data-i18n 覆盖 213 处，词条 en/zh 各 279 条 - B3 单框 Key：12 张模型卡 → 一个输入框，前缀识别 provider， 服务端 /api/test-key 发 1-token 请求实测，错误映射成人话 Key 填错到得知：从"直到对话失败"降到 ≤1 秒 - 区域格式 SG：DD/MM/YYYY、12 小时、S$、Asia/Singapore （ICU 在 en-SG 下把 SGD 渲染成裸 $，与美元无法区分，故自行拼 S$） - README 内容分叉而非翻译，§1.3 证据清单逐条清零 阶段 2 降门槛 - 启动逻辑上移 lib/start.mjs：Windows-Start.bat 220→28 行、 Mac-Start.command 235→33 行 修掉 Mac 侧两个 bug：控制台端口硬编码 18788（回落时打开死页）、 微信插件从未在 Mac 上安装 - U 盘根目录 23 → 3 个可点文件，其余进 advanced/ - 首启向导：语言 → 用途（7 角色，manifest 驱动）→ 密钥，答过不再问 - 三档界面，Simple 档隐藏一切技术名词 - 自动自愈：启动失败先自查自修，修不好导出脱敏诊断包 （Doctor 从"用户要知道去点的工具"变成后台机制） 阶段 3 技能库 - 19 个英文技能，planned 归零。sg-weather / sg-transport 的端点均实测过 - SkillHub 从 56 张手写第三方卡片改为 manifest 生成：703→125 行，中文归零 其他 - origin.json 收拢所有运行时地址，tests/origin.test.mjs 保证迁移不会漏 - portable/ 下用户可见中文归零（由断言保证） - 82 项测试 未验证（本机无 Windows / 无 pwsh）： - install.ps1、setup.ps1 约 210 行改动从未经 PowerShell 解析器 - 完整启动路径仅在假 node + 假 openclaw 上冒烟 - 8 个 .bat 的盘根推导仅静态断言 详见 U盘实测清单.md 受阻： - 隐藏黑窗口 —— 需代码签名证书（.vbs 已被 Windows 弃用，替代方案都要签名） - 场景卡 —— OpenClaw 上游 Dashboard 无预填 prompt 接口 - 官网 36 条 —— 上游 2026-04-14 拆到私有仓库，无权限
133 lines
3.7 KiB
Markdown
133 lines
3.7 KiB
Markdown
# U-Claw 一键安装 / One-Line Install
|
||
|
||
> 一行命令安装 OpenClaw + 技能包 + 模型配置
|
||
> One command to install OpenClaw + skills + model config
|
||
|
||
## 安装 / Install
|
||
|
||
### Mac / Linux
|
||
|
||
```bash
|
||
curl -fsSL https://u-claw.org/install.sh | bash
|
||
```
|
||
|
||
### Windows (PowerShell 管理员)
|
||
|
||
```powershell
|
||
irm https://u-claw.org/install.ps1 | iex
|
||
```
|
||
|
||
### 本地运行
|
||
|
||
```bash
|
||
# Mac/Linux
|
||
bash install/install.sh
|
||
|
||
# Windows
|
||
powershell -ExecutionPolicy Bypass -File install\install.ps1
|
||
```
|
||
|
||
## 安装流程
|
||
|
||
### Mac / Linux（7 步）
|
||
|
||
| 步骤 | 内容 | 说明 |
|
||
|------|------|------|
|
||
| 1 | Node.js v22 | 安装到 `~/.uclaw/runtime/`，系统有 v20+ 则复用 |
|
||
| 2 | OpenClaw | npm 安装到 `~/.uclaw/core/` |
|
||
| 3 | QQ 插件 | 非致命，失败不影响主功能 |
|
||
| 4 | 10 个中国技能 | 小红书、B站、微博等内容创作技能 |
|
||
| 5 | 模型配置 | 中文交互菜单，默认 DeepSeek |
|
||
| 6 | 启动脚本 | 生成 start.command (Mac) / start.sh (Linux) |
|
||
| 7 | 验证 | 检查各组件安装状态 |
|
||
|
||
### Windows（6 步）
|
||
|
||
| 步骤 | 内容 | 说明 |
|
||
|------|------|------|
|
||
| 1 | Node.js v22 | 下载到 `%USERPROFILE%\.uclaw\runtime\`，系统有 v20+ 则复用 |
|
||
| 2 | OpenClaw + QQ 插件 | 下载预打包 bundle，走国内镜像 |
|
||
| 3 | 10 个中国技能 | 小红书、B站、微博等内容创作技能 |
|
||
| 4 | 模型配置 | 交互菜单，默认 DeepSeek |
|
||
| 5 | 启动脚本 | 生成 start.bat |
|
||
| 6 | 验证 | 检查各组件安装状态 |
|
||
|
||
## 支持的 AI 模型
|
||
|
||
### 国内（无需翻墙）
|
||
|
||
| 编号 | 模型 | 说明 |
|
||
|------|------|------|
|
||
| 1 | DeepSeek | ⭐ 推荐，性价比最高 |
|
||
| 2 | Kimi/月之暗面 | 长文档 |
|
||
| 3 | 通义千问 | 有免费额度 |
|
||
| 4 | 智谱GLM | 学术场景 |
|
||
| 5 | MiniMax | 多模态 |
|
||
| 6 | 豆包 | 火山引擎 |
|
||
| 7 | 硅基流动 | 聚合多模型 |
|
||
|
||
### 海外
|
||
|
||
| 编号 | 模型 |
|
||
|------|------|
|
||
| 8 | Claude |
|
||
| 9 | GPT |
|
||
|
||
### 本地
|
||
|
||
| 编号 | 模型 |
|
||
|------|------|
|
||
| 10 | Ollama |
|
||
|
||
## 安装目录结构
|
||
|
||
```
|
||
~/.uclaw/
|
||
├── runtime/node-{platform}/ # Node.js v22
|
||
├── core/ # OpenClaw + QQ 插件
|
||
│ ├── package.json
|
||
│ └── node_modules/
|
||
│ └── openclaw/skills/ ← 技能在这里
|
||
├── data/
|
||
│ ├── .openclaw/openclaw.json ← 模型配置
|
||
│ ├── memory/ ← AI 记忆
|
||
│ └── backups/ ← 备份
|
||
├── start.command (Mac) ← 启动脚本
|
||
└── start.bat (Windows) ← 启动脚本
|
||
```
|
||
|
||
## 技术细节
|
||
|
||
- **Node.js**: 只装到 `~/.uclaw/runtime/`，不动系统 Node；系统已有 v20+ 则复用
|
||
- **下载源**: Node 二进制走 `nodejs.org`，npm 包走 `registry.npmjs.org`；Windows bundle 直连 GitHub Releases
|
||
- **Windows 编码**: `chcp 65001` + UTF8 输出确保中文显示
|
||
- **管道模式**: `curl | bash` 时自动跳过交互，使用默认配置
|
||
- **卸载**: `rm -rf ~/.uclaw` (Mac/Linux) 或删除 `%USERPROFILE%\.uclaw` (Windows)
|
||
|
||
## 包含技能
|
||
|
||
| 技能 | 用途 |
|
||
|------|------|
|
||
| xiaohongshu-writer | 小红书笔记写作 |
|
||
| bilibili-helper | B站视频优化 |
|
||
| weibo-poster | 微博内容创作 |
|
||
| wechat-article | 微信公众号文章 |
|
||
| zhihu-writer | 知乎回答/文章 |
|
||
| douyin-script | 抖音短视频脚本 |
|
||
| china-search | 国内搜索引擎 |
|
||
| china-translate | 中英互译 |
|
||
| china-weather | 天气查询 |
|
||
| deepseek-helper | DeepSeek API 助手 |
|
||
|
||
## 与其他分发形式的关系
|
||
|
||
```
|
||
install/ ← 一键在线安装（本模块）
|
||
portable/ ← U 盘便携版
|
||
u-claw-app/ ← Electron 桌面版
|
||
bootable/ ← Linux 可启动 U 盘
|
||
```
|
||
|
||
install/ 安装的结果与 portable/ 的 Mac-Install.command 相同，
|
||
区别是不需要 U 盘，直接从网络下载所有组件。
|