@clawling/clawchat-plugin-openclaw 2026.7.14-1 → 2026.7.20-1

package/dist/src/clawchat-metadata.js

@@ -123,6 +123,16 @@ function pickUpdatePatch(patchInput, keys) {
     }
     return patch;
 }
+function persistOwnerProfileSafe(persist, owner) {
+    if (!persist)
+        return;
+    try {
+        persist(owner);
+    }
+    catch {
+        // The sqlite cache is advisory — a failed write must not fail the pull.
+    }
+}
 export async function pullOwnerMetadata(params) {
     const getAgent = params.api.getAgentDetail ?? params.api.getAgentProfile;
     if (!getAgent)
@@ -132,7 +142,9 @@ export async function pullOwnerMetadata(params) {
     const data = await getAgent(params.agentId);
     const metadata = ownerMetadataFromAgent(asRecord(data.agent) ?? {}, params);
     if (params.api.getAgentOwner) {
-        addOwnerProfileMetadata(metadata, asRecord(await params.api.getAgentOwner()) ?? {});
+        const owner = asRecord(await params.api.getAgentOwner()) ?? {};
+        persistOwnerProfileSafe(params.persistOwnerProfile, owner);
+        addOwnerProfileMetadata(metadata, owner);
     }
     await writeClawChatMetadata(params.memoryRoot, { targetType: "owner", targetId: "owner" }, metadata);
     return { ok: true, writes: [{ targetType: "owner", targetId: "owner" }], failures: [] };
@@ -275,7 +287,9 @@ export async function updateMetadata(params) {
             accountUserId: params.accountUserId,
         });
         if (params.api.getAgentOwner) {
-            addOwnerProfileMetadata(metadata, asRecord(await params.api.getAgentOwner()) ?? {});
+            const owner = asRecord(await params.api.getAgentOwner()) ?? {};
+            persistOwnerProfileSafe(params.persistOwnerProfile, owner);
+            addOwnerProfileMetadata(metadata, owner);
         }
         await writeClawChatMetadata(params.memoryRoot, { targetType: "owner", targetId: "owner" }, metadata);
         return { ok: true, writes: [{ targetType: "owner", targetId: "owner" }], failures: [], metadata };

package/dist/src/reply-dispatcher.js

@@ -284,7 +284,15 @@ export function createOpenclawClawlingReplyDispatcher(options) {
             log?.info?.(`[${account.accountId}] clawchat-plugin-openclaw outbound media skipped: baseUrl not configured`);
             return [];
         }
-        return await uploadOutboundMedia(urls, { apiClient, runtime, log });
+        const fragments = await uploadOutboundMedia(urls, { apiClient, runtime, log });
+        if (fragments.length < urls.length) {
+            // uploadOutboundMedia drops a failed item with only a log line. A shortfall
+            // means an attachment never reached the media service; surfacing it (parity
+            // with the adapter path in outbound.ts and with the Hermes plugin) stops a
+            // text-only frame from going out and reading as a successful send.
+            throw new Error(`clawchat-plugin-openclaw failed to upload ${urls.length - fragments.length}/${urls.length} outbound media attachment(s); message not sent`);
+        }
+        return fragments;
     }
     // ----- Reply state ------------------------------------------------------
     let reasoningText = "";

package/dist/src/runtime.js

@@ -21,7 +21,7 @@ import { runWithTerminalClawChatSendScope } from "./terminal-send.js";
 import { flushAlignedOutboundQueue, getAlignedOutboundQueueSize, sendOpenclawClawlingText, setAlignedOutboundLogContext, } from "./outbound.js";
 import { formatWsLog } from "./ws-log.js";
 import { createNotifySignalObserver, createProtocolControlHandler, createReconnectTracker } from "./ws-alignment.js";
-import { clawChatDbPathForStateDir, getClawChatStore, } from "./storage.js";
+import { clawChatDbPathForStateDir, getClawChatStore, makeOwnerProfilePersister, } from "./storage.js";
 import { getClawChatGroupPrompt, getClawChatUserPrompt } from "./plugin-prompts.js";
 import { loadClawChatPromptMetadata, renderClawChatProfilePrompt, resolveSenderRelation, } from "./profile-prompt.js";
 import { refreshGroupProfile, syncFirstSeenClawChatProfiles } from "./profile-sync.js";
