Passer au contenu principal

​
Liste de controle de publication (npm + macOS)

Utilisez pnpm (Node 22+) depuis la racine du depot. Gardez l’arborescence de travail propre avant de taguer/publier.

​
Declencheur operateur

Lorsque l’operateur dit « release », effectuez immediatement ce precontrole (pas de questions supplementaires sauf blocage) :
  • Lisez ce document et docs/platforms/mac/release.md.
  • Chargez l’environnement depuis ~/.profile et confirmez que SPARKLE_PRIVATE_KEY_FILE + les variables App Store Connect sont definies (SPARKLE_PRIVATE_KEY_FILE doit se trouver dans ~/.profile).
  • Utilisez les cles Sparkle depuis ~/Library/CloudStorage/Dropbox/Backup/Sparkle si necessaire.
  1. Version & metadonnees
  • Incrementer la version de package.json (ex. 2026.1.29).
  • Executer pnpm plugins:sync pour aligner les versions des packages d’extensions + les journaux de modifications.
  • Mettre a jour les chaines CLI/version : src/cli/program.ts et l’agent utilisateur Baileys dans src/provider-web.ts.
  • Confirmer les metadonnees du package (nom, description, depot, mots-cles, licence) et que le mapping bin pointe vers openclaw.mjs pour openclaw.
  • Si les dependances ont change, executer pnpm install afin que pnpm-lock.yaml soit a jour.
  1. Build & artefacts
  • Si les entrees A2UI ont change, executer pnpm canvas:a2ui:bundle et commiter toute mise a jour de src/canvas-host/a2ui/a2ui.bundle.js.
  • pnpm run build (regenere dist/).
  • Verifier que le package npm files inclut tous les dossiers dist/* requis (notamment dist/node-host/** et dist/acp/** pour node headless + le CLI ACP).
  • Confirmer que dist/build-info.json existe et inclut le hash commit attendu (la banniere CLI l’utilise pour les installations npm).
  • Optionnel : npm pack --pack-destination /tmp apres le build ; inspectez le contenu du tarball et gardez-le a disposition pour la release GitHub (ne pas le commiter).
  1. Changelog & documentation
  • Mettre a jour CHANGELOG.md avec les points saillants cote utilisateur (creer le fichier s’il manque) ; conserver un ordre strictement decroissant par version.
  • S’assurer que les exemples/flags du README correspondent au comportement actuel du CLI (notamment les nouvelles commandes ou options).
  1. Validation
  • pnpm build
  • pnpm check
  • pnpm test (ou pnpm test:coverage si vous avez besoin de la couverture)
  • pnpm release:check (verifie le contenu de npm pack)
  • OPENCLAW_INSTALL_SMOKE_SKIP_NONROOT=1 pnpm test:install:smoke (test fumee d’installation Docker, voie rapide ; requis avant publication)
    • Si la version npm immediate precedente est connue comme defectueuse, definir OPENCLAW_INSTALL_SMOKE_PREVIOUS=<last-good-version> ou OPENCLAW_INSTALL_SMOKE_SKIP_PREVIOUS=1 pour l’etape de preinstall.
  • (Optionnel) Test fumee complet de l’installateur (ajoute couverture non-root + CLI) : pnpm test:install:smoke
  • (Optionnel) E2E de l’installateur (Docker, execute curl -fsSL https://openclaw.ai/install.sh | bash, prise en main, puis appels d’outils reels) :
    • pnpm test:install:e2e:openai (necessite OPENAI_API_KEY)
    • pnpm test:install:e2e:anthropic (necessite ANTHROPIC_API_KEY)
    • pnpm test:install:e2e (necessite les deux cles ; execute les deux fournisseurs)
  • (Optionnel) Verifier ponctuellement la Gateway (passerelle) web si vos changements affectent les chemins d’envoi/reception.
  1. Application macOS (Sparkle)
  • Builder + signer l’application macOS, puis la zipper pour la distribution.
  • Generer l’appcast Sparkle (notes HTML via scripts/make_appcast.sh) et mettre a jour appcast.xml.
  • Garder le zip de l’app (et le zip dSYM optionnel) pret a etre joint a la release GitHub.
  • Suivre macOS release pour les commandes exactes et les variables d’environnement requises.
    • APP_BUILD doit etre numerique et monotone (pas de -beta) afin que Sparkle compare correctement les versions.
    • En cas de notarisation, utiliser le profil de trousseau openclaw-notary cree a partir des variables d’environnement API App Store Connect (voir macOS release).
  1. Publication (npm)
  • Confirmer que l’etat git est propre ; commiter et pousser si necessaire.
  • npm login (verifier la 2FA) si necessaire.
  • npm publish --access public (utiliser --tag beta pour les pre-releases).
  • Verifier le registre : npm view openclaw version, npm view openclaw dist-tags, et npx -y [email protected] --version (ou --help).

​
Depannage (notes de la release 2.0.0-beta2)

  • npm pack/publish se bloque ou produit un tarball enorme : le bundle de l’application macOS dans dist/OpenClaw.app (et les zips de release) est inclus dans le package. Corriger en listant explicitement le contenu publie via package.json files (inclure les sous-dossiers dist, docs, skills ; exclure les bundles d’app). Confirmer avec npm pack --dry-run que dist/OpenClaw.app n’est pas liste.
  • Boucle d’authentification npm web pour les dist-tags : utiliser l’authentification legacy pour obtenir une invite OTP :
  • La verification npx echoue avec ECOMPROMISED: Lock compromised : reessayer avec un cache neuf :
  • Le tag doit etre repointe apres une correction tardive : forcer la mise a jour et pousser le tag, puis s’assurer que les artefacts de la release GitHub correspondent toujours :
    • git tag -f vX.Y.Z && git push -f origin vX.Y.Z
  1. Release GitHub + appcast
  • Taguer et pousser : git tag vX.Y.Z && git push origin vX.Y.Z (ou git push --tags).
  • Creer/rafraichir la release GitHub pour vX.Y.Z avec le titre openclaw X.Y.Z (pas seulement le tag) ; le corps doit inclure la section de changelog complete pour cette version (Highlights + Changes + Fixes), en ligne (sans liens nus), et ne doit pas repeter le titre dans le corps.
  • Joindre les artefacts : tarball npm pack (optionnel), OpenClaw-X.Y.Z.zip, et OpenClaw-X.Y.Z.dSYM.zip (si genere).
  • Commiter le appcast.xml mis a jour et le pousser (Sparkle alimente depuis main).
  • Depuis un repertoire temporaire propre (sans package.json), executer npx -y [email protected] send --help pour confirmer que l’installation et les points d’entree du CLI fonctionnent.
  • Annoncer/partager les notes de release.

​
Perimetre de publication des plugins (npm)

Nous ne publions que les plugins npm existants sous le scope @openclaw/*. Les plugins bundles qui ne sont pas sur npm restent uniquement dans l’arborescence disque (toujours livres dans extensions/**). Processus pour etablir la liste :
  1. npm search @openclaw --json et capturer les noms de packages.
  2. Comparer avec les noms extensions/*/package.json.
  3. Publier uniquement l’intersection (deja sur npm).
Liste actuelle des plugins npm (mettre a jour si necessaire) :
  • @openclaw/bluebubbles
  • @openclaw/diagnostics-otel
  • @openclaw/discord
  • @openclaw/feishu
  • @openclaw/lobster
  • @openclaw/matrix
  • @openclaw/msteams
  • @openclaw/nextcloud-talk
  • @openclaw/nostr
  • @openclaw/voice-call
  • @openclaw/zalo
  • @openclaw/zalouser
Les notes de release doivent egalement mentionner les nouveaux plugins bundles optionnels qui ne sont pas actives par defaut (exemple : tlon).