@clawling/clawchat-plugin-openclaw 2026.7.6-4 → 2026.7.8-2

package/dist/src/liveware-sample.js

@@ -258,6 +258,9 @@ const RESTART_WINDOW_MS = 30 * 60 * 1000;
 const MAX_RESTARTS_PER_WINDOW = 5;
 const INTRO_RETRY_DELAY_MS = 30_000;
 const INTRO_MAX_TRIES = 20;
+// Backoff for transient start() failures (template CDN 429s, network blips):
+// a one-shot bootstrap would otherwise stay dormant until the next restart.
+const START_RETRY_DELAYS_MS = [30_000, 60_000, 120_000, 300_000];
 export class LivewareSampleSupervisor {
     deps;
     serverChild = null;
@@ -272,12 +275,22 @@ export class LivewareSampleSupervisor {
     constructor(deps) {
         this.deps = deps;
     }
-    /** Entry point. Never throws; every failure is logged + persisted only. */
+    /** Entry point. Never throws; every failure is logged + persisted only.
+     * Transient failures are retried on the START_RETRY_DELAYS_MS backoff. */
     async start() {
+        await this.startAttempt(0);
+    }
+    async startAttempt(attempt) {
         const { deps } = this;
         try {
             if (!deps.enabled)
                 return;
+            // ensureLivewareCli downloads the CLI asynchronously on first boot;
+            // gate the whole flow on it or resolveLivewarePath() below races to null.
+            if (deps.cliReady)
+                await deps.cliReady;
+            if (this.stopped)
+                return;
             const key = { platform: deps.platform, accountId: deps.accountId };
             const row = deps.store.getLivewareSample(key);
             if (row?.status === "disabled")
@@ -293,7 +306,13 @@ export class LivewareSampleSupervisor {
             // A mid-flow failure (e.g. registerApp rejected) may have left children
             // running without a persisted row — never leak orphan processes.
             this.killChildren();
-            deps.log?.warn?.(`clawchat-plugin-openclaw liveware-sample start failed: ${String(err)}`);
+            const delayMs = START_RETRY_DELAYS_MS[attempt];
+            if (delayMs === undefined || this.stopped) {
+                deps.log?.warn?.(`clawchat-plugin-openclaw liveware-sample start failed (attempt ${attempt + 1}, giving up): ${String(err)}`);
+                return;
+            }
+            deps.log?.warn?.(`clawchat-plugin-openclaw liveware-sample start failed (attempt ${attempt + 1}, retrying in ${delayMs / 1000}s): ${String(err)}`);
+            this.schedule(() => { void this.startAttempt(attempt + 1); }, delayMs);
         }
     }
     stop() {
@@ -336,7 +355,7 @@ export class LivewareSampleSupervisor {
             return;
         const livewarePath = deps.resolveLivewarePath();
         if (!livewarePath) {
-            deps.log?.debug?.("liveware-sample: liveware CLI not ready; skip");
+            deps.log?.warn?.("liveware-sample: liveware CLI not ready; skip");
             return;
         }
         const token = deps.resolveToken();
@@ -395,7 +414,7 @@ export class LivewareSampleSupervisor {
             return;
         const livewarePath = deps.resolveLivewarePath();
         if (!livewarePath) {
-            deps.log?.debug?.("liveware-sample: liveware CLI not ready; skip relaunch");
+            deps.log?.warn?.("liveware-sample: liveware CLI not ready; skip relaunch");
             return;
         }
         // The user deleting the app tile is an explicit opt-out — never reinstall.

package/dist/src/runtime.js

@@ -668,7 +668,9 @@ export async function startOpenclawClawlingGateway(params) {
         log,
     });
     // Ensure the liveware CLI is installed (async, never blocks startup).
-    void ensureLivewareCli({
+    // Keep the promise: the liveware-sample supervisor must await it, or a
+    // first boot races the download, sees no CLI, and silently skips forever.
+    const livewareCliReady = ensureLivewareCli({
         stateDir: runtime.state?.resolveStateDir?.(),
         log: {
             warn: (m) => log?.info?.(m),
@@ -800,6 +802,7 @@ export async function startOpenclawClawlingGateway(params) {
             sampleRoot: path.join(stateDirForSample ?? "", "clawchat", "liveware-sample"),
             resolveToken: () => account.token ?? "",
             resolveLivewarePath: () => resolveLivewarePath(stateDirForSample),
+            cliReady: livewareCliReady,
             listApps: async () => {
                 const client = getConversationApiClient();
                 return await client.listApps();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.7.6-4",
+  "version": "2026.7.8-2",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "author": "CLAWLING PTE. LTD.",

package/src/liveware-sample.ts

@@ -349,6 +349,10 @@ export type LivewareSampleSupervisorDeps = {
   sampleRoot: string;
   resolveToken: () => string;
   resolveLivewarePath: () => string | null;
+  /** Settles when the liveware CLI self-download has finished (either way).
+   * start() awaits it before the CLI gate so a first boot doesn't lose the
+   * race against ensureLivewareCli and silently skip forever. */
+  cliReady?: Promise<void>;
   listApps: () => Promise<{ apps: { app_id?: string }[] }>;
   registerApp: (p: { name: string; appId: string; url: string }) => Promise<unknown>;
   notifyOwner: (text: string) => Promise<boolean>;
@@ -370,6 +374,9 @@ const RESTART_WINDOW_MS = 30 * 60 * 1000;
 const MAX_RESTARTS_PER_WINDOW = 5;
 const INTRO_RETRY_DELAY_MS = 30_000;
 const INTRO_MAX_TRIES = 20;
+// Backoff for transient start() failures (template CDN 429s, network blips):
+// a one-shot bootstrap would otherwise stay dormant until the next restart.
+const START_RETRY_DELAYS_MS = [30_000, 60_000, 120_000, 300_000];
 
 export class LivewareSampleSupervisor {
   private readonly deps: LivewareSampleSupervisorDeps;
@@ -387,11 +394,20 @@ export class LivewareSampleSupervisor {
     this.deps = deps;
   }
 
-  /** Entry point. Never throws; every failure is logged + persisted only. */
+  /** Entry point. Never throws; every failure is logged + persisted only.
+   * Transient failures are retried on the START_RETRY_DELAYS_MS backoff. */
   async start(): Promise<void> {
+    await this.startAttempt(0);
+  }
+
+  private async startAttempt(attempt: number): Promise<void> {
     const { deps } = this;
     try {
       if (!deps.enabled) return;
+      // ensureLivewareCli downloads the CLI asynchronously on first boot;
+      // gate the whole flow on it or resolveLivewarePath() below races to null.
+      if (deps.cliReady) await deps.cliReady;
+      if (this.stopped) return;
       const key = { platform: deps.platform, accountId: deps.accountId };
       const row = deps.store.getLivewareSample(key);
       if (row?.status === "disabled") return;
@@ -404,7 +420,17 @@ export class LivewareSampleSupervisor {
       // A mid-flow failure (e.g. registerApp rejected) may have left children
       // running without a persisted row — never leak orphan processes.
       this.killChildren();
-      deps.log?.warn?.(`clawchat-plugin-openclaw liveware-sample start failed: ${String(err)}`);
+      const delayMs = START_RETRY_DELAYS_MS[attempt];
+      if (delayMs === undefined || this.stopped) {
+        deps.log?.warn?.(
+          `clawchat-plugin-openclaw liveware-sample start failed (attempt ${attempt + 1}, giving up): ${String(err)}`,
+        );
+        return;
+      }
+      deps.log?.warn?.(
+        `clawchat-plugin-openclaw liveware-sample start failed (attempt ${attempt + 1}, retrying in ${delayMs / 1000}s): ${String(err)}`,
+      );
+      this.schedule(() => { void this.startAttempt(attempt + 1); }, delayMs);
     }
   }
 
@@ -444,7 +470,7 @@ export class LivewareSampleSupervisor {
     const { deps } = this;
     if (this.stopped) return;
     const livewarePath = deps.resolveLivewarePath();
-    if (!livewarePath) { deps.log?.debug?.("liveware-sample: liveware CLI not ready; skip"); return; }
+    if (!livewarePath) { deps.log?.warn?.("liveware-sample: liveware CLI not ready; skip"); return; }
     const token = deps.resolveToken();
     if (!token) { deps.log?.debug?.("liveware-sample: no token; skip"); return; }
     let apps: { apps: { app_id?: string }[] };
@@ -493,7 +519,7 @@ export class LivewareSampleSupervisor {
     const { deps } = this;
     if (this.stopped) return;
     const livewarePath = deps.resolveLivewarePath();
-    if (!livewarePath) { deps.log?.debug?.("liveware-sample: liveware CLI not ready; skip relaunch"); return; }
+    if (!livewarePath) { deps.log?.warn?.("liveware-sample: liveware CLI not ready; skip relaunch"); return; }
     // The user deleting the app tile is an explicit opt-out — never reinstall.
     try {
       const apps = await deps.listApps();

package/src/runtime.ts

@@ -981,7 +981,9 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
     log,
   });
   // Ensure the liveware CLI is installed (async, never blocks startup).
-  void ensureLivewareCli({
+  // Keep the promise: the liveware-sample supervisor must await it, or a
+  // first boot races the download, sees no CLI, and silently skips forever.
+  const livewareCliReady = ensureLivewareCli({
     stateDir: runtime.state?.resolveStateDir?.(),
     log: {
       warn: (m) => log?.info?.(m),
@@ -1118,6 +1120,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
       sampleRoot: path.join(stateDirForSample ?? "", "clawchat", "liveware-sample"),
       resolveToken: () => account.token ?? "",
       resolveLivewarePath: () => resolveLivewarePath(stateDirForSample),
+      cliReady: livewareCliReady,
       listApps: async () => {
         const client = getConversationApiClient();
         return await client.listApps();