@@ -1094,6 +1094,10 @@ export async function startOpenclawClawlingGateway(params) {
             log?.error?.(`[${accountId}] clawchat-plugin-openclaw metadata refresh failed source=${options.source} conversation=${conversationId}: ${err instanceof Error ? err.message : String(err)}`);
         }
     };
+    const upsertOwnerProfile = store?.upsertOwnerProfile?.bind(store);
+    const persistOwnerProfile = upsertOwnerProfile
+        ? makeOwnerProfilePersister({ upsertOwnerProfile }, { accountId })
+        : undefined;
     const refreshAgentBehavior = async (options) => {
         try {
             await pullOwnerMetadata({
@@ -1102,6 +1106,7 @@ export async function startOpenclawClawlingGateway(params) {
                 accountUserId: account.userId,
                 accountOwnerUserId: account.ownerUserId,
                 api: getConversationApiClient(),
+                persistOwnerProfile,
             });
         }
         catch (err) {
@@ -1173,6 +1178,7 @@ export async function startOpenclawClawlingGateway(params) {
                 accountUserId: account.userId,
                 accountOwnerUserId: account.ownerUserId,
                 api: getConversationApiClient(),
+                persistOwnerProfile,
             });
             return;
         }
@@ -1183,6 +1189,7 @@ export async function startOpenclawClawlingGateway(params) {
                 accountUserId: account.userId,
                 accountOwnerUserId: account.ownerUserId,
                 api: getConversationApiClient(),
+                persistOwnerProfile,
             });
             return;
         }

package/dist/src/storage.js

@@ -154,6 +154,23 @@ CREATE TABLE IF NOT EXISTS liveware_sample (
   updated_at INTEGER NOT NULL,
   PRIMARY KEY (platform, account_id)
 );
