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

package/dist/src/liveware-sample.js

@@ -278,6 +278,12 @@ export class LivewareSampleSupervisor {
         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")
@@ -336,7 +342,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 +401,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-1",
   "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>;
@@ -392,6 +396,10 @@ export class LivewareSampleSupervisor {
     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;
@@ -444,7 +452,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 +501,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();