@clawling/clawchat-plugin-openclaw 2026.7.8-5 → 2026.7.9-4

package/dist/src/config.js

@@ -353,11 +353,7 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
     const forwardToolCalls = typeof channel.forwardToolCalls === "boolean" ? channel.forwardToolCalls : false;
     const richInteractions = typeof channel.richInteractions === "boolean" ? channel.richInteractions : false;
     const awarenessNote = typeof channel.awarenessNote === "boolean" ? channel.awarenessNote : false;
-    // TEMPORARY default-off: liveware-sample auto-boot is disabled by default
-    // until the template distribution moves off raw.githubusercontent (rate
-    // limiting strands fresh agents). Flip the fallback back to true then.
-    // Explicit `livewareSample: true` in channel config still enables it.
-    const livewareSample = typeof channel.livewareSample === "boolean" ? channel.livewareSample : false;
+    const livewareSample = typeof channel.livewareSample === "boolean" ? channel.livewareSample : true;
     return {
         accountId: DEFAULT_ACCOUNT_ID,
         name: CHANNEL_ID,

package/dist/src/liveware-cli.js

@@ -5,18 +5,18 @@ export const LIVEWARE_BASE_URL = "https://media.clawling.chat/liveware/";
 // A non-default User-Agent is required: the CDN (Cloudflare) returns 403 for
 // known scripting/default UAs, so download requests must identify themselves.
 const LIVEWARE_USER_AGENT = "clawchat-liveware-installer";
-/** Directory where the downloaded binaries live: <stateDir>/clawchat/liveware. */
+/** Directory where the downloaded binary lives: <stateDir>/clawchat/liveware. */
 export function livewareDir(stateDir) {
     const root = stateDir ?? resolveStateDir();
     return path.join(root, "clawchat", "liveware");
 }
-/** Map host platform/arch to the two asset filenames, or null if unsupported. */
+/** Map host platform/arch to the liveware asset filename, or null if unsupported. */
 export function platformAssets(plat = process.platform, arch = process.arch) {
     const os = plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : null;
     const cpu = arch === "x64" ? "amd64" : arch === "arm64" ? "arm64" : null;
     if (!os || !cpu)
         return null;
-    return { liveware: `liveware-${os}-${cpu}`, tunneAgent: `tunnel-agent-${os}-${cpu}` };
+    return { liveware: `liveware-${os}-${cpu}` };
 }
 function findOnPath(name) {
     const raw = process.env.PATH ?? "";
@@ -84,7 +84,6 @@ export async function ensureLivewareCli(opts = {}) {
         }
         await fs.promises.mkdir(dir, { recursive: true });
         await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, "liveware"));
-        await downloadTo(LIVEWARE_BASE_URL + assets.tunneAgent, path.join(dir, "tunnel-agent"));
         log?.debug?.(`clawchat-plugin-openclaw: liveware CLI downloaded to ${dir}`);
     }
     catch (err) {

package/dist/src/liveware-sample.js

@@ -169,11 +169,52 @@ export function parseTunnelPublicUrl(output) {
     }
     return null;
 }