+`,
+    },
+    {
+        version: 9,
+        name: "owner_profile",
+        sql: `
+CREATE TABLE IF NOT EXISTS owner_profile (
+  platform TEXT NOT NULL,
+  account_id TEXT NOT NULL,
+  owner_user_id TEXT,
+  nickname TEXT,
+  avatar_url TEXT,
+  bio TEXT,
+  locale TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (platform, account_id)
+);
 `,
     },
 ];
@@ -495,6 +512,30 @@ export class ClawChatStore {
                 : null;
         }) ?? null;
     }
+    getOwnerProfile(input) {
+        return this.read(() => {
+            const row = this.requireDb()
+                .prepare(`SELECT * FROM owner_profile WHERE platform = ? AND account_id = ?`)
+                .get(input.platform, input.accountId);
+            return row ?? null;
+        }) ?? null;
+    }
+    upsertOwnerProfile(input) {
+        this.write(() => {
+            this.requireDb()
+                .prepare(`INSERT INTO owner_profile
+             (platform, account_id, owner_user_id, nickname, avatar_url, bio, locale, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+           ON CONFLICT(platform, account_id) DO UPDATE SET
+             owner_user_id = excluded.owner_user_id,
+             nickname = excluded.nickname,
+             avatar_url = excluded.avatar_url,
+             bio = excluded.bio,
+             locale = excluded.locale,
+             updated_at = excluded.updated_at`)
+                .run(input.platform, input.accountId, input.ownerUserId ?? null, input.nickname ?? null, input.avatarUrl ?? null, input.bio ?? null, input.locale ?? null, Date.now());
+        });
+    }
     getLivewareSample(input) {
         return this.read(() => {
             const row = this.requireDb()
@@ -701,3 +742,27 @@ export function resetClawChatStoreForTest() {
     singleton?.close();
     singleton = null;
 }
+/**
+ * Bind a persist callback for pullOwnerMetadata/updateMetadata.
+ *
+ * Maps the flat GET /v1/agents/me/owner payload onto the owner_profile
+ * cache row. Missing fields are stored as NULL (never empty strings).
+ */
+export function makeOwnerProfilePersister(store, input) {
+    const text = (value) => {
+        if (value == null)
+            return null;
+        return typeof value === "string" ? value : String(value);
+    };
+    return (owner) => {
+        store.upsertOwnerProfile({
+            platform: input.platform ?? "openclaw",
+            accountId: input.accountId,
+            ownerUserId: text(owner.id),
+            nickname: text(owner.nickname),
+            avatarUrl: text(owner.avatar_url),
+            bio: text(owner.bio),
+            locale: text(owner.locale),
+        });
+    };
+}

package/dist/src/tools.js

@@ -6,7 +6,7 @@ import { resolveLivewarePath } from "./liveware-cli.js";
 import { ClawlingApiError, } from "./api-types.js";
 import { mapGateOutcome } from "./gate-outcome.js";
 import { resolveOpenclawClawlingAccount } from "./config.js";
-import { clawChatDbPathForStateDir, getClawChatStore, } from "./storage.js";
+import { clawChatDbPathForStateDir, getClawChatStore, makeOwnerProfilePersister, } from "./storage.js";
 import { sendOpenclawClawlingMentionMessage } from "./outbound.js";
 import { getOpenclawClawlingClient, } from "./runtime.js";
 import { markTerminalClawChatSend } from "./terminal-send.js";
@@ -612,6 +612,9 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                         accountUserId: account.userId,
                         patch: p.patch,
                         api: built.client,
+                        persistOwnerProfile: makeOwnerProfilePersister(getClawChatStore(), {
+                            accountId: account.accountId,
+                        }),
                     }));
                 }
                 catch (err) {

package/package.json

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

package/src/clawchat-metadata.ts

@@ -190,12 +190,28 @@ function pickUpdatePatch<T extends Record<string, string>>(
   return patch as T;
 }
 
+/** Best-effort last-known-owner-profile cache write; must never break the pull. */
+export type PersistOwnerProfile = (owner: Record<string, unknown>) => void;
+
+function persistOwnerProfileSafe(
+  persist: PersistOwnerProfile | undefined,
+  owner: Record<string, unknown>,
+): void {
+  if (!persist) return;
+  try {
+    persist(owner);
+  } catch {
+    // The sqlite cache is advisory — a failed write must not fail the pull.
+  }
+}
+
 export async function pullOwnerMetadata(params: {
   memoryRoot: string;
   agentId: string;
   accountUserId?: string;
   accountOwnerUserId?: string;
   api: MetadataApi;
+  persistOwnerProfile?: PersistOwnerProfile;
 }): Promise<MetadataPullResult> {
   const getAgent = params.api.getAgentDetail ?? params.api.getAgentProfile;
   if (!getAgent) throw new Error("ClawChat metadata pull requires getAgentDetail");
@@ -203,7 +219,9 @@ export async function pullOwnerMetadata(params: {
   const data = await getAgent(params.agentId);
   const metadata = ownerMetadataFromAgent(asRecord(data.agent) ?? {}, params);
   if (params.api.getAgentOwner) {
-    addOwnerProfileMetadata(metadata, asRecord(await params.api.getAgentOwner()) ?? {});
+    const owner = asRecord(await params.api.getAgentOwner()) ?? {};
+    persistOwnerProfileSafe(params.persistOwnerProfile, owner);
+    addOwnerProfileMetadata(metadata, owner);
   }
   await writeClawChatMetadata(params.memoryRoot, { targetType: "owner", targetId: "owner" }, metadata);
   return { ok: true, writes: [{ targetType: "owner", targetId: "owner" }], failures: [] };
@@ -375,6 +393,7 @@ export async function updateMetadata(params: {
   accountUserId?: string;
   patch: Record<string, unknown>;
   api: MetadataApi;
+  persistOwnerProfile?: PersistOwnerProfile;
 }): Promise<MetadataPushResult> {
   if (params.targetType === "owner") {
     if (!params.agentId) throw new Error("ClawChat owner metadata update requires agentId");
@@ -390,7 +409,9 @@ export async function updateMetadata(params: {
       accountUserId: params.accountUserId,
     });
     if (params.api.getAgentOwner) {
-      addOwnerProfileMetadata(metadata, asRecord(await params.api.getAgentOwner()) ?? {});
+      const owner = asRecord(await params.api.getAgentOwner()) ?? {};
+      persistOwnerProfileSafe(params.persistOwnerProfile, owner);
+      addOwnerProfileMetadata(metadata, owner);
     }
     await writeClawChatMetadata(params.memoryRoot, { targetType: "owner", targetId: "owner" }, metadata);
     return { ok: true, writes: [{ targetType: "owner", targetId: "owner" }], failures: [], metadata };

package/src/reply-dispatcher.ts

@@ -418,7 +418,17 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
       );
       return [];
     }
-    return await uploadOutboundMedia(urls, { apiClient, runtime, log });
+    const fragments = await uploadOutboundMedia(urls, { apiClient, runtime, log });
+    if (fragments.length < urls.length) {
+      // uploadOutboundMedia drops a failed item with only a log line. A shortfall
+      // means an attachment never reached the media service; surfacing it (parity
+      // with the adapter path in outbound.ts and with the Hermes plugin) stops a
+      // text-only frame from going out and reading as a successful send.
+      throw new Error(
+        `clawchat-plugin-openclaw failed to upload ${urls.length - fragments.length}/${urls.length} outbound media attachment(s); message not sent`,
+      );
+    }
+    return fragments;
   }
 
   // ----- Reply state ------------------------------------------------------

package/src/runtime.ts

@@ -62,6 +62,7 @@ import { createNotifySignalObserver, createProtocolControlHandler, createReconne
 import {
   clawChatDbPathForStateDir,
   getClawChatStore,
+  makeOwnerProfilePersister,
   type ClawChatStore,
   type MessageRow,
 } from "./storage.ts";
@@ -118,6 +119,7 @@ type RuntimeConnectionStore = Pick<
       | "getActivationConversation"
       | "getLastResolvedDeviceId"
       | "listRecentGroupMessages"
+      | "upsertOwnerProfile"
     >
   >;
 
@@ -1447,6 +1449,10 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
       );
     }
   };
+  const upsertOwnerProfile = store?.upsertOwnerProfile?.bind(store);
+  const persistOwnerProfile = upsertOwnerProfile
+    ? makeOwnerProfilePersister({ upsertOwnerProfile }, { accountId })
+    : undefined;
   const refreshAgentBehavior = async (options: {
     metadataVersion?: number;
     source: string;
@@ -1459,6 +1465,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
         accountUserId: account.userId,
         accountOwnerUserId: account.ownerUserId,
         api: getConversationApiClient(),
+        persistOwnerProfile,
       });
     } catch (err) {
       log?.error?.(
@@ -1533,6 +1540,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
         accountUserId: account.userId,
         accountOwnerUserId: account.ownerUserId,
         api: getConversationApiClient(),
+        persistOwnerProfile,
       });
       return;
     }
@@ -1543,6 +1551,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
         accountUserId: account.userId,
         accountOwnerUserId: account.ownerUserId,
         api: getConversationApiClient(),
+        persistOwnerProfile,
       });
       return;
     }

package/src/storage.ts

@@ -191,6 +191,27 @@ export type UpdateLivewareSampleStatusInput = {
   lastError?: string | null;
 };
 
+export type OwnerProfileRow = {
+  platform: string;
+  account_id: string;
+  owner_user_id: string | null;
+  nickname: string | null;
+  avatar_url: string | null;
+  bio: string | null;
+  locale: string | null;
+  updated_at: number;
+};
+
+export type OwnerProfileUpsert = {
+  platform: string;
+  accountId: string;
+  ownerUserId?: string | null;
+  nickname?: string | null;
+  avatarUrl?: string | null;
+  bio?: string | null;
+  locale?: string | null;
+};
+
 type Migration = { version: number; name: string; sql: string };
 
 const DB_FILENAME = "clawchat.sqlite";
@@ -345,6 +366,23 @@ CREATE TABLE IF NOT EXISTS liveware_sample (
   updated_at INTEGER NOT NULL,
   PRIMARY KEY (platform, account_id)
 );
+`,
+  },
+  {
+    version: 9,
+    name: "owner_profile",
+    sql: `
+CREATE TABLE IF NOT EXISTS owner_profile (
+  platform TEXT NOT NULL,
+  account_id TEXT NOT NULL,
+  owner_user_id TEXT,
+  nickname TEXT,
+  avatar_url TEXT,
+  bio TEXT,
+  locale TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (platform, account_id)
+);
 `,
   },
 ];
