@clawling/clawchat-plugin-openclaw 2026.7.9-1 → 2026.7.10-1

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-sample.js

@@ -144,7 +144,10 @@ function waitForOutput(child, match, timeoutMs, label) {
 }
 export async function startSampleServer(opts) {
     const spawnFn = opts.spawnFn ?? nodeSpawn;
-    const child = spawnFn(process.execPath, [path.join(opts.appDir, "server.mjs"), "--dir", opts.appDir, "--port", String(opts.port)], { stdio: ["ignore", "pipe", "pipe"] });
+    const args = [path.join(opts.appDir, "server.mjs"), "--dir", opts.appDir, "--port", String(opts.port)];
+    if (opts.agentUserId)
+        args.push("--agent-id", opts.agentUserId);
+    const child = spawnFn(process.execPath, args, { stdio: ["ignore", "pipe", "pipe"] });
     const line = await waitForOutput(child, (acc) => acc.split("\n").find((l) => l.trim().startsWith('{"port"')) ?? null, opts.timeoutMs ?? SERVER_START_TIMEOUT_MS, "liveware-sample server start");
     return { child, port: JSON.parse(line).port };
 }
@@ -169,11 +172,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;
@@ -250,8 +294,9 @@ export async function livewareAppCreate(opts) {
         throw new Error(`liveware app create: cannot parse app id from output: ${stdout.slice(0, 500)}`);
     return appId;
 }
-export const LIVEWARE_SAMPLE_INTRO_TEXT = "我给你安装了一个 liveware 演示应用「Liveware Sample」，它已经出现在我们的聊天里。" +
-    "点开它看看，然后试试对我说：把标题改成 Hello Liveware。" +
+export const LIVEWARE_SAMPLE_INTRO_TEXT = "我给你安装了一个 liveware 演示应用「Liveware Sample」。" +
+    "入口：在我们的对话页面，点右上角的「应用」按钮（✦），在打开的面板里选名为「Liveware Sample」的应用。" +
+    "页面上有完整的使用引导，试试对我说：把标题改成 Hello Liveware。" +
     "你在页面上点的按钮、提交的留言我也能看到，随时问我。";
 const DEFAULT_SAMPLE_PORT = 43110;
 const RESTART_WINDOW_MS = 30 * 60 * 1000;
@@ -384,6 +429,7 @@ export class LivewareSampleSupervisor {
             return;
         const server = await startSampleServer({
             appDir, port: DEFAULT_SAMPLE_PORT, spawnFn: deps.spawnFn,
+            agentUserId: deps.resolveAgentUserId?.() ?? null,
         });
         this.serverChild = server.child;
         if (this.bailIfStopped())
@@ -392,21 +438,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;
@@ -452,25 +501,29 @@ export class LivewareSampleSupervisor {
             return;
         const server = await startSampleServer({
             appDir, port: row.port || DEFAULT_SAMPLE_PORT, spawnFn: deps.spawnFn,
+            agentUserId: deps.resolveAgentUserId?.() ?? null,
         });
         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/dist/src/runtime.js

@@ -801,6 +801,7 @@ export async function startOpenclawClawlingGateway(params) {
             store: store,
             sampleRoot: path.join(stateDirForSample ?? "", "clawchat", "liveware-sample"),
             resolveToken: () => account.token ?? "",
+            resolveAgentUserId: () => account.userId ?? null,
             resolveLivewarePath: () => resolveLivewarePath(stateDirForSample),
             cliReady: livewareCliReady,
             listApps: async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.7.9-1",
+  "version": "2026.7.10-1",
   "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-sample.ts

@@ -183,15 +183,14 @@ function waitForOutput(
 export async function startSampleServer(opts: {
   appDir: string;
   port: number;
+  agentUserId?: string | null;
   spawnFn?: SpawnLike;
   timeoutMs?: number;
 }): Promise<{ child: ChildProcess; port: number }> {
   const spawnFn = opts.spawnFn ?? nodeSpawn;
-  const child = spawnFn(
-    process.execPath,
-    [path.join(opts.appDir, "server.mjs"), "--dir", opts.appDir, "--port", String(opts.port)],
-    { stdio: ["ignore", "pipe", "pipe"] },
-  );
+  const args = [path.join(opts.appDir, "server.mjs"), "--dir", opts.appDir, "--port", String(opts.port)];
+  if (opts.agentUserId) args.push("--agent-id", opts.agentUserId);
+  const child = spawnFn(process.execPath, args, { stdio: ["ignore", "pipe", "pipe"] });
   const line = await waitForOutput(
     child,
     (acc) => acc.split("\n").find((l) => l.trim().startsWith('{"port"')) ?? null,
@@ -224,26 +223,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: {
@@ -349,6 +395,10 @@ export type LivewareSampleSupervisorDeps = {
   sampleRoot: string;
   resolveToken: () => string;
   resolveLivewarePath: () => string | null;
+  /** The agent's own ClawChat user id (`usr_…`) — minted into the sample
+   * page's back-to-chat deep link. Read at spawn time; null/absent → the
+   * page renders its text fallback instead of the link. */
+  resolveAgentUserId?: () => 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. */
@@ -365,8 +415,9 @@ export type LivewareSampleSupervisorDeps = {
 };
 
 export const LIVEWARE_SAMPLE_INTRO_TEXT =
-  "我给你安装了一个 liveware 演示应用「Liveware Sample」，它已经出现在我们的聊天里。" +
-  "点开它看看，然后试试对我说：把标题改成 Hello Liveware。" +
+  "我给你安装了一个 liveware 演示应用「Liveware Sample」。" +
+  "入口：在我们的对话页面，点右上角的「应用」按钮（✦），在打开的面板里选名为「Liveware Sample」的应用。" +
+  "页面上有完整的使用引导，试试对我说：把标题改成 Hello Liveware。" +
   "你在页面上点的按钮、提交的留言我也能看到，随时问我。";
 
 const DEFAULT_SAMPLE_PORT = 43110;
@@ -492,6 +543,7 @@ export class LivewareSampleSupervisor {
     if (this.bailIfStopped()) return;
     const server = await startSampleServer({
       appDir, port: DEFAULT_SAMPLE_PORT, spawnFn: deps.spawnFn,
+      agentUserId: deps.resolveAgentUserId?.() ?? null,
     });
     this.serverChild = server.child;
     if (this.bailIfStopped()) return;
@@ -499,20 +551,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> {
@@ -551,23 +605,26 @@ export class LivewareSampleSupervisor {
     if (this.bailIfStopped()) return;
     const server = await startSampleServer({
       appDir, port: row.port || DEFAULT_SAMPLE_PORT, spawnFn: deps.spawnFn,
+      agentUserId: deps.resolveAgentUserId?.() ?? null,
     });
     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();

package/src/runtime.ts

@@ -1119,6 +1119,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
       store: store as unknown as LivewareSampleStoreLike,
       sampleRoot: path.join(stateDirForSample ?? "", "clawchat", "liveware-sample"),
       resolveToken: () => account.token ?? "",
+      resolveAgentUserId: () => account.userId ?? null,
       resolveLivewarePath: () => resolveLivewarePath(stateDirForSample),
       cliReady: livewareCliReady,
       listApps: async () => {