-export async function startTunnel(opts) {
+/**
+ * One-shot upstream registration (CLI v0.0.11+): `tunnel bind` writes the
+ * app→local-upstream mapping to the control plane, prints the binding table
+ * and exits 0. The data plane is carried by the persistent `liveware agent`
+ * daemon (see startTunnelAgent) — bind itself no longer stays running.
+ */
+export async function tunnelBind(opts) {
+    const execFileFn = opts.execFileFn ?? nodeExecFile;
+    const output = await new Promise((resolve, reject) => {
+        execFileFn(opts.livewarePath, ["tunnel", "bind", opts.appId, `http://127.0.0.1:${opts.port}`], { timeout: CLI_TIMEOUT_MS }, (err, out, errOut) => {
+            if (err) {
+                reject(new Error(`liveware tunnel bind failed: ${errOut || out || String(err)}`.trim()));
+                return;
+            }
+            resolve(`${String(out ?? "")}\n${String(errOut ?? "")}`);
+        });
+    });
+    const url = parseTunnelPublicUrl(output);
+    if (!url)
+        throw new Error(`liveware tunnel bind: cannot parse public URL from output: ${output.slice(0, 500)}`);
+    return url;
+}
+const AGENT_READY_MARKER = "relay grpc control connected";
+/**
+ * Match the `liveware agent` ready signal: the daemon logs a JSON line once
+ * its gRPC control channel to the relay is up — only then can the public URL
+ * actually reach the local upstream.
+ */
+export function parseAgentReady(output) {
+    for (const ln of (output ?? "").split("\n")) {
+        if (ln.includes(AGENT_READY_MARKER))
+            return ln;
+    }
+    return null;
+}
+/**
+ * Spawn the persistent `liveware agent` data-plane daemon (CLI v0.0.11+;
+ * replaces the long-lived `tunnel bind` / sibling tunnel-agent binary). It
+ * authenticates from the token saved by `liveware login` and serves every
+ * app bound via `tunnel bind` for that account.
+ */
+export async function startTunnelAgent(opts) {
     const spawnFn = opts.spawnFn ?? nodeSpawn;
-    const child = spawnFn(opts.livewarePath, ["tunnel", "bind", opts.appId, `http://127.0.0.1:${opts.port}`], { stdio: ["ignore", "pipe", "pipe"] });
-    const url = await waitForOutput(child, (acc) => parseTunnelPublicUrl(acc), opts.timeoutMs ?? TUNNEL_START_TIMEOUT_MS, "liveware tunnel bind");
-    return { child, publicUrl: url };
+    const child = spawnFn(opts.livewarePath, ["agent"], { stdio: ["ignore", "pipe", "pipe"] });
+    await waitForOutput(child, (acc) => parseAgentReady(acc), opts.timeoutMs ?? TUNNEL_START_TIMEOUT_MS, "liveware agent start");
+    return { child };
 }
 export async function livewareLogin(opts) {
     const execFileFn = opts.execFileFn ?? nodeExecFile;
@@ -392,21 +433,24 @@ export class LivewareSampleSupervisor {
         const appId = await livewareAppCreate({
             livewarePath, name: LIVEWARE_SAMPLE_APP_NAME, execFileFn: deps.execFileFn,
         });
-        const tunnel = await startTunnel({
-            livewarePath, appId, port: server.port, spawnFn: deps.spawnFn,
+        const publicUrl = await tunnelBind({
+            livewarePath, appId, port: server.port, execFileFn: deps.execFileFn,
         });
-        this.tunnelChild = tunnel.child;
         if (this.bailIfStopped())
             return;
-        await deps.registerApp({ name: LIVEWARE_SAMPLE_APP_NAME, appId, url: tunnel.publicUrl });
+        const agent = await startTunnelAgent({ livewarePath, spawnFn: deps.spawnFn });
+        this.tunnelChild = agent.child;
+        if (this.bailIfStopped())
+            return;
+        await deps.registerApp({ name: LIVEWARE_SAMPLE_APP_NAME, appId, url: publicUrl });
         deps.store.upsertLivewareSample({
             platform: deps.platform, accountId: deps.accountId,
             appId, appName: LIVEWARE_SAMPLE_APP_NAME, port: server.port,
-            publicUrl: tunnel.publicUrl, sampleVersion: version, status: "active",
+            publicUrl, sampleVersion: version, status: "active",
         });
         this.watchChildren();
         await this.deliverIntro();
-        deps.log?.debug?.(`liveware-sample: bootstrap complete at ${tunnel.publicUrl}`);
+        deps.log?.debug?.(`liveware-sample: bootstrap complete at ${publicUrl}`);
     }
     async relaunch(row) {
         const { deps } = this;
@@ -456,21 +500,24 @@ export class LivewareSampleSupervisor {
         this.serverChild = server.child;
         if (this.bailIfStopped())
             return;
-        const tunnel = await startTunnel({
-            livewarePath, appId: row.app_id, port: server.port, spawnFn: deps.spawnFn,
+        const publicUrl = await tunnelBind({
+            livewarePath, appId: row.app_id, port: server.port, execFileFn: deps.execFileFn,
         });
-        this.tunnelChild = tunnel.child;
         if (this.bailIfStopped())
             return;
-        if (tunnel.publicUrl !== row.public_url) {
+        const agent = await startTunnelAgent({ livewarePath, spawnFn: deps.spawnFn });
+        this.tunnelChild = agent.child;
+        if (this.bailIfStopped())
+            return;
+        if (publicUrl !== row.public_url) {
             await deps.registerApp({
-                name: row.app_name, appId: row.app_id, url: tunnel.publicUrl,
+                name: row.app_name, appId: row.app_id, url: publicUrl,
             });
         }
         deps.store.upsertLivewareSample({
             platform: deps.platform, accountId: deps.accountId,
             appId: row.app_id, appName: row.app_name, port: server.port,
-            publicUrl: tunnel.publicUrl, sampleVersion: version, status: "active",
+            publicUrl, sampleVersion: version, status: "active",
         });
         this.watchChildren();
         if (row.intro_sent === 0)

package/package.json

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

package/src/config.ts

@@ -519,12 +519,8 @@ export function resolveOpenclawClawlingAccount(
     typeof channel.richInteractions === "boolean" ? channel.richInteractions : false;
   const awarenessNote =
     typeof channel.awarenessNote === "boolean" ? channel.awarenessNote : false;
-  // TEMPORARY default-off: liveware-sample auto-boot is disabled by default
-  // until the template distribution moves off raw.githubusercontent (rate
-  // limiting strands fresh agents). Flip the fallback back to true then.
-  // Explicit `livewareSample: true` in channel config still enables it.
   const livewareSample =
-    typeof channel.livewareSample === "boolean" ? channel.livewareSample : false;
+    typeof channel.livewareSample === "boolean" ? channel.livewareSample : true;
 
   return {
     accountId: DEFAULT_ACCOUNT_ID,

package/src/liveware-cli.ts

@@ -14,21 +14,21 @@ export type LivewareLogger = {
   error?: (m: string) => void;
 };
 
-/** Directory where the downloaded binaries live: <stateDir>/clawchat/liveware. */
+/** Directory where the downloaded binary lives: <stateDir>/clawchat/liveware. */
 export function livewareDir(stateDir?: string): string {
   const root = stateDir ?? resolveStateDir();
   return path.join(root, "clawchat", "liveware");
 }
 
-/** Map host platform/arch to the two asset filenames, or null if unsupported. */
+/** Map host platform/arch to the liveware asset filename, or null if unsupported. */
 export function platformAssets(
   plat: string = process.platform,
   arch: string = process.arch,
-): { liveware: string; tunneAgent: string } | null {
+): { liveware: string } | null {
   const os = plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : null;
   const cpu = arch === "x64" ? "amd64" : arch === "arm64" ? "arm64" : null;
   if (!os || !cpu) return null;
-  return { liveware: `liveware-${os}-${cpu}`, tunneAgent: `tunnel-agent-${os}-${cpu}` };
+  return { liveware: `liveware-${os}-${cpu}` };
 }
 
 function findOnPath(name: string): string | null {
@@ -98,7 +98,6 @@ export async function ensureLivewareCli(
 
     await fs.promises.mkdir(dir, { recursive: true });
     await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, "liveware"));
-    await downloadTo(LIVEWARE_BASE_URL + assets.tunneAgent, path.join(dir, "tunnel-agent"));
     log?.debug?.(`clawchat-plugin-openclaw: liveware CLI downloaded to ${dir}`);
   } catch (err) {
     log?.warn?.(`clawchat-plugin-openclaw: liveware CLI download skipped: ${String(err)}`);

package/src/liveware-sample.ts

@@ -224,26 +224,73 @@ export function parseTunnelPublicUrl(output: string): string | null {
   return null;
 }
 
-export async function startTunnel(opts: {
+/**
+ * One-shot upstream registration (CLI v0.0.11+): `tunnel bind` writes the
+ * app→local-upstream mapping to the control plane, prints the binding table
+ * and exits 0. The data plane is carried by the persistent `liveware agent`
+ * daemon (see startTunnelAgent) — bind itself no longer stays running.
+ */
+export async function tunnelBind(opts: {
   livewarePath: string;
   appId: string;
   port: number;
+  execFileFn?: ExecFileLike;
+}): Promise<string> {
+  const execFileFn = opts.execFileFn ?? nodeExecFile;
+  const output = await new Promise<string>((resolve, reject) => {
+    execFileFn(
+      opts.livewarePath,
+      ["tunnel", "bind", opts.appId, `http://127.0.0.1:${opts.port}`],
+      { timeout: CLI_TIMEOUT_MS },
+      (err, out, errOut) => {
+        if (err) { reject(new Error(`liveware tunnel bind failed: ${errOut || out || String(err)}`.trim())); return; }
+        resolve(`${String(out ?? "")}\n${String(errOut ?? "")}`);
+      },
+    );
+  });
+  const url = parseTunnelPublicUrl(output);
+  if (!url) throw new Error(`liveware tunnel bind: cannot parse public URL from output: ${output.slice(0, 500)}`);
+  return url;
+}
+
+const AGENT_READY_MARKER = "relay grpc control connected";
+
+/**
+ * Match the `liveware agent` ready signal: the daemon logs a JSON line once
+ * its gRPC control channel to the relay is up — only then can the public URL
+ * actually reach the local upstream.
+ */
+export function parseAgentReady(output: string): string | null {
+  for (const ln of (output ?? "").split("\n")) {
+    if (ln.includes(AGENT_READY_MARKER)) return ln;
+  }
+  return null;
+}
+
+/**
+ * Spawn the persistent `liveware agent` data-plane daemon (CLI v0.0.11+;
+ * replaces the long-lived `tunnel bind` / sibling tunnel-agent binary). It
+ * authenticates from the token saved by `liveware login` and serves every
+ * app bound via `tunnel bind` for that account.
+ */
+export async function startTunnelAgent(opts: {
+  livewarePath: string;
   spawnFn?: SpawnLike;
   timeoutMs?: number;
-}): Promise<{ child: ChildProcess; publicUrl: string }> {
+}): Promise<{ child: ChildProcess }> {
   const spawnFn = opts.spawnFn ?? nodeSpawn;
   const child = spawnFn(
     opts.livewarePath,
-    ["tunnel", "bind", opts.appId, `http://127.0.0.1:${opts.port}`],
+    ["agent"],
     { stdio: ["ignore", "pipe", "pipe"] },
   );
-  const url = await waitForOutput(
+  await waitForOutput(
     child,
-    (acc) => parseTunnelPublicUrl(acc),
+    (acc) => parseAgentReady(acc),
     opts.timeoutMs ?? TUNNEL_START_TIMEOUT_MS,
-    "liveware tunnel bind",
+    "liveware agent start",
   );
-  return { child, publicUrl: url };
+  return { child };
 }
 
 export async function livewareLogin(opts: {
@@ -499,20 +546,22 @@ export class LivewareSampleSupervisor {
     const appId = await livewareAppCreate({
       livewarePath, name: LIVEWARE_SAMPLE_APP_NAME, execFileFn: deps.execFileFn,
     });
-    const tunnel = await startTunnel({
-      livewarePath, appId, port: server.port, spawnFn: deps.spawnFn,
+    const publicUrl = await tunnelBind({
+      livewarePath, appId, port: server.port, execFileFn: deps.execFileFn,
     });
-    this.tunnelChild = tunnel.child;
     if (this.bailIfStopped()) return;
-    await deps.registerApp({ name: LIVEWARE_SAMPLE_APP_NAME, appId, url: tunnel.publicUrl });
+    const agent = await startTunnelAgent({ livewarePath, spawnFn: deps.spawnFn });
+    this.tunnelChild = agent.child;
+    if (this.bailIfStopped()) return;
+    await deps.registerApp({ name: LIVEWARE_SAMPLE_APP_NAME, appId, url: publicUrl });
     deps.store.upsertLivewareSample({
       platform: deps.platform, accountId: deps.accountId,
       appId, appName: LIVEWARE_SAMPLE_APP_NAME, port: server.port,
-      publicUrl: tunnel.publicUrl, sampleVersion: version, status: "active",
+      publicUrl, sampleVersion: version, status: "active",
     });
     this.watchChildren();
     await this.deliverIntro();
-    deps.log?.debug?.(`liveware-sample: bootstrap complete at ${tunnel.publicUrl}`);
+    deps.log?.debug?.(`liveware-sample: bootstrap complete at ${publicUrl}`);
   }
 
   private async relaunch(row: LivewareSampleRow): Promise<void> {
@@ -554,20 +603,22 @@ export class LivewareSampleSupervisor {
     });
     this.serverChild = server.child;
     if (this.bailIfStopped()) return;
-    const tunnel = await startTunnel({
-      livewarePath, appId: row.app_id, port: server.port, spawnFn: deps.spawnFn,
+    const publicUrl = await tunnelBind({
+      livewarePath, appId: row.app_id, port: server.port, execFileFn: deps.execFileFn,
     });
-    this.tunnelChild = tunnel.child;
     if (this.bailIfStopped()) return;
-    if (tunnel.publicUrl !== row.public_url) {
+    const agent = await startTunnelAgent({ livewarePath, spawnFn: deps.spawnFn });
+    this.tunnelChild = agent.child;
+    if (this.bailIfStopped()) return;
+    if (publicUrl !== row.public_url) {
       await deps.registerApp({
-        name: row.app_name, appId: row.app_id, url: tunnel.publicUrl,
+        name: row.app_name, appId: row.app_id, url: publicUrl,
       });
     }
     deps.store.upsertLivewareSample({
       platform: deps.platform, accountId: deps.accountId,
       appId: row.app_id, appName: row.app_name, port: server.port,
-      publicUrl: tunnel.publicUrl, sampleVersion: version, status: "active",
+      publicUrl, sampleVersion: version, status: "active",
     });
     this.watchChildren();
     if (row.intro_sent === 0) await this.deliverIntro();