npm - @privateclaw/privateclaw-relay - Versions diffs - 0.1.10 → 0.1.12 - Mend

@privateclaw/privateclaw-relay 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/dist/provider-setup.d.ts +19 -1
package/dist/provider-setup.js +241 -21
package/dist/provider-setup.js.map +1 -1
package/dist/web/assets/icon-app-store.svg +12 -0
package/dist/web/assets/icon-google-group.svg +4 -4
package/dist/web/assets/icon-google-play.svg +6 -0
package/dist/web/assets/icon-linux.svg +4 -0
package/dist/web/assets/icon-macos.svg +4 -0
package/dist/web/assets/icon-windows.svg +3 -0
package/dist/web/chat/index.html +3 -3
package/dist/web/index.html +106 -11
package/dist/web/privacy/index.html +5 -5
package/dist/web/scripts/chat.js +1 -1
package/dist/web/scripts/i18n.js +150 -108
package/dist/web/scripts/policy.js +1 -1
package/dist/web/scripts/site.js +7 -1
package/dist/web/styles.css +108 -0
package/dist/web/terms/index.html +5 -5
package/package.json +1 -1

package/dist/web/index.html CHANGED Viewed

@@ -7,7 +7,7 @@
     <meta name="description" content="PrivateClaw gives you beautiful, private rooms for the people you trust around one shared OpenClaw." />
     <title>PrivateClaw</title>
     <link rel="icon" type="image/png" href="./assets/privateclaw_app_icon.png?v=20260314-2" />
-    <link rel="stylesheet" href="./styles.css?v=20260316-3" />
+    <link rel="stylesheet" href="./styles.css?v=20260329-2" />
   </head>
   <body class="marketing-page">
     <div class="aurora aurora-a"></div>
@@ -29,15 +29,15 @@
         <nav class="topbar-actions">
           <a class="ghost-button icon-link" href="https://github.com/topcheer/PrivateClaw" target="_blank" rel="noreferrer">
-            <img src="./assets/icon-github.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="./assets/icon-github.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navGithub"></span>
           </a>
           <a class="ghost-button icon-link google-icon-link" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer">
-            <img src="./assets/icon-google-group.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="./assets/icon-google-group.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navBetaGroup"></span>
           </a>
           <a class="ghost-button icon-link" href="https://t.me/+W3RUKxEO9kIxMmZl" target="_blank" rel="noreferrer">
-            <img src="./assets/icon-telegram.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="./assets/icon-telegram.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navTelegramGroup"></span>
           </a>
           <label class="locale-picker" for="locale-select">
@@ -58,7 +58,12 @@
               <a id="web-entry" class="primary-button" href="./chat/">
                 <span data-i18n="site.heroPrimaryCta"></span>
               </a>
-              <a class="ghost-button" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer" data-i18n="site.heroSecondaryCta"></a>
+              <a class="ghost-button button-with-icon" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer">
+                <span class="button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-google-group.svg?v=20260329-1" alt="" class="button-icon-image" />
+                </span>
+                <span data-i18n="site.heroSecondaryCta"></span>
+              </a>
             </div>
             <div class="device-hint card-inline">
@@ -69,19 +74,25 @@
               <span class="coming-soon-badge" data-i18n="site.appComingSoon"></span>
               <div class="store-button-grid">
                 <a
-                  class="store-button store-button-live"
-                  href="https://testflight.apple.com/join/XvgJ9c33"
+                  class="store-button store-button-live store-button-rich"
+                  href="https://apps.apple.com/us/app/yourclaw/id6760531637"
                   target="_blank"
                   rel="noreferrer"
                 >
+                  <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                    <img src="./assets/icon-app-store.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                  </span>
                   <span class="store-button-label" data-i18n="site.iosComingSoon"></span>
                 </a>
                 <a
-                  class="store-button store-button-live"
+                  class="store-button store-button-live store-button-rich"
                   href="https://play.google.com/store/apps/details?id=gg.ai.privateclaw"
                   target="_blank"
                   rel="noreferrer"
                 >
+                  <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                    <img src="./assets/icon-google-play.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                  </span>
                   <span class="store-button-label" data-i18n="site.androidComingSoon"></span>
                 </a>
               </div>
@@ -126,6 +137,80 @@
           <div class="scenario-grid" id="scenario-grid"></div>
         </section>
