按 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 拆到私有仓库，无权限
This commit is contained in:
295
portable/advanced/setup.ps1
Normal file
295
portable/advanced/setup.ps1
Normal file
@@ -0,0 +1,295 @@
|
||||
param(
|
||||
[switch]$AllPlatforms
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$scriptDir = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path)
|
||||
$appDir = Join-Path $scriptDir "app"
|
||||
$coreDir = Join-Path $appDir "core"
|
||||
$runtimeDir = Join-Path $appDir "runtime"
|
||||
|
||||
$mirror = "https://registry.npmjs.org"
|
||||
$nodeMirror = "https://nodejs.org/dist"
|
||||
$nodeVersion = "v22.22.1"
|
||||
|
||||
function Write-Step {
|
||||
param(
|
||||
[string]$Symbol,
|
||||
[string]$Message,
|
||||
[string]$Color = "Gray"
|
||||
)
|
||||
|
||||
Write-Host (" {0} {1}" -f $Symbol, $Message) -ForegroundColor $Color
|
||||
}
|
||||
|
||||
function Ensure-Directory {
|
||||
param(
|
||||
[string]$Path
|
||||
)
|
||||
|
||||
if (-not (Test-Path -Path $Path -PathType Container)) {
|
||||
New-Item -ItemType Directory -Path $Path -Force | Out-Null
|
||||
}
|
||||
}
|
||||
|
||||
function Download-File {
|
||||
param(
|
||||
[string]$Url,
|
||||
[string]$Destination
|
||||
)
|
||||
|
||||
Invoke-WebRequest -Uri $Url -OutFile $Destination
|
||||
}
|
||||
|
||||
function Install-WindowsNode {
|
||||
param(
|
||||
[string]$TargetDir
|
||||
)
|
||||
|
||||
$nodeExe = Join-Path $TargetDir "node.exe"
|
||||
if (Test-Path -Path $nodeExe -PathType Leaf) {
|
||||
Write-Step "OK" "Node.js (win-x64) already exists, skipping download." "Green"
|
||||
return
|
||||
}
|
||||
|
||||
Write-Step "->" "Downloading Node.js $nodeVersion (win-x64)..." "Cyan"
|
||||
Ensure-Directory -Path $TargetDir
|
||||
|
||||
$zipName = "node-$nodeVersion-win-x64.zip"
|
||||
$nodeUrl = "$nodeMirror/$nodeVersion/$zipName"
|
||||
$tempZip = Join-Path $env:TEMP $zipName
|
||||
$extractRoot = Join-Path $env:TEMP "uclaw-node-win-x64"
|
||||
$extractDir = Join-Path $extractRoot "node-$nodeVersion-win-x64"
|
||||
|
||||
Write-Host " $nodeUrl"
|
||||
Download-File -Url $nodeUrl -Destination $tempZip
|
||||
|
||||
if (Test-Path -Path $extractRoot) {
|
||||
Remove-Item -Path $extractRoot -Recurse -Force
|
||||
}
|
||||
|
||||
Expand-Archive -Path $tempZip -DestinationPath $extractRoot -Force
|
||||
Copy-Item -Path (Join-Path $extractDir "*") -Destination $TargetDir -Recurse -Force
|
||||
|
||||
Remove-Item -Path $tempZip -Force -ErrorAction SilentlyContinue
|
||||
Remove-Item -Path $extractRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||
|
||||
if (Test-Path -Path $nodeExe -PathType Leaf) {
|
||||
Write-Step "OK" "Node.js (win-x64) download completed." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "ERR" "Node.js (win-x64) download failed." "Red"
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
function Install-TarNodeRuntime {
|
||||
param(
|
||||
[string]$Platform,
|
||||
[string]$NodeDirName
|
||||
)
|
||||
|
||||
$targetDir = Join-Path $runtimeDir $NodeDirName
|
||||
$nodeBinary = Join-Path $targetDir "bin/node"
|
||||
if (Test-Path -Path $nodeBinary -PathType Leaf) {
|
||||
Write-Step "OK" "Node.js ($Platform) already exists, skipping download." "Green"
|
||||
return
|
||||
}
|
||||
|
||||
$tarExe = Get-Command tar.exe -ErrorAction SilentlyContinue
|
||||
if (-not $tarExe) {
|
||||
Write-Step "WARN" "tar.exe was not found, skipping $Platform runtime." "Yellow"
|
||||
return
|
||||
}
|
||||
|
||||
Write-Step "->" "Downloading Node.js $nodeVersion ($Platform)..." "Cyan"
|
||||
Ensure-Directory -Path $targetDir
|
||||
|
||||
$archiveName = "node-$nodeVersion-$Platform.tar.gz"
|
||||
$nodeUrl = "$nodeMirror/$nodeVersion/$archiveName"
|
||||
$tempArchive = Join-Path $env:TEMP $archiveName
|
||||
$extractRoot = Join-Path $env:TEMP ("uclaw-{0}" -f $NodeDirName)
|
||||
$extractDir = Join-Path $extractRoot "node-$nodeVersion-$Platform"
|
||||
|
||||
Write-Host " $nodeUrl"
|
||||
Download-File -Url $nodeUrl -Destination $tempArchive
|
||||
|
||||
if (Test-Path -Path $extractRoot) {
|
||||
Remove-Item -Path $extractRoot -Recurse -Force
|
||||
}
|
||||
|
||||
Ensure-Directory -Path $extractRoot
|
||||
& $tarExe.Path -xzf $tempArchive -C $extractRoot
|
||||
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Step "WARN" "$Platform runtime extraction failed, skipping it." "Yellow"
|
||||
Remove-Item -Path $tempArchive -Force -ErrorAction SilentlyContinue
|
||||
Remove-Item -Path $extractRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||
return
|
||||
}
|
||||
|
||||
Copy-Item -Path (Join-Path $extractDir "*") -Destination $targetDir -Recurse -Force
|
||||
Remove-Item -Path $tempArchive -Force -ErrorAction SilentlyContinue
|
||||
Remove-Item -Path $extractRoot -Recurse -Force -ErrorAction SilentlyContinue
|
||||
|
||||
if (Test-Path -Path $nodeBinary -PathType Leaf) {
|
||||
Write-Step "OK" "Node.js ($Platform) download completed." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "WARN" "$Platform runtime download failed, but Windows setup can continue." "Yellow"
|
||||
}
|
||||
}
|
||||
|
||||
function Ensure-QQPluginBuild {
|
||||
param(
|
||||
[string]$CoreDir,
|
||||
[string]$NpmCmd
|
||||
)
|
||||
|
||||
$qqDir = Join-Path $CoreDir "node_modules\@sliverp\qqbot"
|
||||
if (-not (Test-Path -Path $qqDir -PathType Container)) {
|
||||
return
|
||||
}
|
||||
|
||||
$distIndex = Join-Path $qqDir "dist\index.js"
|
||||
if (-not (Test-Path -Path $distIndex -PathType Leaf)) {
|
||||
Write-Step "->" "Building QQ plugin runtime files..." "Cyan"
|
||||
Push-Location $qqDir
|
||||
try {
|
||||
& $NpmCmd install --include=dev --registry=$mirror
|
||||
& $NpmCmd run build
|
||||
& $NpmCmd prune --omit=dev
|
||||
}
|
||||
catch {
|
||||
Write-Step "WARN" "QQ plugin build command failed; continuing setup." "Yellow"
|
||||
}
|
||||
finally {
|
||||
Pop-Location
|
||||
}
|
||||
}
|
||||
|
||||
$nestedOpenClaw = Join-Path $qqDir "node_modules\openclaw"
|
||||
if (Test-Path -Path $nestedOpenClaw -PathType Container) {
|
||||
Remove-Item -Path $nestedOpenClaw -Recurse -Force -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
if (Test-Path -Path $distIndex -PathType Leaf) {
|
||||
Write-Step "OK" "QQ plugin runtime files are ready." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "WARN" "QQ plugin is installed but dist/index.js is missing." "Yellow"
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "========================================" -ForegroundColor Cyan
|
||||
Write-Host " U-Claw Portable Setup" -ForegroundColor Cyan
|
||||
Write-Host "========================================" -ForegroundColor Cyan
|
||||
Write-Host ""
|
||||
Write-Host (" System: {0}" -f [System.Runtime.InteropServices.RuntimeInformation]::OSDescription) -ForegroundColor Green
|
||||
Write-Host ""
|
||||
|
||||
Ensure-Directory -Path $appDir
|
||||
Ensure-Directory -Path $coreDir
|
||||
Ensure-Directory -Path $runtimeDir
|
||||
|
||||
$windowsNodeTarget = Join-Path $runtimeDir "node-win-x64"
|
||||
Install-WindowsNode -TargetDir $windowsNodeTarget
|
||||
|
||||
if ($AllPlatforms) {
|
||||
Install-TarNodeRuntime -Platform "darwin-arm64" -NodeDirName "node-mac-arm64"
|
||||
Install-TarNodeRuntime -Platform "darwin-x64" -NodeDirName "node-mac-x64"
|
||||
}
|
||||
|
||||
$packageJsonPath = Join-Path $coreDir "package.json"
|
||||
if (-not (Test-Path -Path $packageJsonPath -PathType Leaf)) {
|
||||
$openclawVersionFile = Join-Path $PSScriptRoot "OPENCLAW_VERSION"
|
||||
if (-not (Test-Path -Path $openclawVersionFile -PathType Leaf)) {
|
||||
$openclawVersionFile = Join-Path $PSScriptRoot "..\OPENCLAW_VERSION"
|
||||
}
|
||||
$openclawVersion = "2026.4.29"
|
||||
if (Test-Path -Path $openclawVersionFile -PathType Leaf) {
|
||||
$openclawVersion = (Get-Content -Path $openclawVersionFile -Raw).Trim()
|
||||
}
|
||||
$packageJson = @"
|
||||
{
|
||||
"name": "u-claw-core",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"dependencies": {
|
||||
"openclaw": "$openclawVersion"
|
||||
}
|
||||
}
|
||||
"@
|
||||
$packageJson | Out-File -FilePath $packageJsonPath -Encoding utf8
|
||||
}
|
||||
|
||||
$npmCmd = Join-Path $windowsNodeTarget "npm.cmd"
|
||||
|
||||
if (Test-Path -Path (Join-Path $coreDir "node_modules\openclaw") -PathType Container) {
|
||||
Write-Step "OK" "OpenClaw is already installed, skipping." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "->" "Installing OpenClaw..." "Cyan"
|
||||
Push-Location $coreDir
|
||||
try {
|
||||
& $npmCmd install --prefix $coreDir --registry=$mirror
|
||||
}
|
||||
finally {
|
||||
Pop-Location
|
||||
}
|
||||
|
||||
if (Test-Path -Path (Join-Path $coreDir "node_modules\openclaw") -PathType Container) {
|
||||
Write-Step "OK" "OpenClaw installation completed." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "ERR" "OpenClaw installation failed." "Red"
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
if (Test-Path -Path (Join-Path $coreDir "node_modules\@sliverp\qqbot") -PathType Container) {
|
||||
Write-Step "OK" "QQ plugin is already installed, skipping." "Green"
|
||||
}
|
||||
else {
|
||||
Write-Step "->" "Installing QQ plugin..." "Cyan"
|
||||
Push-Location $coreDir
|
||||
try {
|
||||
& $npmCmd install "@sliverp/qqbot@latest" --prefix $coreDir --registry=$mirror 2>$null
|
||||
}
|
||||
catch {
|
||||
}
|
||||
finally {
|
||||
Pop-Location
|
||||
}
|
||||
Write-Step "OK" "QQ plugin installation finished." "Green"
|
||||
}
|
||||
|
||||
Ensure-QQPluginBuild -CoreDir $coreDir -NpmCmd $npmCmd
|
||||
|
||||
# Skills: content lives in ..\skills (see skills\README.md); this script carries none.
|
||||
$skillsTarget = Join-Path $coreDir "node_modules\openclaw\skills"
|
||||
$skillInstaller = Join-Path $scriptDir "lib\install-skills.mjs"
|
||||
if (-not (Test-Path $skillInstaller)) { $skillInstaller = Join-Path $scriptDir "..\lib\install-skills.mjs" }
|
||||
|
||||
if ((Test-Path $skillInstaller) -and (Test-Path -Path $skillsTarget -PathType Container)) {
|
||||
Write-Step "->" "Installing skills..." "Cyan"
|
||||
& (Join-Path $windowsNodeTarget "node.exe") $skillInstaller --target $skillsTarget --locale en
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "========================================" -ForegroundColor Green
|
||||
Write-Host " Setup Complete" -ForegroundColor Green
|
||||
Write-Host "========================================" -ForegroundColor Green
|
||||
Write-Host ""
|
||||
Write-Host " Launch:"
|
||||
Write-Host " Mac: bash START HERE - Mac.command" -ForegroundColor Cyan
|
||||
Write-Host " Windows: double-click START HERE - Windows.bat" -ForegroundColor Cyan
|
||||
Write-Host ""
|
||||
Write-Host " Structure:"
|
||||
Write-Host " app/core/ -> OpenClaw and dependencies"
|
||||
Write-Host " app/runtime/ -> Node.js $nodeVersion"
|
||||
Write-Host " data/ -> created automatically after launch"
|
||||
Write-Host ""
|
||||
Write-Host " Tip: use .\setup.ps1 -AllPlatforms to prepare a cross-platform USB." -ForegroundColor Cyan
|
||||
Reference in New Issue
Block a user