zhenghy/u-claw
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
b076815171c2cbda2a0f17671688c47248169797
u-claw/install
History
zheng b076815171
Some checks failed
Tests / test (push) Has been cancelled
Details
feat: 海外化改造（新加坡市场）—— 阶段 0-3 
按 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 拆到私有仓库，无权限
2026-08-17 18:37:49 +08:00
..
install.ps1
feat: 海外化改造（新加坡市场）—— 阶段 0-3
2026-08-17 18:37:49 +08:00
install.sh
feat: 海外化改造（新加坡市场）—— 阶段 0-3
2026-08-17 18:37:49 +08:00
README.md
feat: 海外化改造（新加坡市场）—— 阶段 0-3
2026-08-17 18:37:49 +08:00

README.md

U-Claw 一键安装 / One-Line Install

一行命令安装 OpenClaw + 技能包 + 模型配置 One command to install OpenClaw + skills + model config

安装 / Install

Mac / Linux

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

Windows (PowerShell 管理员)

irm https://u-claw.org/install.ps1 | iex

本地运行

# 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 盘，直接从网络下载所有组件。