+        <section class="section-block">
+          <div class="section-heading">
+            <span class="section-kicker" data-i18n="site.desktopDownloadsKicker"></span>
+            <h2 data-i18n="site.desktopDownloadsTitle"></h2>
+            <p data-i18n="site.desktopDownloadsBody"></p>
+          </div>
+          <div class="coming-soon-row">
+            <span class="coming-soon-badge badge-with-icon">
+              <span class="badge-icon-surface" aria-hidden="true">
+                <img src="./assets/icon-github.svg?v=20260329-1" alt="" class="badge-icon-image" />
+              </span>
+              <span data-i18n="site.desktopDownloadsBadge"></span>
+            </span>
+            <div class="store-button-grid">
+              <a
+                class="store-button store-button-live store-button-rich"
+                href="https://github.com/topcheer/PrivateClaw/releases/download/app-v0.1.14/PrivateClaw-v0.1.14-b70560865-windows-x64.zip"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-windows.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                </span>
+                <span class="store-button-label" data-i18n="site.desktopDownloadWindowsX64"></span>
+              </a>
+              <a
+                class="store-button store-button-live store-button-rich"
+                href="https://github.com/topcheer/PrivateClaw/releases/download/app-v0.1.14/PrivateClaw-v0.1.14-b70560865-macos-arm64.dmg"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-macos.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                </span>
+                <span class="store-button-label" data-i18n="site.desktopDownloadMacosArm64"></span>
+              </a>
+              <a
+                class="store-button store-button-live store-button-rich"
+                href="https://github.com/topcheer/PrivateClaw/releases/download/app-v0.1.14/PrivateClaw-v0.1.14-b70560865-macos-x64.dmg"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-macos.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                </span>
+                <span class="store-button-label" data-i18n="site.desktopDownloadMacosX64"></span>
+              </a>
+              <a
+                class="store-button store-button-live store-button-rich"
+                href="https://github.com/topcheer/PrivateClaw/releases/download/app-v0.1.14/PrivateClaw-v0.1.14-b70560865-linux-x64.tar.gz"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-linux.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                </span>
+                <span class="store-button-label" data-i18n="site.desktopDownloadLinuxX64"></span>
+              </a>
+              <a
+                class="store-button store-button-live store-button-rich"
+                href="https://github.com/topcheer/PrivateClaw/releases/download/app-v0.1.14/PrivateClaw-v0.1.14-b70560865-linux-arm64.tar.gz"
+                target="_blank"
+                rel="noreferrer"
+              >
+                <span class="button-icon-surface store-button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-linux.svg?v=20260329-1" alt="" class="button-icon-image store-button-icon-image" />
+                </span>
+                <span class="store-button-label" data-i18n="site.desktopDownloadLinuxArm64"></span>
+              </a>
+            </div>
+          </div>
+          <p class="community-footnote" data-i18n="site.desktopDownloadsNote"></p>
+        </section>
         <section class="section-block setup-section">
           <div class="section-heading">
             <span class="section-kicker" data-i18n="site.setupKicker"></span>
@@ -143,8 +228,18 @@
               <p data-i18n="site.betaBody"></p>
             </div>
             <div class="community-actions">
-              <a class="primary-button" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer" data-i18n="site.betaPrimaryCta"></a>
-              <a class="ghost-button" href="https://t.me/+W3RUKxEO9kIxMmZl" target="_blank" rel="noreferrer" data-i18n="site.betaTelegramCta"></a>
+              <a class="primary-button button-with-icon" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer">
+                <span class="button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-google-group.svg?v=20260329-1" alt="" class="button-icon-image" />
+                </span>
+                <span data-i18n="site.betaPrimaryCta"></span>
+              </a>
+              <a class="ghost-button button-with-icon" href="https://t.me/+W3RUKxEO9kIxMmZl" target="_blank" rel="noreferrer">
+                <span class="button-icon-surface" aria-hidden="true">
+                  <img src="./assets/icon-telegram.svg?v=20260329-1" alt="" class="button-icon-image" />
+                </span>
+                <span data-i18n="site.betaTelegramCta"></span>
+              </a>
               <span class="community-footnote" data-i18n="site.betaFootnote"></span>
             </div>
           </div>
@@ -169,6 +264,6 @@
       </footer>
     </div>
-    <script type="module" src="./scripts/site.js?v=20260316-3"></script>
+    <script type="module" src="./scripts/site.js?v=20260328-2"></script>
   </body>
 </html>

package/dist/web/privacy/index.html CHANGED Viewed

@@ -7,7 +7,7 @@
     <meta name="description" content="PrivateClaw privacy policy." />
     <title>PrivateClaw Privacy</title>
     <link rel="icon" type="image/png" href="../assets/privateclaw_app_icon.png?v=20260314-2" />
