feat: 海外化改造(新加坡市场)—— 阶段 0-3
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 拆到私有仓库,无权限
This commit is contained in:
2026-08-17 18:37:49 +08:00
parent 9a23aec097
commit b076815171
123 changed files with 13396 additions and 14723 deletions

View File

@@ -0,0 +1,306 @@
#!/bin/bash
# U-Claw Menu - Portable AI Agent
# macOS version
UCLAW_DIR="$(cd "$(dirname "$0")/.." && pwd)"
APP_DIR="$UCLAW_DIR/app"
# Migration shim: rename old core-mac to core for existing USB users
if [ -d "$APP_DIR/core-mac" ] && [ ! -d "$APP_DIR/core" ]; then
mv "$APP_DIR/core-mac" "$APP_DIR/core"
fi
CORE_DIR="$APP_DIR/core"
DATA_DIR="$UCLAW_DIR/data"
STATE_DIR="$DATA_DIR/.openclaw"
CONFIG_PATH="$STATE_DIR/openclaw.json"
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
CYAN='\033[0;36m'
WHITE='\033[1;37m'
NC='\033[0m'
BOLD='\033[1m'
DIM='\033[2m'
# Node.js — detect architecture
ARCH=$(uname -m)
if [ "$ARCH" = "arm64" ]; then
NODE_DIR="$APP_DIR/runtime/node-mac-arm64"
else
NODE_DIR="$APP_DIR/runtime/node-mac-x64"
fi
NODE_BIN="$NODE_DIR/bin/node"
NPM_BIN="$NODE_DIR/bin/npm"
export PATH="$NODE_DIR/bin:$PATH"
export OPENCLAW_HOME="$DATA_DIR"
export OPENCLAW_STATE_DIR="$STATE_DIR"
export OPENCLAW_CONFIG_PATH="$CONFIG_PATH"
mkdir -p "$STATE_DIR" "$DATA_DIR/memory" "$DATA_DIR/backups" "$DATA_DIR/logs"
# Load maintenance functions
source "$UCLAW_DIR/lib/maintain.sh"
# Remove macOS quarantine
if xattr -l "$NODE_BIN" 2>/dev/null | grep -q "com.apple.quarantine"; then
xattr -rd com.apple.quarantine "$UCLAW_DIR" 2>/dev/null || true
fi
# Run openclaw command
OPENCLAW_MJS="$CORE_DIR/node_modules/openclaw/openclaw.mjs"
run_oc() {
cd "$CORE_DIR"
"$NODE_BIN" "$OPENCLAW_MJS" "$@"
}
# Show menu
show_menu() {
clear
local NODE_VER=$("$NODE_BIN" --version 2>/dev/null || echo "N/A")
local CFG_STATUS="${RED}not set up${NC}"
[ -f "$CONFIG_PATH" ] && CFG_STATUS="${GREEN}ready${NC}"
echo ""
echo -e " ${CYAN}${BOLD}╔══════════════════════════════════════╗"
echo -e " ║ U-Claw v1.1 ║"
echo -e " ║ Portable AI Agent ║"
echo -e " ╚══════════════════════════════════════╝${NC}"
echo ""
echo -e " Node: ${GREEN}${NODE_VER}${NC} Model: ${CFG_STATUS}"
echo ""
echo -e " ${WHITE}${BOLD}-- Setup ---------------------------------${NC}"
echo -e " ${GREEN}[1]${NC} Set up a model and paste your key"
echo -e " ${GREEN}[2]${NC} Open Settings in the browser"
echo ""
echo -e " ${WHITE}${BOLD}-- Chat apps -----------------------------${NC}"
echo -e " ${GREEN}[3]${NC} Connect WhatsApp / Telegram / Slack / Discord"
echo -e " ${GREEN}[4]${NC} Connect a chat app used in China"
echo ""
echo -e " ${WHITE}${BOLD}-- Maintenance ---------------------------${NC}"
echo -e " ${GREEN}[5]${NC} Check and fix problems"
echo -e " ${GREEN}[6]${NC} Back up your settings"
echo -e " ${GREEN}[7]${NC} Restore a backup"
echo -e " ${GREEN}[8]${NC} System information"
echo ""
echo -e " ${WHITE}${BOLD}-- Advanced ------------------------------${NC}"
echo -e " ${GREEN}[9]${NC} Stop leftover processes"
echo -e " ${GREEN}[10]${NC} View logs"
echo -e " ${GREEN}[11]${NC} Reset to factory settings"
echo -e " ${GREEN}[12]${NC} Uninstall"
echo -e " ${GREEN}[13]${NC} Check for updates"
echo -e " ${GREEN}[14]${NC} Free up space"
echo -e " ${GREEN}[15]${NC} Plugins"
echo ""
echo -e " ${DIM}[0] Quit${NC}"
echo ""
}
# [1] Config wizard
do_config() {
echo ""
echo -e " ${CYAN}${BOLD}--- Set up a model ---${NC}"
echo ""
echo -e " ${WHITE}Picking a provider in the wizard:${NC}"
echo ""
echo -e " DeepSeek → choose Custom Provider"
echo -e " URL: https://api.deepseek.com/v1"
echo -e " model: deepseek-v4-flash"
echo -e " Kimi → choose Moonshot AI"
echo -e " Qwen -> choose Qwen"
echo -e " Doubao -> choose Volcano Engine"
echo ""
read -p " Press Enter to start the wizard…"
run_oc onboard
}
# [2] Web dashboard
do_dashboard() {
echo ""
echo -e " ${CYAN}Opening Settings…${NC}"
echo ""
cd "$CORE_DIR"
# Find free port
local PORT=18789
while lsof -i :$PORT >/dev/null 2>&1; do
PORT=$((PORT + 1))
if [ $PORT -gt 18799 ]; then
echo -e " ${RED}Ports 18789-18799 are all in use — U-Claw may already be running${NC}"
return
fi
done
local TOKEN=$(python3 -c "import json,os; p='$CONFIG_PATH'; d=json.load(open(p)) if os.path.exists(p) else {}; print(d.get('gateway',{}).get('auth',{}).get('token','uclaw'))" 2>/dev/null || echo "uclaw")
"$NODE_BIN" "$OPENCLAW_MJS" gateway run --allow-unconfigured --force --port $PORT &
local PID=$!
for i in $(seq 1 30); do
sleep 0.5
if curl --noproxy '*' -s -o /dev/null "http://127.0.0.1:$PORT/" 2>/dev/null; then
local URL="http://127.0.0.1:$PORT/#token=$TOKEN"
echo -e " ${GREEN}Settings: $URL${NC}"
open "$URL" 2>/dev/null
break
fi
done
echo " Closing this window stops U-Claw"
wait $PID
}
# [3] QQ Bot (pre-installed)
do_qq() {
echo ""
echo -e " ${CYAN}${BOLD}--- Connect a QQ bot ---${NC}"
echo ""
echo -e " ${GREEN}The QQ plugin is already installed. You only need the AppID and AppSecret.${NC}"
echo ""
echo " Get them at q.qq.com by creating a bot"
echo ""
read -p " AppID: " QQ_ID
read -p " AppSecret: " QQ_SECRET
echo ""
if [ -z "$QQ_ID" ] || [ -z "$QQ_SECRET" ]; then
echo -e " ${YELLOW}Cancelled${NC}"
return
fi
run_oc channels add --channel qqbot --token "${QQ_ID}:${QQ_SECRET}" 2>&1 || true
echo ""
read -p " Your QQ number, to allow only you (blank to skip): " QQ_ALLOW
if [ -n "$QQ_ALLOW" ]; then
run_oc config set channels.qqbot.allowFrom "\"${QQ_ALLOW}\"" 2>&1 || true
echo -e " ${GREEN}Allow-list set${NC}"
fi
echo ""
echo -e " ${GREEN}QQ bot configured. Restart U-Claw for it to take effect.${NC}"
}
# [4] Other platforms
do_platforms() {
echo ""
echo -e " ${CYAN}${BOLD}--- Other chat apps ---${NC}"
echo ""
echo -e " ${GREEN}[a]${NC} Feishu / Lark"
echo -e " ${GREEN}[b]${NC} Telegram"
echo -e " ${GREEN}[c]${NC} WeChat (community plugin)"
echo -e " ${GREEN}[d]${NC} Discord"
echo ""
read -p " Choose (a-d): " -n 1 CH
echo ""
echo ""
case $CH in
a) echo " Feishu: create an app at open.feishu.cn/app" ;;
b) echo " Telegram: create a bot with @BotFather" ;;
c)
echo -e " ${YELLOW}Installing the WeChat plugin…${NC}"
run_oc plugins install @icesword760/openclaw-wechat 2>&1 || true
;;
d) echo " Discord: create an app at discord.com/developers/applications" ;;
*) echo " Not a valid choice" ;;
esac
echo ""
echo " Then run [1] to finish connecting it"
}
# [5] Doctor
do_doctor() {
echo ""
echo -e " ${CYAN}━━━ Check and fix problems ━━━${NC}"
echo ""
run_oc doctor --repair 2>&1 || echo -e " ${YELLOW}The check could not run${NC}"
}
# [6] Backup
do_backup() {
echo ""
local TS=$(date +%Y%m%d_%H%M%S)
local BK="$DATA_DIR/backups/backup_$TS"
mkdir -p "$BK"
[ -f "$CONFIG_PATH" ] && cp "$CONFIG_PATH" "$BK/" && echo -e " ${GREEN} + openclaw.json${NC}"
[ -d "$DATA_DIR/memory" ] && cp -R "$DATA_DIR/memory" "$BK/" 2>/dev/null && echo -e " ${GREEN} + memory/${NC}"
echo ""
echo -e " ${GREEN}Backed up to $BK${NC}"
echo " Size: $(du -sh "$BK" | cut -f1)"
}
# [7] Restore
do_restore() {
echo ""
local BK_DIR="$DATA_DIR/backups"
if [ ! -d "$BK_DIR" ] || [ -z "$(ls -A "$BK_DIR" 2>/dev/null)" ]; then
echo -e " ${YELLOW}No backups yet${NC}"
return
fi
echo " Available backups:"
local i=1
for b in "$BK_DIR"/*/; do
echo -e " ${GREEN}[$i]${NC} $(basename "$b") ($(du -sh "$b" | cut -f1))"
i=$((i+1))
done
echo ""
read -p " Which one? " NUM
local j=1
for b in "$BK_DIR"/*/; do
if [ "$j" = "$NUM" ]; then
[ -f "$b/openclaw.json" ] && cp "$b/openclaw.json" "$CONFIG_PATH" && echo -e " ${GREEN} + settings restored${NC}"
[ -d "$b/memory" ] && cp -R "$b/memory" "$DATA_DIR/" && echo -e " ${GREEN} + memory restored${NC}"
echo -e " ${GREEN}Restored${NC}"
return
fi
j=$((j+1))
done
echo -e " ${RED}Not a valid choice${NC}"
}
# [8] System info
do_sysinfo() {
echo ""
echo " System: $(sw_vers -productName 2>/dev/null) $(sw_vers -productVersion 2>/dev/null)"
echo " CPU: $(uname -m)"
echo " Memory: $(sysctl -n hw.memsize 2>/dev/null | awk '{printf "%.0f GB", $1/1024/1024/1024}')"
echo " Node: $("$NODE_BIN" --version 2>/dev/null)"
echo " Path: $UCLAW_DIR"
echo " Size: $(du -sh "$UCLAW_DIR" 2>/dev/null | cut -f1)"
echo " Disk: $(df -h "$UCLAW_DIR" | tail -1 | awk '{print $4 " free"}')"
}
# Main loop
while true; do
show_menu
read -p " Choose [0-15]: " CHOICE
echo ""
case $CHOICE in
1) do_config ;;
2) do_dashboard ;;
3) do_qq ;;
4) do_platforms ;;
5) do_doctor ;;
6) do_backup ;;
7) do_restore ;;
8) do_sysinfo ;;
9) do_kill_gateway ;;
10) do_logs ;;
11) do_factory_reset ;;
12) do_uninstall ;;
13) do_update ;;
14) do_cleanup ;;
15) do_plugins ;;
0) echo -e " ${CYAN}Bye.${NC}"; exit 0 ;;
*) echo -e " ${RED}Not a valid choice${NC}" ;;
esac
echo ""
read -p " Press Enter to go back…"
done