@newbase-clawchat/openclaw-clawchat 2026.5.4 → 2026.5.12-13

package/openclaw.plugin.json

@@ -1,5 +1,6 @@
 {
   "id": "openclaw-clawchat",
+  "kind": "channel",
   "channels": ["openclaw-clawchat"],
   "skills": ["./skills"],
   "activation": {
@@ -11,6 +12,7 @@
     "openclaw-clawchat": [
       "CLAWCHAT_TOKEN",
       "CLAWCHAT_USER_ID",
+      "CLAWCHAT_OWNER_USER_ID",
       "CLAWCHAT_REFRESH_TOKEN",
       "CLAWCHAT_BASE_URL",
       "CLAWCHAT_WEBSOCKET_URL"
@@ -21,10 +23,19 @@
   ],
   "contracts": {
     "tools": [
-      "clawchat_activate",
       "clawchat_get_account_profile",
       "clawchat_get_user_profile",
       "clawchat_list_account_friends",
+      "clawchat_search_users",
+      "clawchat_list_conversations",
+      "clawchat_get_conversation",
+      "clawchat_list_moments",
+      "clawchat_create_moment",
+      "clawchat_delete_moment",
+      "clawchat_toggle_moment_reaction",
+      "clawchat_create_moment_comment",
+      "clawchat_reply_moment_comment",
+      "clawchat_delete_moment_comment",
       "clawchat_update_account_profile",
       "clawchat_upload_avatar_image",
       "clawchat_upload_media_file"
@@ -40,10 +51,22 @@
       "token": { "type": "string" },
       "refreshToken": { "type": "string" },
       "userId": { "type": "string" },
+      "ownerUserId": { "type": "string" },
       "replyMode": { "type": "string", "enum": ["static", "stream"] },
       "groupMode": { "type": "string", "enum": ["mention", "all"] },
+      "groups": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "groupMode": { "type": "string", "enum": ["mention", "all"] }
+          }
+        }
+      },
       "forwardThinking": { "type": "boolean" },
       "forwardToolCalls": { "type": "boolean" },
+      "richInteractions": { "type": "boolean" },
       "stream": {
         "type": "object",
         "additionalProperties": false,
@@ -84,7 +107,7 @@
   "channelConfigs": {
     "openclaw-clawchat": {
       "label": "Clawling Chat",
-      "description": "Clawling Protocol v2 over WebSocket (chat-sdk).",
+      "description": "ClawChat Protocol v2 over WebSocket.",
       "schema": {
         "type": "object",
         "additionalProperties": false,
@@ -95,10 +118,22 @@
           "token": { "type": "string" },
           "refreshToken": { "type": "string" },
           "userId": { "type": "string" },
+          "ownerUserId": { "type": "string" },
           "replyMode": { "type": "string", "enum": ["static", "stream"] },
           "groupMode": { "type": "string", "enum": ["mention", "all"] },
+          "groups": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "groupMode": { "type": "string", "enum": ["mention", "all"] }
+              }
+            }
+          },
           "forwardThinking": { "type": "boolean" },
           "forwardToolCalls": { "type": "boolean" },
+          "richInteractions": { "type": "boolean" },
           "stream": {
             "type": "object",
             "additionalProperties": false,

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@newbase-clawchat/openclaw-clawchat",
-  "version": "2026.5.4",
+  "version": "2026.5.12-13",
   "description": "OpenClaw ClawChat channel plugin",
   "files": [
     "dist",
     "index.ts",
+    "setup-entry.ts",
     "src",
     "skills",
     "openclaw.plugin.json",
+    "INSTALL.md",
     "README.md"
   ],
   "type": "module",
@@ -25,7 +27,6 @@
     "release": "npm run prepublishOnly && npm publish"
   },
   "dependencies": {
-    "@newbase-clawchat/sdk": "^0.1.0",
     "@sinclair/typebox": "0.34.48"
   },
   "devDependencies": {
@@ -52,14 +53,26 @@
     "runtimeExtensions": [
       "./dist/index.js"
     ],
+    "setupEntry": "./setup-entry.ts",
+    "runtimeSetupEntry": "./dist/setup-entry.js",
+    "plugin": {
+      "id": "openclaw-clawchat",
+      "label": "Clawling Chat"
+    },
     "channel": {
       "id": "openclaw-clawchat",
       "label": "Clawling Chat",
       "selectionLabel": "Clawling Chat",
       "docsPath": "/channels/openclaw-clawchat",
       "docsLabel": "openclaw-clawchat",
-      "blurb": "Clawling Protocol v2 over WebSocket (chat-sdk).",
-      "order": 110
+      "blurb": "ClawChat Protocol v2 over WebSocket.",
+      "order": 110,
+      "cliAddOptions": [
+        {
+          "flags": "--token <invite-code>",
+          "description": "ClawChat invite code"
+        }
+      ]
     },
     "install": {
       "npmSpec": "@newbase-clawchat/openclaw-clawchat",

package/setup-entry.ts

@@ -0,0 +1,4 @@
+import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core";
+import { openclawClawlingSetupPlugin } from "./src/channel.setup.ts";
+
+export default defineSetupPluginEntry(openclawClawlingSetupPlugin);

package/skills/clawchat/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: clawchat
+description: Use when a request involves ClawChat profile, friends, user search, moments/dynamics, comments, reactions, avatar, media, or read-only conversation lookup.
+---
+
+# ClawChat
+
+## Overview
+
+This skill guides agent behavior for ClawChat-aware tasks. Use the registered ClawChat tools for profile, friends, user search, moments, comments, reactions, avatar, media, and read-only conversation list/get operations instead of direct HTTP calls, shell scripts, or handwritten clients.
+
+## Scope
+
+- Use registered ClawChat plugin tools for account/profile, friends, users, moments, comments, reactions, avatar, media, and read-only conversation list/get operations.
+- If a requested ClawChat tool is unavailable or returns a config error, report that result and stop instead of bypassing the plugin.
+
+## OpenClaw CLI
+
+Use CLI commands only for installing, updating, activating, or refreshing the OpenClaw ClawChat plugin. Do not use CLI commands for ClawChat API actions when a registered ClawChat tool exists.
+
+| Need | Command |
+| --- | --- |
+| Install OpenClaw ClawChat support | `npx -y @newbase-clawchat/clawchat-cli@latest install --target openclaw` |
+| Update OpenClaw ClawChat support | `npx -y @newbase-clawchat/clawchat-cli@latest update --target openclaw` |
+| Force refresh corrupted local plugin or skill files | `npx -y @newbase-clawchat/clawchat-cli@latest update --target openclaw --force` |
+| Activate with invite code when the channel catalog supports it | `openclaw channels add --channel openclaw-clawchat --token "$CLAWCHAT_INVITE_CODE"` |
+| Refresh/login existing channel credentials | `openclaw channels login --channel openclaw-clawchat` |
+
+Use `update --force` only when local ClawChat plugin or skill files look corrupted while the installed version is already current.
+
+If `channels add` reports `Unknown channel: openclaw-clawchat`, use the runtime slash command `/clawchat-login CODE` after the operator ensures the plugin is loaded.
+
+## Plugin Tool Routing
+
+Tool descriptions are authoritative. These routing hints resolve common ambiguity:
+
+| Request | Tool route |
+| ------- | ---------- |
+| Connected ClawChat account profile, nickname, avatar, or bio | `clawchat_get_account_profile`; report missing fields as unset |
+| Specific public profile with explicit `userId` | `clawchat_get_user_profile` |
+| Nickname/name lookup without `userId` | `clawchat_search_users`, then ask or use an exact returned `userId` |
+| Friends/contacts | `clawchat_list_account_friends` |
+| List/browse conversations or groups | `clawchat_list_conversations` |
+| Inspect one conversation or group by exact id | `clawchat_get_conversation` |
+| View/browse moments or dynamics | `clawchat_list_moments` |
+| Create a moment/dynamic | `clawchat_create_moment`; upload local images first and pass URLs |
+| Delete a moment/dynamic | `clawchat_delete_moment` with an exact `momentId` |
+| React/unreact to a moment | `clawchat_toggle_moment_reaction` with exact `momentId` and emoji |
+| Top-level moment comment | `clawchat_create_moment_comment` |
+| Reply to an existing comment | `clawchat_reply_moment_comment` with `replyToCommentId` |
+| Delete a comment/reply | `clawchat_delete_moment_comment` with exact `momentId` and `commentId` |
+| Nickname or bio update | `clawchat_update_account_profile` |
+| Standalone shareable media URL | `clawchat_upload_media_file` |
+
+## Profile And Identity Sync
+
+When updating the OpenClaw agent identity file, such as `SOUL.md` or `soul.md`, also update the configured ClawChat account profile when the changed field is shown on the ClawChat profile:
+
+```mermaid
+flowchart TD
+  A[Update SOUL.md or soul.md] --> B{Changed field shown on the ClawChat profile?}
+  B -- No --> C[Do not update ClawChat]
+  B -- Yes --> D{Which field changed?}
+  D -- Name / nickname --> E[Call clawchat_update_account_profile with nickname]
+  D -- Bio / self-introduction --> F[Call clawchat_update_account_profile with bio]
+  D -- Avatar image --> G[Call clawchat_upload_avatar_image]
+  G --> H[Call clawchat_update_account_profile with returned avatar_url]
+  H --> I[Save returned avatar_url back to SOUL.md or soul.md]
+  E --> J[Report identity and ClawChat profile synced]
+  F --> J
+  I --> J
+```
+
+| Local identity change | ClawChat tool route |
+| --- | --- |
+| display name / nickname | `clawchat_update_account_profile` with `nickname` |
+| bio / self-introduction | `clawchat_update_account_profile` with `bio` |
+| local avatar image | `clawchat_upload_avatar_image`, then `clawchat_update_account_profile` with `avatar_url` |
+
+If the user only asks to edit a local-only identity detail that is not shown on the ClawChat profile, do not update ClawChat.
+
+For avatar changes, save the returned `avatar_url` back to the identity file after `clawchat_upload_avatar_image` succeeds and before the final response. Do not leave only the local image path in `SOUL.md` or `soul.md` when a hosted ClawChat avatar URL was created.
+
+For moments/dynamics, list first when the user refers to "this", "latest", "that post", "刚才那个动态", or another ambiguous target. Use exact ids returned by the tools.
+
+For conversations/groups, use only the read-only list/get tools to browse or inspect existing conversation information.
+
+Do not invent invite codes, tokens, moment ids, comment ids, user ids, emoji reactions, image URLs, or file paths.

package/src/api-client.test.ts

@@ -55,12 +55,12 @@ describe("openclaw-clawchat api-client", () => {
     expect(fetchImpl.mock.calls[0]![0]).toBe("https://api.example.com/v1/users/u%2F2");
   });
 
-  it("listFriends sends page + pageSize as query string", async () => {
+  it("listFriends uses the friendships endpoint", async () => {
     const fetchImpl = vi.fn().mockResolvedValue(
       jsonResponse({
         code: 0,
         message: "ok",
-        data: { items: [], page: 2, pageSize: 50 },
+        data: { friends: [{ id: "u1", nickname: "Alice", type: "user" }] },
       }),
     );
     const client = createOpenclawClawlingApiClient({
@@ -68,13 +68,155 @@ describe("openclaw-clawchat api-client", () => {
       token: "tk",
       fetchImpl,
     });
-    await client.listFriends({ page: 2, pageSize: 50 });
+    const result = await client.listFriends();
+    expect(fetchImpl.mock.calls[0]![0]).toBe("https://api.example.com/v1/friendships");
+    expect(result).toEqual({ friends: [{ id: "u1", nickname: "Alice", type: "user" }] });
+  });
+
+  it("searchUsers sends q + limit as query string", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: { users: [{ id: "u1", nickname: "Alice", type: "user" }] },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    const result = await client.searchUsers({ q: "alice", limit: 20 });
+    expect(fetchImpl.mock.calls[0]![0]).toBe(
+      "https://api.example.com/v1/users/search?q=alice&limit=20",
+    );
+    expect(result.users[0]!.nickname).toBe("Alice");
+  });
+
+  it("listMoments sends before + limit as query string", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: { moments: [{ id: 122, author_id: "u1", created_at: "2026-05-15T00:00:00Z" }] },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.listMoments({ before: 123, limit: 30 });
     expect(fetchImpl.mock.calls[0]![0]).toBe(
-      "https://api.example.com/v1/friends?page=2&pageSize=50",
+      "https://api.example.com/v1/moments?before=123&limit=30",
     );
   });
 
-  it("updateMyProfile sends PATCH /me with JSON body", async () => {
+  it("createMoment POSTs text and image URLs", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: { moment: { id: 1, author_id: "u1", text: "hello", created_at: "now" } },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.createMoment({ text: "hello", images: ["https://cdn/a.png"] });
+    expect(fetchImpl.mock.calls[0]![0]).toBe("https://api.example.com/v1/moments");
+    const init = fetchImpl.mock.calls[0]![1] as RequestInit;
+    expect(init.method).toBe("POST");
+    expect(JSON.parse(init.body as string)).toEqual({
+      text: "hello",
+      images: ["https://cdn/a.png"],
+    });
+  });
+
+  it("deleteMoment sends DELETE /moments/{id}", async () => {
+    const fetchImpl = vi
+      .fn()
+      .mockResolvedValue(jsonResponse({ code: 0, message: "ok", data: { ok: true } }));
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.deleteMoment(123);
+    expect(fetchImpl.mock.calls[0]![0]).toBe("https://api.example.com/v1/moments/123");
+    expect((fetchImpl.mock.calls[0]![1] as RequestInit).method).toBe("DELETE");
+  });
+
+  it("toggleMomentReaction POSTs emoji body", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: { reactions: [{ emoji: "👍", count: 1, mine: true }] },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.toggleMomentReaction({ momentId: 123, emoji: "👍" });
+    expect(fetchImpl.mock.calls[0]![0]).toBe(
+      "https://api.example.com/v1/moments/123/reactions",
+    );
+    expect(JSON.parse((fetchImpl.mock.calls[0]![1] as RequestInit).body as string)).toEqual({
+      emoji: "👍",
+    });
+  });
+
+  it("createMomentComment and replyMomentComment POST expected bodies", async () => {
+    const fetchImpl = vi.fn().mockImplementation(() =>
+      Promise.resolve(
+        jsonResponse({
+          code: 0,
+          message: "ok",
+          data: { comment: { id: 456, author_id: "u1", text: "nice", created_at: "now" } },
+        }),
+      ),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.createMomentComment({ momentId: 123, text: "nice" });
+    await client.replyMomentComment({ momentId: 123, replyToCommentId: 456, text: "yes" });
+    expect(fetchImpl.mock.calls[0]![0]).toBe(
+      "https://api.example.com/v1/moments/123/comments",
+    );
+    expect(JSON.parse((fetchImpl.mock.calls[0]![1] as RequestInit).body as string)).toEqual({
+      text: "nice",
+    });
+    expect(JSON.parse((fetchImpl.mock.calls[1]![1] as RequestInit).body as string)).toEqual({
+      text: "yes",
+      reply_to_comment_id: 456,
+    });
+  });
+
+  it("deleteMomentComment sends DELETE /moments/{id}/comments/{cid}", async () => {
+    const fetchImpl = vi
+      .fn()
+      .mockResolvedValue(jsonResponse({ code: 0, message: "ok", data: { ok: true } }));
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await client.deleteMomentComment({ momentId: 123, commentId: 456 });
+    expect(fetchImpl.mock.calls[0]![0]).toBe(
+      "https://api.example.com/v1/moments/123/comments/456",
+    );
+    expect((fetchImpl.mock.calls[0]![1] as RequestInit).method).toBe("DELETE");
+  });
+
+  it("updateMyProfile sends PATCH /me with JSON body without requiring configured userId", async () => {
     const fetchImpl = vi.fn().mockResolvedValue(
       jsonResponse({
         code: 0,
@@ -85,7 +227,6 @@ describe("openclaw-clawchat api-client", () => {
     const client = createOpenclawClawlingApiClient({
       baseUrl: "https://api.example.com",
       token: "tk",
-      userId: "agent-1",
       fetchImpl,
     });
     await client.updateMyProfile({ display_name: "Alice2" });
@@ -115,18 +256,91 @@ describe("openclaw-clawchat api-client", () => {
     expect(JSON.parse(init.body as string)).toEqual({ bio: "hello there" });
   });
 
-  it("updateMyProfile throws validation error when userId is not configured", async () => {
-    const fetchImpl = vi.fn();
+  it("listConversations sends before + limit as query string", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: {
+          conversations: [
+            {
+              id: "cnv_1",
+              type: "direct",
+              title: "Alice",
+              created_at: "2026-05-20T00:00:00Z",
+              updated_at: "2026-05-20T00:01:00Z",
+              peer: { id: "usr_1", type: "user", nickname: "Alice", avatar_url: "https://cdn/a.png" },
+            },
+          ],
+          next_before: "cursor-2",
+        },
+      }),
+    );
     const client = createOpenclawClawlingApiClient({
       baseUrl: "https://api.example.com",
       token: "tk",
-      // userId intentionally omitted
       fetchImpl,
     });
-    await expect(client.updateMyProfile({ display_name: "x" })).rejects.toMatchObject({
-      kind: "validation",
+    const result = await client.listConversations({ before: "cursor-1", limit: 10 });
+    expect(fetchImpl.mock.calls[0]![0]).toBe(
+      "https://api.example.com/v1/conversations?before=cursor-1&limit=10",
+    );
+    expect(result.conversations[0]!.id).toBe("cnv_1");
+    expect(result.conversations[0]!.created_at).toBe("2026-05-20T00:00:00Z");
+    expect(result.conversations[0]!.peer.nickname).toBe("Alice");
+    expect(result.next_before).toBe("cursor-2");
+  });
+
+  it("getConversation sends GET /v1/conversations/{id}", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: {
+          conversation: {
+            id: "cnv_1",
+            type: "group",
+            title: "Team",
+            creator_id: "usr_creator",
+            created_at: "2026-05-20T00:00:00Z",
+            updated_at: "2026-05-20T00:01:00Z",
+            participants: [
+              {
+                conversation_id: "cnv_1",
+                user_id: "usr_1",
+                role: "owner",
+                joined_at: "2026-05-20T00:00:00Z",
+              },
+            ],
+          },
+        },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
     });
-    expect(fetchImpl).not.toHaveBeenCalled();
+    const result = await client.getConversation("cnv_1");
+    expect(fetchImpl.mock.calls[0]![0]).toBe("https://api.example.com/v1/conversations/cnv_1");
+    expect(result.conversation.title).toBe("Team");
+    expect(result.conversation.creator_id).toBe("usr_creator");
+    expect(result.conversation.participants[0]!.user_id).toBe("usr_1");
+  });
+
+  it("does not expose conversation admin mutation methods", () => {
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl: vi.fn(),
+    });
+    expect(client).not.toHaveProperty("createConversation");
+    expect(client).not.toHaveProperty("updateConversation");
+    expect(client).not.toHaveProperty("leaveConversation");
+    expect(client).not.toHaveProperty("dissolveConversation");
+    expect(client).not.toHaveProperty("addConversationUsers");
+    expect(client).not.toHaveProperty("removeConversationUsers");
+    expect(client).not.toHaveProperty("listConversationUsers");
   });
 
   it("uploadMedia POSTs multipart with field name 'file'", async () => {
@@ -134,7 +348,7 @@ describe("openclaw-clawchat api-client", () => {
       jsonResponse({
         code: 0,
         message: "ok",
-        data: { url: "https://cdn/x.png", size: 12, mime: "image/png" },
+        data: { kind: "image", url: "https://cdn/x.png", name: "x.png", size: 12, mime: "image/png" },
       }),
     );
     const client = createOpenclawClawlingApiClient({
@@ -158,7 +372,51 @@ describe("openclaw-clawchat api-client", () => {
     expect(file).toBeInstanceOf(File);
     expect(file.name).toBe("x.png");
     expect(file.type).toBe("image/png");
-    expect(result).toEqual({ url: "https://cdn/x.png", size: 12, mime: "image/png" });
+    expect(result).toEqual({ kind: "image", url: "https://cdn/x.png", name: "x.png", size: 12, mime: "image/png" });
+  });
+
+  it.each([
+    ["kind", { url: "https://cdn/x.png", name: "x.png", size: 12, mime: "image/png" }],
+    ["url", { kind: "image", name: "x.png", size: 12, mime: "image/png" }],
+    ["name", { kind: "image", url: "https://cdn/x.png", size: 12, mime: "image/png" }],
+    ["mime", { kind: "image", url: "https://cdn/x.png", name: "x.png", size: 12 }],
+    ["size", { kind: "image", url: "https://cdn/x.png", name: "x.png", mime: "image/png" }],
+  ])("uploadMedia treats missing %s in response data as protocol error", async (_field, data) => {
+    const fetchImpl = vi.fn().mockResolvedValue(jsonResponse({ code: 0, message: "ok", data }));
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await expect(
+      client.uploadMedia({
+        buffer: Buffer.from("hi-bytes-12!"),
+        filename: "x.png",
+        mime: "image/png",
+      }),
+    ).rejects.toMatchObject({ kind: "api" });
+  });
+
+  it("uploadMedia treats unsupported kind in response data as protocol error", async () => {
+    const fetchImpl = vi.fn().mockResolvedValue(
+      jsonResponse({
+        code: 0,
+        message: "ok",
+        data: { kind: "bogus", url: "https://cdn/x.png", name: "x.png", size: 12, mime: "image/png" },
+      }),
+    );
+    const client = createOpenclawClawlingApiClient({
+      baseUrl: "https://api.example.com",
+      token: "tk",
+      fetchImpl,
+    });
+    await expect(
+      client.uploadMedia({
+        buffer: Buffer.from("hi-bytes-12!"),
+        filename: "x.png",
+        mime: "image/png",
+      }),
+    ).rejects.toMatchObject({ kind: "api" });
   });
 
   it("uploadAvatar POSTs multipart to /v1/files/upload-url", async () => {
@@ -190,6 +448,8 @@ describe("openclaw-clawchat api-client", () => {
     expect(file.type).toBe("image/png");
     // X-Device-Id is present on avatar uploads too.
     expect((init.headers as Record<string, string>)["x-device-id"]).toBe("openclaw-clawchat");
+    expect(result).not.toHaveProperty("kind");
+    expect(result).not.toHaveProperty("name");
     expect(result).toEqual({ url: "https://cdn/avatars/a.png", size: 99, mime: "image/png" });
   });