ClawPanel Portable

ClawPanel Portable 是 ClawPanel 的 U 盘完整包集成仓库。

这个仓库不直接提交大体积运行时文件，而是保存：

• 稳定版 manifest
• Windows / macOS 便携包构建脚本
• U 盘写入和验收脚本
• 用户说明文档

最终面向用户发布的是 GitHub Release 里的完整包：

ClawPanelPortable-Windows-x64-full-v0.18.5.zip
ClawPanelPortable-macOS-arm64-full-v0.18.5.zip
ClawPanelPortable-macOS-x64-full-v0.18.5.zip

当前稳定基准

组件	版本
ClawPanel	0.18.5
OpenClaw zh standalone	2026.6.1-zh.1
Hermes Agent	0.18.0 / v2026.7.1
uv	0.7.12

便携包目录

ClawPanelPortable/
  portable.json
  README-USB.md
  ClawPanel.exe
  ClawPanel.app/

  data/
    clawpanel/
    openclaw/
    hermes/
    media/

  engines/
    openclaw/
    hermes/

  runtimes/
    uv/
    python/
    git/

Windows 构建

先在 ClawPanel 主仓库构建出桌面程序，或把主仓库路径交给脚本自动构建：

.\scripts\build-windows-full.ps1 `
  -ClawPanelRepo D:\Data\PC\ClawPanel `
  -OutputDir .\output

如果已经有 clawpanel.exe：

.\scripts\build-windows-full.ps1 `
  -ClawPanelExe D:\Data\PC\ClawPanel\src-tauri\target\release\clawpanel.exe `
  -OutputDir .\output

验收：

.\scripts\verify-windows.ps1 -PortableRoot .\output\windows-x64\ClawPanelPortable

Tag 发版

推送 tag 会自动构建 Windows x64 完整包，并把 zip 与 SHA256 上传到 GitHub Release：

git tag v0.18.5-portable.1
git push origin v0.18.5-portable.1

发布产物：

ClawPanelPortable-Windows-x64-full-v0.18.5.zip
ClawPanelPortable-Windows-x64-full-v0.18.5.zip.sha256.json

写入 U 盘：

.\scripts\write-usb-windows.ps1 `
  -Archive .\output\ClawPanelPortable-Windows-x64-full-v0.18.5.zip `
  -DriveLetter E

macOS 构建

./scripts/build-macos-full.sh \
  --clawpanel-app /path/to/ClawPanel.app \
  --arch arm64 \
  --output ./output

验收：

./scripts/verify-macos.sh --portable-root ./output/macos-arm64/ClawPanelPortable

macOS 版依赖系统自带的 Git（Xcode Command Line Tools），不像 Windows 会自动下载 MinGit；.app 产出未签名未公证，正式对外分发前需要 Apple Developer 证书完成 codesign + notarize。详见 docs/macos.md「已知缺口」。

维护原则

• 仓库只放脚本、manifest 和文档。
• runtime、engine、完整 zip 只放 Release 或对象存储。
• 稳定版以 manifests/*.json 为准。
• 普通 ClawPanel 仓库继续负责面板功能；本仓库只负责 U 盘完整包产品化交付。