OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

macOS Release

这页说明书是教大人们怎么给苹果电脑（macOS）上的 OpenClaw 软件做“新版本发布”的。就像你搭好了一个新玩具城堡，现在要把它包装好，贴上标签，送到商店里，这样其他小朋友就能收到更新，玩到新功能了。如果你不是负责打包和发布软件的大人，可以不用看这页哦。

五岁小孩版解释

这就像我们要给一个苹果电脑上的软件准备一个新版本，让它能自己告诉用户“有更新啦！”。为了做到这一点，我们需要一些特别的工具和步骤。

准备工作：就像做饭前要准备好食材 在开始之前，大人需要准备好几样东西：

  1. 一个“开发者身份证”：这就像软件进入苹果商店的通行证，名字看起来像 Developer ID Application: <你的名字> (<一串数字>)。
  2. 一把“更新钥匙”：这是一把特殊的钥匙（叫 SPARKLE_PRIVATE_KEY_FILE），用来给更新包签名，证明它真的是我们做的。如果找不到它，可以去电脑的 ~/.profile 文件里看看。
  3. 一个“公证员”的账号：为了让软件更安全，苹果需要一个叫“公证”的步骤。我们需要设置一个叫 openclaw-notary 的账号信息，这需要用到几个秘密代码（APP_STORE_CONNECT_API_KEY_P8 等）。
  4. 安装好软件零件：运行 pnpm install --config.node-linker=hoisted 这个命令，把软件需要的所有小零件都准备好。
  5. 自动拿到“更新工具”：一些叫 Sparkle 的工具会自动下载好，放在 apps/macos/.build/artifacts/sparkle/Sparkle/bin/ 这个文件夹里。

开始打包：把软件装进盒子 打包的时候有几点要注意：

  • APP_BUILD 这个号码很重要，它必须是数字，并且每次都要比上次大一点（比如 1，2，3），不能加 -beta 这样的字。如果不写，脚本会自己算一个。
  • 如果想打包成能在所有苹果电脑上运行的版本，需要告诉电脑 BUILD_ARCHS="arm64 x86_64"。

打包的步骤是这样的：

  1. 第一步，打包软件本身：从存放所有代码的文件夹根目录开始，运行一个长长的命令。这个命令会告诉电脑：“用 Developer ID Application 这个身份证签名，版本号是 2026.3.8，用 release 模式来打包”。命令里 BUNDLE_ID、APP_VERSION 这些词都要换成正确的。
  2. 第二步，把软件压缩成 zip 包：用 ditto -c -k --sequesterRsrc --keepParent 这个命令，把打包好的 dist/OpenClaw.app 变成一个 zip 文件，比如 dist/OpenClaw-2026.3.8.zip。
  3. 第三步（可选），做一个漂亮的安装盘：运行 scripts/create-dmg.sh，可以做出一个像光盘一样的文件（DMG），大家可以把软件图标直接拖进去安装。
  4. 第四步（推荐），打包并让苹果公证：运行 scripts/package-mac-dist.sh 这个脚本，并且加上 NOTARIZE=1。它会帮你完成打包、压缩、做安装盘，并且送到苹果那里去检查（公证）和盖章（装订），这样软件就更安全了。
  5. 第五步（可选），带上“调试地图”：用 ditto 命令把 apps/macos/.build/release/OpenClaw.app.dSYM 这个文件夹也打包。如果软件出了问题，大人可以用这个“地图”来找到原因。

告诉世界有更新了：发布更新通知 打包好后，我们要生成一个“更新通知单”（appcast entry），这样旧的软件才知道有新版本了。

  1. 运行这个命令：SPARKLE_PRIVATE_KEY_FILE=/钥匙的路径 scripts/make_appcast.sh dist/OpenClaw-2026.3.8.zip https://.../appcast.xml。
  2. 这个命令会用我们准备好的“更新钥匙”，读取 CHANGELOG.md（记录所有新变化的文件），生成一个漂亮的更新说明，然后把它写进 appcast.xml 这个总通知文件里。
  3. 记得要把更新后的 appcast.xml 文件，和刚才做好的 zip 包一起保存好。

最后发布和检查：把礼物送出去 最后，我们要把所有东西放到网上，并检查一切是否正常：

  1. 上传：把 OpenClaw-2026.3.8.zip 和 OpenClaw-2026.3.8.dSYM.zip 文件，上传到 GitHub 上一个叫 v2026.3.8 的“发布页”里。
  2. 核对地址：确保软件里写的更新通知地址（appcast.xml 的网址）和网上放的一模一样。
  3. 仔细检查：
    • 用 curl -I 命令看看网上的 appcast.xml 文件能不能打开。
    • 也用 curl -I 看看刚上传的 zip 文件能不能打开。
    • 最好在一台已经装了旧版本软件的电脑上，点击菜单里的“检查更新…”，看看它能不能顺利地找到、下载并安装这个新版本。

当所有这些都做完，软件签好了名，更新通知发出去了，旧软件能成功更新，所有文件也都好好地放在发布页上，我们的工作就完成啦！