@@ -865,6 +903,43 @@ export class ClawChatStore {
     }) ?? null;
   }
 
+  getOwnerProfile(input: ConversationAccountInput): OwnerProfileRow | null {
+    return this.read(() => {
+      const row = this.requireDb()
+        .prepare(`SELECT * FROM owner_profile WHERE platform = ? AND account_id = ?`)
+        .get(input.platform, input.accountId);
+      return (row as OwnerProfileRow | undefined) ?? null;
+    }) ?? null;
+  }
+
+  upsertOwnerProfile(input: OwnerProfileUpsert): void {
+    this.write(() => {
+      this.requireDb()
+        .prepare(
+          `INSERT INTO owner_profile
+             (platform, account_id, owner_user_id, nickname, avatar_url, bio, locale, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+           ON CONFLICT(platform, account_id) DO UPDATE SET
+             owner_user_id = excluded.owner_user_id,
+             nickname = excluded.nickname,
+             avatar_url = excluded.avatar_url,
+             bio = excluded.bio,
+             locale = excluded.locale,
+             updated_at = excluded.updated_at`,
+        )
+        .run(
+          input.platform,
+          input.accountId,
+          input.ownerUserId ?? null,
+          input.nickname ?? null,
+          input.avatarUrl ?? null,
+          input.bio ?? null,
+          input.locale ?? null,
+          Date.now(),
+        );
+    });
+  }
+
   getLivewareSample(input: ConversationAccountInput): LivewareSampleRow | null {
     return this.read(() => {
       const row = this.requireDb()
@@ -1130,3 +1205,30 @@ export function resetClawChatStoreForTest(): void {
   singleton?.close();
   singleton = null;
 }
+
+/**
+ * Bind a persist callback for pullOwnerMetadata/updateMetadata.
+ *
+ * Maps the flat GET /v1/agents/me/owner payload onto the owner_profile
+ * cache row. Missing fields are stored as NULL (never empty strings).
+ */
+export function makeOwnerProfilePersister(
+  store: { upsertOwnerProfile(input: OwnerProfileUpsert): void },
+  input: { accountId: string; platform?: string },
+): (owner: Record<string, unknown>) => void {
+  const text = (value: unknown): string | null => {
+    if (value == null) return null;
+    return typeof value === "string" ? value : String(value);
+  };
+  return (owner) => {
+    store.upsertOwnerProfile({
+      platform: input.platform ?? "openclaw",
+      accountId: input.accountId,
+      ownerUserId: text(owner.id),
+      nickname: text(owner.nickname),
+      avatarUrl: text(owner.avatar_url),
+      bio: text(owner.bio),
+      locale: text(owner.locale),
+    });
+  };
+}

package/src/tools.ts

@@ -14,6 +14,7 @@ import { resolveOpenclawClawlingAccount } from "./config.ts";
 import {
   clawChatDbPathForStateDir,
   getClawChatStore,
+  makeOwnerProfilePersister,
   type ClawChatStore,
 } from "./storage.ts";
 import { sendOpenclawClawlingMentionMessage } from "./outbound.ts";
@@ -773,6 +774,9 @@ export function registerOpenclawClawlingTools(
                 accountUserId: account.userId,
                 patch: p.patch,
                 api: built.client,
+                persistOwnerProfile: makeOwnerProfilePersister(getClawChatStore(), {
+                  accountId: account.accountId,
+                }),
               }),
             );
           } catch (err) {