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

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 };
 }
@@ -291,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;
@@ -425,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())
@@ -496,6 +501,7 @@ 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())

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-4",
+  "version": "2026.7.10-1",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "author": "CLAWLING PTE. LTD.",

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,
@@ -396,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. */
@@ -412,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;
@@ -539,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;
@@ -600,6 +605,7 @@ 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;

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 () => {