-    <link rel="stylesheet" href="../styles.css?v=20260316-3" />
+    <link rel="stylesheet" href="../styles.css?v=20260329-2" />
   </head>
   <body class="marketing-page policy-page" data-policy-page="privacy">
     <div class="aurora aurora-a"></div>
@@ -29,15 +29,15 @@
         <nav class="topbar-actions">
           <a class="ghost-button icon-link" href="https://github.com/topcheer/PrivateClaw" target="_blank" rel="noreferrer">
-            <img src="../assets/icon-github.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="../assets/icon-github.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navGithub"></span>
           </a>
           <a class="ghost-button icon-link google-icon-link" href="https://groups.google.com/g/gg-studio-ai-products" target="_blank" rel="noreferrer">
-            <img src="../assets/icon-google-group.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="../assets/icon-google-group.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navBetaGroup"></span>
           </a>
           <a class="ghost-button icon-link" href="https://t.me/+W3RUKxEO9kIxMmZl" target="_blank" rel="noreferrer">
-            <img src="../assets/icon-telegram.svg?v=20260314-1" alt="" class="icon-link-image" />
+            <img src="../assets/icon-telegram.svg?v=20260329-1" alt="" class="icon-link-image" />
             <span class="sr-only" data-i18n="site.navTelegramGroup"></span>
           </a>
           <label class="locale-picker" for="locale-select">
@@ -78,6 +78,6 @@
       </footer>
     </div>
-    <script type="module" src="../scripts/policy.js?v=20260316-3"></script>
+    <script type="module" src="../scripts/policy.js?v=20260325-1"></script>
   </body>
 </html>

package/dist/web/scripts/chat.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { applyTranslations, bindLocaleSelect, onLocaleChange, t } from "./i18n.js?v=20260318-1";
+import { applyTranslations, bindLocaleSelect, onLocaleChange, t } from "./i18n.js?v=20260325-1";
 import {
   createIdentity,
   decodeBase64,

package/dist/web/scripts/i18n.js CHANGED Viewed

@@ -9,20 +9,20 @@ const BUNDLES = {
       brandTagline: "Private rooms for your OpenClaw",
       languageLabel: "Language",
       navGithub: "GitHub",
-      navBetaGroup: "Beta Google Group",
+      navBetaGroup: "Android test group",
       navTelegramGroup: "Telegram group chat",
       heroBadge: "Private • Encrypted • Invite-only",
       heroTitle: "Bring your people into one private OpenClaw room.",
       heroBody:
         "PrivateClaw turns one shared OpenClaw into a beautiful private room for the people you actually trust. Scan once, join instantly, and let the relay carry ciphertext only.",
       heroPrimaryCta: "Open web chat",
-      heroSecondaryCta: "Join the beta group",
+      heroSecondaryCta: "Join Android testing",
       heroDesktopHint:
         "Web chat works on desktop and phone. On desktop, pasting an invite or selecting a saved QR image is usually the fastest way in.",
       heroMobileHint:
         "Web chat works here too, so you can open the PrivateClaw room right away from this phone.",
-      appComingSoon: "iOS public beta + Android closed alpha",
-      iosComingSoon: "Join iOS public beta",
+      appComingSoon: "iPhone App Store + Android closed alpha",
+      iosComingSoon: "Download on the App Store",
       androidComingSoon: "Join Android closed alpha",
       androidBetaNote:
         "Android closed alpha is delivered through Google Play. Join the Google Group first or Play will say the test is unavailable.",
@@ -108,57 +108,71 @@ const BUNDLES = {
           body: "Spin up an invite-only room when you need a focused conversation without dragging people into another public chat silo.",
         },
       ],
-      setupKicker: "Quick setup",
-      setupTitle: "Get the provider ready in five short steps.",
+      desktopDownloadsKicker: "Desktop downloads",
+      desktopDownloadsTitle: "Download the desktop builds from GitHub for now.",
+      desktopDownloadsBody:
+        "Until the desktop store listings are ready, the current Windows, macOS, and Linux builds are published here as direct GitHub release assets.",
+      desktopDownloadsBadge: "GitHub desktop downloads",
+      desktopDownloadWindowsX64: "Windows ZIP",
+      desktopDownloadMacosArm64: "macOS Apple Silicon DMG",
+      desktopDownloadMacosX64: "macOS Intel DMG",
+      desktopDownloadLinuxX64: "Linux x64 tar.gz",
+      desktopDownloadLinuxArm64: "Linux ARM64 tar.gz",
+      desktopDownloadsNote:
+        "These links point to the latest published GitHub desktop release assets. We can switch the site over to native store links later.",
+      setupKicker: "Simple install",
+      setupTitle: "Start with one command. Keep the manual path as backup.",
       setupBody:
-        "If you already run OpenClaw, PrivateClaw is mostly a quick plugin setup. The public relay is already preconfigured, so the relay override is only needed for your own deployment.",
+        "On a fresh machine, the recommended path is the one-command npx wizard. It installs or updates the provider, enables it, restarts the gateway if needed, and starts pairing for you. The longer OpenClaw plugin flow is still here as a backup when you want full control or your own relay from the start.",
       setupSteps: [
         {
-          step: "Step 1",
-          title: "Install the provider",
-          body: "Add the official PrivateClaw plugin from npm.",
-          commands: ["openclaw plugins install @privateclaw/privateclaw@latest"],
+          step: "Recommended",
+          title: "Run the one-command setup wizard",
+          body: "Use this first on a fresh machine. The wizard handles install or update, enables the plugin, confirms the command is ready, and walks you straight into pairing.",
+          commands: ["npx -y @privateclaw/privateclaw@latest"],
+          note: "The wizard will ask whether you want a single chat or group chat, then let you choose a session duration from 30 minutes to permanent. Because it comes from npm directly, it is also the fastest way to pick up a newer npm patch before ClawHub does.",
+          featured: true,
+          variant: "recommended",
         },
         {
-          step: "Step 2",
-          title: "Enable it",
-          body: "Turn the plugin on in your OpenClaw install.",
-          commands: ["openclaw plugins enable privateclaw"],
-        },
-        {
-          step: "Step 3",
-          title: "Optional: use your own relay",
-          body: "Skip this if you are happy with the default public relay at https://relay.privateclaw.us.",
+          step: "Backup",
+          title: "Manually install the plugin if you prefer",
+          body: "Choose this path only when you want to manage OpenClaw yourself or point at your own relay before pairing. Keep `--dangerously-force-unsafe-install` on every manual install path. If you already have a local package directory, prefer installing that directory directly because OpenClaw 2026.3.31 can drop the unsafe-install override on archive installs.",
           commands: [
+            "openclaw plugins install --dangerously-force-unsafe-install @privateclaw/privateclaw@latest",
+            "openclaw plugins install --dangerously-force-unsafe-install ./packages/privateclaw-provider",
+            "openclaw plugins enable privateclaw",
             "openclaw config set plugins.entries.privateclaw.config.relayBaseUrl https://your-relay.example.com",
           ],
+          note: "Skip the relay command if you are happy with the default public relay at https://relay.privateclaw.us. If you intentionally install from ClawHub, also keep the flag: `openclaw plugins install --dangerously-force-unsafe-install clawhub:@privateclaw/privateclaw@latest`.",
+          variant: "fallback",
         },
         {
-          step: "Step 4",
-          title: "Restart the gateway",
-          body: "Restart the running openclaw start process or whichever service hosts your gateway so the new plugin and config are reloaded.",
-        },
-        {
-          step: "Step 5",
-          title: "Generate a QR invite",
-          body: "In any OpenClaw chat channel, create a room invite and let people scan it into PrivateClaw.",
-          commands: ["/privateclaw", "/privateclaw group"],
-          note: "Use `/privateclaw group` when you want multiple people sharing the same room.",
+          step: "Backup",
+          title: "Then restart and pair locally or from chat",
+          body: "If you used the manual path, restart the OpenClaw gateway, then either run the local pairing command or create a room invite from an existing OpenClaw chat channel.",
+          commands: [
+            "openclaw privateclaw pair --open",
+            "/privateclaw",
+            "/privateclaw group",
+          ],
+          note: "Use `openclaw privateclaw pair --group --open` or `/privateclaw group` when you want multiple people sharing the same room.",
+          variant: "fallback",
         },
       ],
-      betaKicker: "Early access",
-      betaTitle: "Join the PrivateClaw beta circle.",
+      betaKicker: "Mobile apps",
+      betaTitle: "Get YourClaw on iPhone. Join Android testing.",
       betaBody:
-        "iOS public beta is live on TestFlight, and Android closed alpha is live on Google Play. Join the Google Group first so Google Play will admit you to the Android test.",
-      betaPrimaryCta: "Join the Google Group",
+        "YourClaw is now live on the App Store for iPhone, and Android closed alpha is live on Google Play. Join the Google Group first so Google Play will admit you to the Android test.",
+      betaPrimaryCta: "Join Android test group",
       betaTelegramCta: "Join the Telegram chat",
       betaFootnote:
-        "Android closed alpha requires Google Group membership first. iOS public beta is open through TestFlight, and Telegram stays open for the early community.",
+        "Android closed alpha still requires Google Group membership first. iPhone users can now download YourClaw on the App Store, and Telegram stays open for the early community.",
       footerLine: "Private rooms, shared OpenClaw, and a calmer way to chat.",
       footerDisclaimer: "PrivateClaw is independent and not affiliated with OpenClaw.",
       footerPrivacy: "Privacy",
       footerTerms: "Terms",
-      footerSupport: "Beta updates live in the Google Group.",
+      footerSupport: "Android testing updates live in the Google Group.",
       footerCopyright: "Copyright GG AI Studio 2026.",
     },
     chat: {
@@ -295,18 +309,18 @@ const BUNDLES = {
       brandTagline: "给 OpenClaw 的私密聊天室",
       languageLabel: "语言",
       navGithub: "GitHub",
-      navBetaGroup: "Google 内测群组",
+      navBetaGroup: "Android 内测群组",
       navTelegramGroup: "Telegram 群聊",
       heroBadge: "私密 • 加密 • 邀请制",
       heroTitle: "把你信任的人带进同一个私密 OpenClaw 房间。",
       heroBody:
         "PrivateClaw 把一套共享的 OpenClaw 变成只属于你们的小房间。扫一次码就能进入，中继只负责转发密文，不读取聊天内容。",
       heroPrimaryCta: "打开网页聊天",
-      heroSecondaryCta: "加入内测群组",
+      heroSecondaryCta: "加入 Android 内测",
       heroDesktopHint: "网页聊天支持桌面和手机访问。在桌面端，直接粘贴邀请或选择一张二维码截图通常是最快的进入方式。",
       heroMobileHint: "网页聊天在手机上也完全可用，你现在就可以直接打开 PrivateClaw 房间。",
-      appComingSoon: "iOS 公开测试 + Android 封闭 alpha",
-      iosComingSoon: "加入 iOS 公开测试",
+      appComingSoon: "iPhone App Store + Android 封闭 alpha",
+      iosComingSoon: "前往 App Store 下载",
       androidComingSoon: "加入 Android 封闭 alpha",
       androidBetaNote:
         "Android 封闭 alpha 通过 Google Play 分发。请先加入 Google 群组，否则 Google Play 会提示你暂时无法参与测试。",
@@ -391,57 +405,71 @@ const BUNDLES = {
           body: "当你需要一个短期、专注、非公开的讨论空间时，随时开一个邀请制房间。",
         },
       ],
-      setupKicker: "快速配置",
-      setupTitle: "五个步骤，把 Provider 准备好。",
+      desktopDownloadsKicker: "桌面下载",
+      desktopDownloadsTitle: "桌面版本现在先从 GitHub 直接下载。",
+      desktopDownloadsBody:
+        "在桌面应用商店版本就绪之前，当前 Windows、macOS 和 Linux 构建会先以 GitHub release 资产的形式直接发布在这里。",
+      desktopDownloadsBadge: "GitHub 桌面下载",
+      desktopDownloadWindowsX64: "Windows ZIP",
+      desktopDownloadMacosArm64: "macOS Apple Silicon DMG",
+      desktopDownloadMacosX64: "macOS Intel DMG",
+      desktopDownloadLinuxX64: "Linux x64 tar.gz",
+      desktopDownloadLinuxArm64: "Linux ARM64 tar.gz",
+      desktopDownloadsNote:
+        "这些链接当前都直接指向最新一次公开的 GitHub 桌面 release 资产。后面如果上了桌面应用商店，再把这里切过去。",
+      setupKicker: "简单安装",
+      setupTitle: "先用一条命令跑起来，复杂安装留作备用。",
       setupBody:
-        "如果你已经在使用 OpenClaw，PrivateClaw 基本就是一次轻量插件配置。默认公共 relay 已经预设好，只有在你想切到自己的部署时，才需要额外写 relay 地址。",
+        "在新机器上，推荐直接使用一条 `npx` 命令启动向导。它会自动安装或更新 Provider、启用插件、在需要时重启网关，然后直接开始配对。只有当你想自己管理 OpenClaw 插件流程，或一开始就切到自己的 relay 时，再走手动模式。",
       setupSteps: [
         {
-          step: "步骤 1",
-          title: "安装 Provider",
-          body: "通过 npm 安装官方 PrivateClaw 插件。",
-          commands: ["openclaw plugins install @privateclaw/privateclaw@latest"],
-        },
-        {
-          step: "步骤 2",
-          title: "启用插件",
-          body: "在你的 OpenClaw 安装里把它打开。",
-          commands: ["openclaw plugins enable privateclaw"],
+          step: "推荐",
+          title: "先运行这一条命令",
+          body: "这是新机器上最快的方式。向导会处理安装或更新、启用插件、确认命令已经就绪，并马上进入配对流程。",
+          commands: ["npx -y @privateclaw/privateclaw@latest"],
+          note: "向导会询问你要单聊还是群聊，并让你选择会话时长：30 分钟、2/4/8/24 小时、1 周、1 个月、1 年或永久。由于它直接使用 npm 包本身，所以如果 npm 上已经有比 ClawHub 更新的 patch，它也是最快拿到最新 patch 的方式。",
+          featured: true,
+          variant: "recommended",
         },
         {
-          step: "步骤 3",
-          title: "可选：切到自己的 relay",
-          body: "如果你直接使用默认公共 relay `https://relay.privateclaw.us`，这一步可以跳过。",
+          step: "备用",
+          title: "如果你想自己掌控，就手动安装",
+          body: "只有在你想手工管理插件，或想一开始就指向自己的 relay 时，才使用这条路径。所有手工安装路径都请保留 `--dangerously-force-unsafe-install`。如果你手边已经有本地 package 目录，优先直接安装这个目录，因为 OpenClaw 2026.3.31 的 archive 安装分支会把 unsafe-install override 丢掉。",
           commands: [
+            "openclaw plugins install --dangerously-force-unsafe-install @privateclaw/privateclaw@latest",
+            "openclaw plugins install --dangerously-force-unsafe-install ./packages/privateclaw-provider",
+            "openclaw plugins enable privateclaw",
             "openclaw config set plugins.entries.privateclaw.config.relayBaseUrl https://your-relay.example.com",
           ],
+          note: "如果你直接使用默认公共 relay `https://relay.privateclaw.us`，第四条可以跳过。如果你明确要走 ClawHub，也同样带上这个 flag：`openclaw plugins install --dangerously-force-unsafe-install clawhub:@privateclaw/privateclaw@latest`。",
+          variant: "fallback",
         },
         {
-          step: "步骤 4",
-          title: "重启网关",
-          body: "重启正在运行的 `openclaw start` 进程，或者你用来托管 gateway 的服务，让插件和配置重新加载。",
-        },
-        {
-          step: "步骤 5",
-          title: "生成二维码邀请",
-          body: "在任意 OpenClaw 聊天渠道里生成房间邀请，然后让大家扫码进入 PrivateClaw。",
-          commands: ["/privateclaw", "/privateclaw group"],
-          note: "如果你想让多人共享同一个房间，就使用 `/privateclaw group`。",
+          step: "备用",
+          title: "然后重启，并从本地或聊天渠道发起配对",
+          body: "如果你走的是手动路径，先重启 OpenClaw gateway，然后要么直接运行本地配对命令，要么在任意现有 OpenClaw 聊天渠道里生成二维码邀请。",
+          commands: [
+            "openclaw privateclaw pair --open",
+            "/privateclaw",
+            "/privateclaw group",
+          ],
+          note: "如果你想让多人共享同一个房间，可以使用 `openclaw privateclaw pair --group --open` 或 `/privateclaw group`。",
+          variant: "fallback",
         },
       ],
-      betaKicker: "抢先体验",
-      betaTitle: "加入 PrivateClaw 内测圈。",
+      betaKicker: "移动应用",
+      betaTitle: "下载 iPhone 版 YourClaw，加入 Android 内测。",
       betaBody:
-        "iOS 公开测试已经在 TestFlight 开放，Android 封闭 alpha 也已经在 Google Play 上线。想参与 Android 测试的话，请先加入 Google 群组。",
-      betaPrimaryCta: "加入 Google 群组",
+        "YourClaw iPhone 版已经在 App Store 正式上线，Android 封闭 alpha 也已经在 Google Play 上线。想参与 Android 测试的话，请先加入 Google 群组。",
+      betaPrimaryCta: "加入 Android 内测群组",
       betaTelegramCta: "加入 Telegram 群聊",
       betaFootnote:
-        "Android 封闭 alpha 需要先加入 Google Group；iOS 公开测试可以直接通过 TestFlight 参与，Telegram 交流群也持续开放。",
+        "Android 封闭 alpha 仍然需要先加入 Google Group；iPhone 用户现在可以直接在 App Store 下载 YourClaw，Telegram 交流群也持续开放。",
       footerLine: "私密房间、共享 OpenClaw、更安静的聊天方式。",
       footerDisclaimer: "PrivateClaw 与 OpenClaw 没有附属关系。",
       footerPrivacy: "隐私",
       footerTerms: "条款",
-      footerSupport: "最新内测动态会发布在 Google 群组。",
+      footerSupport: "Android 内测动态会发布在 Google 群组。",
       footerCopyright: "Copyright GG AI Studio 2026.",
     },
     chat: {
@@ -566,18 +594,18 @@ const BUNDLES = {
       brandTagline: "給 OpenClaw 的私密聊天室",
       languageLabel: "語言",
       navGithub: "GitHub",
-      navBetaGroup: "Google 內測群組",
+      navBetaGroup: "Android 內測群組",
       navTelegramGroup: "Telegram 群聊",
       heroBadge: "私密 • 加密 • 邀請制",
       heroTitle: "把你信任的人帶進同一個私密 OpenClaw 房間。",
       heroBody:
         "PrivateClaw 把一套共享的 OpenClaw 變成只屬於你們的小房間。掃一次碼就能進入，中繼只負責轉送密文，不讀取聊天內容。",
       heroPrimaryCta: "開啟網頁聊天",
-      heroSecondaryCta: "加入內測群組",
+      heroSecondaryCta: "加入 Android 內測",
       heroDesktopHint: "網頁聊天支援桌面與手機。在桌面端，直接貼上邀請，或選擇一張已儲存的 QR 圖片，通常是最快的進入方式。",
       heroMobileHint: "網頁聊天在手機上也完全可用，你現在就可以直接開啟 PrivateClaw 房間。",
-      appComingSoon: "iOS 公開測試 + Android 封閉 alpha",
-      iosComingSoon: "加入 iOS 公開測試",
+      appComingSoon: "iPhone App Store + Android 封閉 alpha",
+      iosComingSoon: "前往 App Store 下載",
       androidComingSoon: "加入 Android 封閉 alpha",
       androidBetaNote:
         "Android 封閉 alpha 透過 Google Play 發放。請先加入 Google 群組，否則 Google Play 會顯示你目前無法參與測試。",
@@ -662,57 +690,71 @@ const BUNDLES = {
           body: "當你需要一個短期、專注、非公開的討論空間時，隨時開一個邀請制房間。",
         },
       ],
-      setupKicker: "快速設定",
-      setupTitle: "五個步驟，把 Provider 準備好。",
+      desktopDownloadsKicker: "桌面下載",
+      desktopDownloadsTitle: "桌面版本現在先從 GitHub 直接下載。",
+      desktopDownloadsBody:
+        "在桌面應用商店版本就緒之前，當前 Windows、macOS 和 Linux 構建會先以 GitHub release 資產的形式直接發布在這裡。",
+      desktopDownloadsBadge: "GitHub 桌面下載",
+      desktopDownloadWindowsX64: "Windows ZIP",
+      desktopDownloadMacosArm64: "macOS Apple Silicon DMG",
+      desktopDownloadMacosX64: "macOS Intel DMG",
+      desktopDownloadLinuxX64: "Linux x64 tar.gz",
+      desktopDownloadLinuxArm64: "Linux ARM64 tar.gz",
+      desktopDownloadsNote:
+        "這些連結目前都直接指向最新一次公開的 GitHub 桌面 release 資產。後面如果上了桌面應用商店，再把這裡切過去。",
+      setupKicker: "簡單安裝",
+      setupTitle: "先用一條命令跑起來，複雜安裝留作備用。",
       setupBody:
-        "如果你已經在使用 OpenClaw，PrivateClaw 基本上只需要一次輕量的外掛設定。預設公共 relay 已經內建，只有當你想切到自己的部署時，才需要額外設定 relay 位址。",
+        "在新機器上，建議直接使用一條 `npx` 指令啟動精靈。它會自動安裝或更新 Provider、啟用外掛、在需要時重新啟動 gateway，然後直接開始配對。只有當你想自己管理 OpenClaw 外掛流程，或一開始就切到自己的 relay 時，再走手動模式。",
       setupSteps: [
         {
-          step: "步驟 1",
-          title: "安裝 Provider",
-          body: "透過 npm 安裝官方 PrivateClaw 外掛。",
-          commands: ["openclaw plugins install @privateclaw/privateclaw@latest"],
-        },
-        {
-          step: "步驟 2",
-          title: "啟用外掛",
-          body: "在你的 OpenClaw 安裝裡把它打開。",
-          commands: ["openclaw plugins enable privateclaw"],
+          step: "建議",
+          title: "先執行這一條指令",
+          body: "這是新機器上最快的方式。精靈會處理安裝或更新、啟用外掛、確認指令已經就緒，並立刻進入配對流程。",
+          commands: ["npx -y @privateclaw/privateclaw@latest"],
+          note: "精靈會詢問你要單聊還是群聊，並讓你選擇會話時長：30 分鐘、2/4/8/24 小時、1 週、1 個月、1 年或永久。由於它直接使用 npm 套件本身，所以如果 npm 上已經有比 ClawHub 更新的 patch，它也是最快拿到最新 patch 的方式。",
+          featured: true,
+          variant: "recommended",
         },
         {
-          step: "步驟 3",
-          title: "可選：切到自己的 relay",
-          body: "如果你直接使用預設公共 relay `https://relay.privateclaw.us`，這一步可以略過。",
+          step: "備用",
+          title: "如果你想自己掌控，就手動安裝",
+          body: "只有在你想手動管理外掛，或想一開始就指向自己的 relay 時，才使用這條路徑。所有手動安裝路徑都請保留 `--dangerously-force-unsafe-install`。如果你手邊已經有本地 package 目錄，優先直接安裝這個目錄，因為 OpenClaw 2026.3.31 的 archive 安裝分支會把 unsafe-install override 丟掉。",
           commands: [
+            "openclaw plugins install --dangerously-force-unsafe-install @privateclaw/privateclaw@latest",
+            "openclaw plugins install --dangerously-force-unsafe-install ./packages/privateclaw-provider",
+            "openclaw plugins enable privateclaw",
             "openclaw config set plugins.entries.privateclaw.config.relayBaseUrl https://your-relay.example.com",
           ],
+          note: "如果你直接使用預設公共 relay `https://relay.privateclaw.us`，第四條可以略過。如果你明確要走 ClawHub，也同樣帶上這個 flag：`openclaw plugins install --dangerously-force-unsafe-install clawhub:@privateclaw/privateclaw@latest`。",
+          variant: "fallback",
         },
         {
-          step: "步驟 4",
-          title: "重新啟動 gateway",
-          body: "重新啟動正在執行的 `openclaw start` 行程，或你用來託管 gateway 的服務，讓外掛與設定重新載入。",
-        },
-        {
-          step: "步驟 5",
-          title: "產生 QR 邀請",
-          body: "在任意 OpenClaw 聊天渠道裡建立房間邀請，然後讓大家掃碼加入 PrivateClaw。",
-          commands: ["/privateclaw", "/privateclaw group"],
-          note: "如果你想讓多人共享同一個房間，就使用 `/privateclaw group`。",
+          step: "備用",
+          title: "然後重新啟動，並從本地或聊天渠道開始配對",
+          body: "如果你走的是手動路徑，先重新啟動 OpenClaw gateway，然後可以直接執行本地配對指令，或在任意既有的 OpenClaw 聊天渠道裡產生 QR 邀請。",
+          commands: [
+            "openclaw privateclaw pair --open",
+            "/privateclaw",
+            "/privateclaw group",
+          ],
+          note: "如果你想讓多人共享同一個房間，可以使用 `openclaw privateclaw pair --group --open` 或 `/privateclaw group`。",
+          variant: "fallback",
         },
       ],
-      betaKicker: "搶先體驗",
-      betaTitle: "加入 PrivateClaw 內測圈。",
+      betaKicker: "行動應用",
+      betaTitle: "下載 iPhone 版 YourClaw，加入 Android 內測。",
       betaBody:
-        "iOS 公開測試已經在 TestFlight 開放，Android 封閉 alpha 也已經在 Google Play 上線。想參與 Android 測試的話，請先加入 Google 群組。",
-      betaPrimaryCta: "加入 Google 群組",
+        "YourClaw iPhone 版已經在 App Store 正式上線，Android 封閉 alpha 也已經在 Google Play 上線。想參與 Android 測試的話，請先加入 Google 群組。",
+      betaPrimaryCta: "加入 Android 內測群組",
       betaTelegramCta: "加入 Telegram 群聊",
       betaFootnote:
-        "Android 封閉 alpha 需要先加入 Google Group；iOS 公開測試可以直接透過 TestFlight 參與，Telegram 群聊也持續開放。",
+        "Android 封閉 alpha 仍然需要先加入 Google Group；iPhone 使用者現在可以直接在 App Store 下載 YourClaw，Telegram 群聊也持續開放。",
       footerLine: "私密房間、共享 OpenClaw、更安靜的聊天方式。",
       footerDisclaimer: "PrivateClaw 與 OpenClaw 沒有附屬關係。",
       footerPrivacy: "隱私",
       footerTerms: "條款",
-      footerSupport: "最新內測動態會發佈在 Google 群組。",
+      footerSupport: "Android 內測動態會發佈在 Google 群組。",
       footerCopyright: "Copyright GG AI Studio 2026.",
     },
     chat: {