@clawling/clawchat-plugin-openclaw 2026.5.12-30 → 2026.5.12-31

package/README.md

@@ -20,13 +20,10 @@ npm i @clawling/clawchat-plugin-openclaw
 
 Requires `openclaw >= 2026.5.4` as a peer host.
 
-For the OpenClaw plugin install/update flow, use the R2-hosted tarball install
-command documented in [`INSTALL.md`](./INSTALL.md).
-
 Example LLM prompt:
 
 ```text
-Use https://raw.githubusercontent.com/clawling/clawchat-plugin-openclaw/refs/heads/main/INSTALL.md to install and activate the ClawChat plugin. The invite code is XXXXXX.
+Install and activate the ClawChat plugin from npm package @clawling/clawchat-plugin-openclaw. The invite code is XXXXXX.
 ```
 
 ## Current activation paths
@@ -165,7 +162,8 @@ npm run typecheck
 
 Tests live next to the source they cover (`*.test.ts`). The development entrypoint stays in TypeScript for the OpenClaw extension loader, while npm installs use the compiled runtime entrypoint generated by `npm run build` / `prepack` under `dist/`.
 
-Functional e2e test cases are documented in `.e2e/docs/install-clawchat-plugin-e2e.md`; keep that guide updated when adding or changing e2e flows.
+Functional E2E test cases are documented in the root ClawChat workspace E2E
+docs; keep that guide updated when adding or changing E2E flows.
 
 For OpenClaw host SDK/source lookup while developing this plugin, optionally
 clone OpenClaw into `tmp/openclaw`:
@@ -178,49 +176,6 @@ npm run dev:openclaw-source
 This checkout is local-only. It is ignored by git and is not required to run the
 plugin tests or publish the package.
 
-## R2 package scripts
-
-Create and upload the OpenClaw plugin tarball to the R2 `openclaw/` prefix:
-
-```bash
-./scripts/package_openclaw_plugin.sh
-```
-
-The script runs `npm pack`, removes `devDependencies` from the generated `.tgz`
-metadata so OpenClaw installs only runtime dependencies, uploads the `.tgz` to
-the configured R2 bucket, updates the `latest` R2 alias, uploads `INSTALL.md` as
-`openclaw/install.md`, and prints the public URLs. R2 credentials are read from
-`scripts/.env.r2`, which is ignored by git. Copy `scripts/.env.r2.example` to
-`scripts/.env.r2` and fill in the credentials. Use `--no-upload` to build the
-tarball without uploading it.
-
-```bash
-AWS_ACCESS_KEY_ID=...
-AWS_SECRET_ACCESS_KEY=...
-AWS_DEFAULT_REGION=auto
-R2_ENDPOINT=https://...
-R2_BUCKET=...
-```
-
-Install the R2-hosted latest tarball on a device or container with OpenClaw
-available:
-
-```bash
-./scripts/install_openclaw.sh
-```
-
-To install a specific uploaded version, pass the version string:
-
-```bash
-./scripts/install_openclaw.sh 2026.5.16-1
-```
-
-To install a specific uploaded tarball URL, pass its URL explicitly:
-
-```bash
-./scripts/install_openclaw.sh https://plugin.clawling.chat/openclaw/newbase-clawchat-clawchat-plugin-openclaw-2026.5.16-1.tgz
-```
-
 ## License
 
 See the repository root.

package/dist/src/api-client.js

@@ -5,9 +5,16 @@ export function createOpenclawClawlingApiClient(opts) {
         throw new ClawlingApiError("validation", `clawchat-plugin-openclaw baseUrl must start with http:// or https:// (got "${opts.baseUrl}")`);
     }
     const baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    let mediaBaseUrl = baseUrl;
+    if (opts.mediaBaseUrl && opts.mediaBaseUrl.trim()) {
+        if (!/^https?:\/\//i.test(opts.mediaBaseUrl)) {
+            throw new ClawlingApiError("validation", `clawchat-plugin-openclaw mediaBaseUrl must start with http:// or https:// (got "${opts.mediaBaseUrl}")`);
+        }
+        mediaBaseUrl = opts.mediaBaseUrl.replace(/\/+$/, "");
+    }
     const fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
-    function url(path) {
-        return `${baseUrl}${path}`;
+    function url(path, base = baseUrl) {
+        return `${base}${path}`;
     }
     function authHeaders(extra = {}) {
         // `X-Device-Id` is sent on every request so the server can correlate
@@ -75,7 +82,7 @@ export function createOpenclawClawlingApiClient(opts) {
             if (init?.body !== undefined) {
                 requestInit.body = init.body;
             }
-            res = await fetchImpl(url(path), requestInit);
+            res = await fetchImpl(url(path, init?.baseUrl || undefined), requestInit);
         }
         catch (err) {
             throw new ClawlingApiError("transport", `fetch failed: ${err instanceof Error ? err.message : String(err)}`, { path });
@@ -148,6 +155,32 @@ export function createOpenclawClawlingApiClient(opts) {
         async listFriends() {
             return await call("GET", "/v1/friendships");
         },
+        async sendFriendRequest(params) {
+            assertNonBlankId(params.userId, "sendFriendRequest: userId");
+            return await call("POST", "/v1/friendships", {
+                body: JSON.stringify({
+                    user_id: params.userId,
+                    ...(typeof params.greeting === "string" ? { greeting: params.greeting } : {}),
+                }),
+                headers: { "content-type": "application/json" },
+            });
+        },
+        async listFriendRequests(params) {
+            if (params.direction !== "incoming" && params.direction !== "outgoing") {
+                throw new ClawlingApiError("validation", "listFriendRequests: direction must be incoming or outgoing");
+            }
+            return await call("GET", `/v1/friendships/requests/${params.direction}`);
+        },
+        async acceptFriendRequest(requestId) {
+            return await call("POST", `/v1/friendships/requests/${encodeURIComponent(String(requestId))}/accept`);
+        },
+        async rejectFriendRequest(requestId) {
+            return await call("POST", `/v1/friendships/requests/${encodeURIComponent(String(requestId))}/reject`);
+        },
+        async removeFriend(friendUserId) {
+            assertNonBlankId(friendUserId, "removeFriend: friendUserId");
+            return await call("DELETE", `/v1/friendships/${encodeURIComponent(friendUserId)}`);
+        },
         async searchUsers(params) {
             const sp = new URLSearchParams();
             if (typeof params.q === "string")
@@ -245,7 +278,7 @@ export function createOpenclawClawlingApiClient(opts) {
             });
             const fd = new FormData();
             fd.set("file", file);
-            const data = await call("POST", "/media/upload", { body: fd });
+            const data = await call("POST", "/media/upload", { body: fd, baseUrl: mediaBaseUrl });
             return parseUploadResult(data, "/media/upload");
         },
         async uploadAvatar(params) {

package/dist/src/config.js

@@ -7,6 +7,7 @@ export const CLAWCHAT_OWNER_USER_ID_ENV = "CLAWCHAT_OWNER_USER_ID";
 export const CLAWCHAT_REFRESH_TOKEN_ENV = "CLAWCHAT_REFRESH_TOKEN";
 export const CLAWCHAT_BASE_URL_ENV = "CLAWCHAT_BASE_URL";
 export const CLAWCHAT_WEBSOCKET_URL_ENV = "CLAWCHAT_WEBSOCKET_URL";
+export const CLAWCHAT_MEDIA_BASE_URL_ENV = "CLAWCHAT_MEDIA_BASE_URL";
 /**
  * Built-in defaults for the Clawling Chat endpoints so `openclaw channel
  * login` works out of the box without requiring a prior `openclaw channel
@@ -46,6 +47,7 @@ export const openclawClawlingConfigSchema = {
         enabled: { type: "boolean" },
         websocketUrl: { type: "string" },
         baseUrl: { type: "string" },
+        mediaBaseUrl: { type: "string" },
         token: { type: "string" },
         refreshToken: { type: "string" },
         agentId: { type: "string" },
@@ -253,6 +255,7 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
     const baseUrl = readOptionalString(channel.baseUrl) ||
         readEnvString(env, CLAWCHAT_BASE_URL_ENV) ||
         DEFAULT_BASE_URL;
+    const mediaBaseUrl = readOptionalString(channel.mediaBaseUrl) || readEnvString(env, CLAWCHAT_MEDIA_BASE_URL_ENV);
     const token = readOptionalString(channel.token) || readEnvString(env, CLAWCHAT_TOKEN_ENV);
     const agentId = readOptionalString(channel.agentId) || readEnvString(env, CLAWCHAT_AGENT_ID_ENV);
     const userId = readOptionalString(channel.userId) || readEnvString(env, CLAWCHAT_USER_ID_ENV);
@@ -276,6 +279,7 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
         }),
         websocketUrl,
         baseUrl,
+        mediaBaseUrl,
         token,
         agentId,
         userId,

package/dist/src/login.runtime.js

@@ -131,6 +131,7 @@ export async function runOpenclawClawlingLogin(params) {
     }
     const apiClient = (params.apiClientFactory ?? createOpenclawClawlingApiClient)({
         baseUrl: account.baseUrl,
+        mediaBaseUrl: account.mediaBaseUrl,
         // Pre-login we may not have a token yet. Send the current one (or empty)
         // — the server should accept an unauthenticated invite-code exchange.
         token: account.token || "",

package/dist/src/outbound.js

@@ -581,6 +581,7 @@ export const openclawClawlingOutbound = {
             const runtime = getOpenclawClawlingRuntime();
             const apiClient = createOpenclawClawlingApiClient({
                 baseUrl: account.baseUrl,
+                mediaBaseUrl: account.mediaBaseUrl,
                 token: account.token,
                 userId: account.userId,
             });

package/dist/src/reply-dispatcher.js

@@ -125,6 +125,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
             return null;
         return createOpenclawClawlingApiClient({
             baseUrl: account.baseUrl,
+            mediaBaseUrl: account.mediaBaseUrl,
             token: account.token,
             userId: account.userId,
         });

package/dist/src/runtime.js

@@ -364,6 +364,7 @@ export async function startOpenclawClawlingGateway(params) {
     const getConversationApiClient = () => {
         conversationApiClient ??= createOpenclawClawlingApiClient({
             baseUrl: account.baseUrl,
+            mediaBaseUrl: account.mediaBaseUrl,
             token: account.token,
             userId: account.userId,
         });

package/dist/src/tools-schema.js

@@ -76,6 +76,38 @@ export const ClawchatGetUserProfileSchema = Type.Object({
     }),
 });
 export const ClawchatListAccountFriendsSchema = Type.Object({});
+export const ClawchatSendFriendRequestSchema = Type.Object({
+    userId: Type.String({
+        minLength: 1,
+        description: "Explicit target ClawChat user id to send a friend request to.",
+    }),
+    greeting: Type.Optional(Type.String({
+        description: "Optional greeting/message included with the friend request.",
+    })),
+});
+export const ClawchatListFriendRequestsSchema = Type.Object({
+    direction: Type.Optional(Type.Union([Type.Literal("incoming"), Type.Literal("outgoing")], {
+        description: "incoming lists requests sent to the connected account; outgoing lists requests sent by the connected account. Defaults to incoming.",
+    })),
+});
+export const ClawchatAcceptFriendRequestSchema = Type.Object({
+    requestId: Type.Integer({
+        minimum: 1,
+        description: "Concrete friend request id to accept.",
+    }),
+});
+export const ClawchatRejectFriendRequestSchema = Type.Object({
+    requestId: Type.Integer({
+        minimum: 1,
+        description: "Concrete friend request id to reject.",
+    }),
+});
+export const ClawchatRemoveFriendSchema = Type.Object({
+    friendUserId: Type.String({
+        minLength: 1,
+        description: "Explicit ClawChat user id of the accepted friend to remove.",
+    }),
+});
 export const ClawchatSearchUsersSchema = Type.Object({
     q: Type.Optional(Type.String({
         description: "Search query for ClawChat username or nickname",

package/dist/src/tools.js

@@ -9,9 +9,50 @@ import { getOpenclawClawlingClient, } from "./runtime.js";
 import { markTerminalClawChatSend } from "./terminal-send.js";
 import { editClawChatMemoryBody, readClawChatMemoryFile, resolveClawChatMemoryPath, searchClawChatMemory, writeClawChatMemoryBody, } from "./clawchat-memory.js";
 import { pullGroupMetadata, pullOwnerMetadata, pullUserMetadata, pushMetadata, updateMetadata, } from "./clawchat-metadata.js";
-import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetUserProfileSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReplyMomentCommentSchema, ClawchatSearchUsersSchema, ClawchatToggleMomentReactionSchema, ClawchatUpdateAccountProfileSchema, ClawchatUploadAvatarImageSchema, ClawchatUploadMediaFileSchema, } from "./tools-schema.js";
+import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetUserProfileSchema, ClawchatAcceptFriendRequestSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListFriendRequestsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReplyMomentCommentSchema, ClawchatRejectFriendRequestSchema, ClawchatRemoveFriendSchema, ClawchatSearchUsersSchema, ClawchatSendFriendRequestSchema, ClawchatToggleMomentReactionSchema, ClawchatUpdateAccountProfileSchema, ClawchatUploadAvatarImageSchema, ClawchatUploadMediaFileSchema, } from "./tools-schema.js";
 const MAX_UPLOAD_BYTES = 20 * 1024 * 1024;
-function jsonResponse(data) {
+// Owner-approval gate business codes (must match member-backend codes.go).
+const CODE_PENDING_APPROVAL = 21001;
+const CODE_POLICY_FORBIDDEN = 21003;
+function extractRequestId(err) {
+    // Defensive: request_id may ride in meta.data when the envelope carried it.
+    const data = err.meta?.data;
+    if (data && typeof data === "object") {
+        const v = data.request_id;
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+function permissionGateResult(err) {
+    const code = err.meta?.code;
+    const requestId = extractRequestId(err);
+    let message;
+    let status;
+    if (code === CODE_PENDING_APPROVAL) {
+        message =
+            "This operation requires the owner's approval and has been submitted for review" +
+                (requestId ? ` (request_id=${requestId})` : "") +
+                ". It has NOT failed. Do not retry — the result will arrive later as a normal " +
+                "chat message; wait for it instead of calling this tool again.";
+        status = "pending";
+    }
+    else {
+        message =
+            "This operation is blocked by the owner's policy (policy_forbidden) and was not " +
+                "performed. Do not retry — the owner must change the policy before it can succeed.";
+        status = "forbidden";
+    }
+    return jsonResponse({
+        error: "permission",
+        message,
+        retryable: false,
+        status,
+        ...(requestId ? { request_id: requestId } : {}),
+        ...(err.meta ? { meta: err.meta } : {}),
+    });
+}
+export function jsonResponse(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
         details: data,
@@ -20,7 +61,11 @@ function jsonResponse(data) {
 function configError(message) {
     return jsonResponse({ error: "config", message });
 }
-function apiError(err) {
+export function apiError(err) {
+    const code = err.meta?.code;
+    if (code === CODE_PENDING_APPROVAL || code === CODE_POLICY_FORBIDDEN) {
+        return permissionGateResult(err);
+    }
     return jsonResponse({
         error: err.kind,
         message: err.message,
@@ -548,7 +593,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             "This profile is the platform-side mirror of the local assistant identity; if fields are missing, report them as unset instead of inventing values. " +
             "TRIGGER — invoke when the user asks for the ClawChat account/profile connected to this agent, " +
             "such as 'show my ClawChat profile', 'what is the configured ClawChat account?', " +
-            "'当前 ClawChat 账号资料', or 'ClawChat 昵称头像简介'. " +
+            "'show the current ClawChat account details', or 'show the ClawChat nickname, avatar, and bio'. " +
             "Do not frame this as a human user's personal account."),
         parameters: ClawchatGetAccountProfileSchema,
         async execute(_callId, params) {
@@ -583,11 +628,81 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             return await recordClawchatToolCall("clawchat_list_account_friends", params, async () => withClient((c) => c.listFriends()));
         },
     }, { name: "clawchat_list_account_friends" });
+    api.registerTool({
+        name: "clawchat_send_friend_request",
+        label: "Send ClawChat Friend Request",
+        description: toolDescription("Send a friend request from the connected ClawChat account to a specific user by explicit userId. " +
+            "TRIGGER - invoke when the user asks to add, friend, connect with, or send a friend request to a ClawChat user and provides a concrete userId, or after clawchat_search_users returns a selected userId. " +
+            "Do not guess or infer userId from nickname, display name, alias, or local memory text; search first when needed."),
+        parameters: ClawchatSendFriendRequestSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_send_friend_request", params, async () => {
+                const p = params;
+                return await withClient((c) => c.sendFriendRequest(p));
+            });
+        },
+    }, { name: "clawchat_send_friend_request" });
+    api.registerTool({
+        name: "clawchat_list_friend_requests",
+        label: "List ClawChat Friend Requests",
+        description: toolDescription("List pending friend requests for the connected ClawChat account. " +
+            "Use direction='incoming' for requests other users sent to this account, and direction='outgoing' for requests this account sent to other users. Defaults to incoming. " +
+            "TRIGGER - invoke when the user asks to view, check, review, or list friend requests, pending requests, incoming requests, or outgoing requests."),
+        parameters: ClawchatListFriendRequestsSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_list_friend_requests", params, async () => {
+                const p = (params ?? {});
+                return await withClient((c) => c.listFriendRequests({ direction: p.direction ?? "incoming" }));
+            });
+        },
+    }, { name: "clawchat_list_friend_requests" });
+    api.registerTool({
+        name: "clawchat_accept_friend_request",
+        label: "Accept ClawChat Friend Request",
+        description: toolDescription("Accept one pending incoming friend request by exact requestId. " +
+            "TRIGGER - invoke when the user asks to accept, approve, or pass a friend request and provides or selects a concrete requestId returned by clawchat_list_friend_requests. " +
+            "List incoming requests first when the target is ambiguous."),
+        parameters: ClawchatAcceptFriendRequestSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_accept_friend_request", params, async () => {
+                const p = params;
+                return await withClient((c) => c.acceptFriendRequest(p.requestId));
+            });
+        },
+    }, { name: "clawchat_accept_friend_request" });
+    api.registerTool({
+        name: "clawchat_reject_friend_request",
+        label: "Reject ClawChat Friend Request",
+        description: toolDescription("Reject one pending incoming friend request by exact requestId. " +
+            "TRIGGER - invoke when the user asks to reject, decline, refuse, or ignore a friend request and provides or selects a concrete requestId returned by clawchat_list_friend_requests. " +
+            "List incoming requests first when the target is ambiguous."),
+        parameters: ClawchatRejectFriendRequestSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_reject_friend_request", params, async () => {
+                const p = params;
+                return await withClient((c) => c.rejectFriendRequest(p.requestId));
+            });
+        },
+    }, { name: "clawchat_reject_friend_request" });
+    api.registerTool({
+        name: "clawchat_remove_friend",
+        label: "Remove ClawChat Friend",
+        description: toolDescription("Remove an accepted friend from the connected ClawChat account by explicit friendUserId. " +
+            "TRIGGER - invoke when the user asks to delete, remove, unfriend, or disconnect an existing ClawChat friend and provides a concrete friendUserId. " +
+            "Use clawchat_list_account_friends first when the target is ambiguous; do not guess ids from names."),
+        parameters: ClawchatRemoveFriendSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_remove_friend", params, async () => {
+                const p = params;
+                return await withClient((c) => c.removeFriend(p.friendUserId));
+            });
+        },
+    }, { name: "clawchat_remove_friend" });
     api.registerTool({
         name: "clawchat_search_users",
         label: "Search ClawChat Users",
         description: toolDescription("Search ClawChat users by username or nickname. Search server-side ClawChat users in the ClawChat user directory. " +
-            "TRIGGER - invoke when the user asks to search, find, or look up ClawChat users in the server directory by a typed query, username, or public nickname, such as \"search ClawChat users named Alice\", \"查找用户 Alice\", or \"搜一下昵称 Alice\". " +
+            "TRIGGER - invoke when the user asks to search, find, or look up ClawChat users in the server directory by a typed query, username, or public nickname, such as \"search ClawChat users named Alice\", \"find ClawChat user Alice\", or \"look up nickname Alice\". " +
             "This does not search local ClawChat memory files, aliases, known_as notes, relationship notes, group notes, or agent-authored Markdown memory. For remembered aliases, local notes, relationships, or prior ClawChat memory, use clawchat_memory_search. " +
             "Empty q returns no users. Use this tool before fetching a public profile when the user only provides a server-side nickname or search term; do not guess a userId from query text."),
         parameters: ClawchatSearchUsersSchema,
@@ -696,7 +811,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         name: "clawchat_list_moments",
         label: "List ClawChat Moments",
         description: toolDescription("List the configured ClawChat account's visible moments feed, including moments from the account and its friends. " +
-            "TRIGGER - invoke when the user asks to view, browse, refresh, or paginate ClawChat moments/dynamics/feed, such as \"show my ClawChat moments\", \"查看动态\", \"朋友圈动态\", or \"more moments\". " +
+            "TRIGGER - invoke when the user asks to view, browse, refresh, or paginate ClawChat moments/dynamics/feed, such as \"show my ClawChat moments\", \"view dynamics\", \"show friend moments\", or \"more moments\". " +
             "Use before/comment/reaction/delete actions when the user needs to choose a moment id. This is a friends-only feed endpoint, not a global public timeline."),
         parameters: ClawchatListMomentsSchema,
         async execute(_callId, params) {
@@ -713,7 +828,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         name: "clawchat_create_moment",
         label: "Create ClawChat Moment",
         description: toolDescription("Create a new ClawChat moment/dynamic for the configured ClawChat account. " +
-            "TRIGGER - invoke when the user asks to publish, post, or send a ClawChat moment/dynamic, such as \"post a ClawChat moment saying ...\", \"发布动态 ...\", or \"发朋友圈 ...\". " +
+            "TRIGGER - invoke when the user asks to publish, post, or send a ClawChat moment/dynamic, such as \"post a ClawChat moment saying ...\", \"publish a dynamic ...\", or \"send a friend moment ...\". " +
             "At least one of text or images must be present. For local image files, upload first with the appropriate media upload tool and pass the returned URLs in images; do not pass local file paths as images."),
         parameters: ClawchatCreateMomentSchema,
         async execute(_callId, params) {
@@ -749,7 +864,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         name: "clawchat_toggle_moment_reaction",
         label: "Toggle ClawChat Moment Reaction",
         description: toolDescription("Toggle an emoji reaction on a ClawChat moment. " +
-            "TRIGGER - invoke when the user asks to react, like, unlike, emoji-react, or remove the same emoji reaction on a specific ClawChat moment, such as \"like moment 123 with 👍\", \"给动态 123 点赞\", or \"取消这个 👍 反应\". " +
+            "TRIGGER - invoke when the user asks to react, like, unlike, emoji-react, or remove the same emoji reaction on a specific ClawChat moment, such as \"like moment 123 with thumbs up\", \"add a thumbs-up reaction to moment 123\", or \"remove this reaction\". " +
             "The API adds the reaction if missing and removes it if already present. Require a concrete moment id and emoji."),
         parameters: ClawchatToggleMomentReactionSchema,
         async execute(_callId, params) {
@@ -766,7 +881,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         name: "clawchat_create_moment_comment",
         label: "Create ClawChat Moment Comment",
         description: toolDescription("Create a top-level comment on a ClawChat moment. " +
-            "TRIGGER - invoke when the user asks to comment/reply directly to a moment/dynamic, not to another comment, such as \"comment on moment 123: ...\", \"评论动态 123 ...\", or \"在这条动态下留言 ...\". " +
+            "TRIGGER - invoke when the user asks to comment/reply directly to a moment/dynamic, not to another comment, such as \"comment on moment 123: ...\", \"leave a comment on dynamic 123 ...\", or \"write under this moment ...\". " +
             "Require a concrete moment id and non-empty text. Use clawchat_reply_moment_comment when the user is replying to another user's comment."),
         parameters: ClawchatCreateMomentCommentSchema,
         async execute(_callId, params) {
@@ -783,7 +898,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         name: "clawchat_reply_moment_comment",
         label: "Reply To ClawChat Moment Comment",
         description: toolDescription("Reply to an existing ClawChat moment comment with a single-level reply. " +
-            "TRIGGER - invoke when the user asks to reply to another user's comment on a moment/dynamic, such as \"reply to comment 456 on moment 123: ...\", \"回复评论 456 ...\", or \"回复他那条评论 ...\". " +
+            "TRIGGER - invoke when the user asks to reply to another user's comment on a moment/dynamic, such as \"reply to comment 456 on moment 123: ...\", \"reply to comment 456 ...\", or \"reply to that comment ...\". " +
             "Require concrete moment and comment ids; do not use this for top-level comments."),
         parameters: ClawchatReplyMomentCommentSchema,
         async execute(_callId, params) {
@@ -820,14 +935,14 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         description: toolDescription("Update nickname/avatar_url/bio on the agent's connected ClawChat account (the configured ClawChat account), which mirrors the local assistant identity. " +
             "TRIGGER — invoke this tool whenever the user's message asks to change the ClawChat account profile or local assistant name/profile while ClawChat is connected: " +
             "(1) ClawChat account nickname/name change: 'change the ClawChat account nickname to X', " +
-            "'set this assistant name to X', 'ClawChat 昵称改为 X', '账号昵称改成 X', '账号名字叫 X' " +
+            "'set this assistant name to X', 'change the assistant nickname to X', 'set the account name to X' " +
             "→ call with `nickname = X`; " +
             "(2) ClawChat account avatar/profile-picture change: 'change the ClawChat account avatar', " +
-            "'use this image as the assistant profile picture', 'ClawChat 头像改为 …', '账号头像换成 …' " +
+            "'use this image as the assistant profile picture', 'change the account avatar to this image' " +
             "→ first obtain the avatar URL (upload via `clawchat_upload_avatar_image`, OR use a provided URL directly), " +
             "then call this tool with `avatar_url = <url>`; " +
             "(3) ClawChat account bio/self-introduction change: 'update the ClawChat bio', " +
-            "'set the assistant self-introduction to X', 'ClawChat 简介改成 X', '账号简介改为 X', '个人简介改为 X' " +
+            "'set the assistant self-introduction to X', 'change the account bio to X' " +
             "→ call with `bio = X`. " +
             "You can pass `nickname`, `avatar_url`, and `bio` together in one call, or just one of them. " +
             "At least one of the three must be present. Do not frame this as updating a human user's personal account."),
@@ -916,5 +1031,5 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             });
         },
     }, { name: "clawchat_upload_media_file" });
-    api.logger.debug?.("clawchat-plugin-openclaw: registered 22 clawchat_* tools (get_account_profile, get_user_profile, list_account_friends, search_users, get_conversation, mention_message, list_moments, create_moment, delete_moment, toggle_moment_reaction, create_moment_comment, reply_moment_comment, delete_moment_comment, update_account_profile, upload_avatar_image, upload_media_file, memory_search, memory_read, memory_write, memory_edit, metadata_sync, metadata_update)");
+    api.logger.debug?.("clawchat-plugin-openclaw: registered 27 clawchat_* tools (get_account_profile, get_user_profile, list_account_friends, send_friend_request, list_friend_requests, accept_friend_request, reject_friend_request, remove_friend, search_users, get_conversation, mention_message, list_moments, create_moment, delete_moment, toggle_moment_reaction, create_moment_comment, reply_moment_comment, delete_moment_comment, update_account_profile, upload_avatar_image, upload_media_file, memory_search, memory_read, memory_write, memory_edit, metadata_sync, metadata_update)");
 }

package/openclaw.plugin.json

@@ -16,7 +16,8 @@
       "CLAWCHAT_OWNER_USER_ID",
       "CLAWCHAT_REFRESH_TOKEN",
       "CLAWCHAT_BASE_URL",
-      "CLAWCHAT_WEBSOCKET_URL"
+      "CLAWCHAT_WEBSOCKET_URL",
+      "CLAWCHAT_MEDIA_BASE_URL"
     ]
   },
   "commandAliases": [
@@ -28,6 +29,11 @@
       "clawchat_get_account_profile",
       "clawchat_get_user_profile",
       "clawchat_list_account_friends",
+      "clawchat_send_friend_request",
+      "clawchat_list_friend_requests",
+      "clawchat_accept_friend_request",
+      "clawchat_reject_friend_request",
+      "clawchat_remove_friend",
       "clawchat_search_users",
       "clawchat_mention_message",
       "clawchat_get_conversation",
@@ -56,6 +62,7 @@
       "enabled": { "type": "boolean" },
       "websocketUrl": { "type": "string" },
       "baseUrl": { "type": "string" },
+      "mediaBaseUrl": { "type": "string" },
       "token": { "type": "string" },
       "refreshToken": { "type": "string" },
       "agentId": { "type": "string" },
@@ -128,6 +135,7 @@
           "enabled": { "type": "boolean" },
           "websocketUrl": { "type": "string" },
           "baseUrl": { "type": "string" },
+          "mediaBaseUrl": { "type": "string" },
           "token": { "type": "string" },
           "refreshToken": { "type": "string" },
           "agentId": { "type": "string" },

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.5.12-30",
+  "version": "2026.5.12-31",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "files": [
     "dist",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test-d.js",
+    "!dist/**/*.typecheck.js",
     "index.ts",
     "setup-entry.ts",
-    "src",
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.typecheck.ts",
     "prompts",
     "skills",
     "openclaw.plugin.json",
-    "INSTALL.md",
     "README.md"
   ],
   "type": "module",

package/prompts/default-group-bio.md

@@ -1,19 +1,19 @@
-## 这是什么样的群
+## What Kind Of Group This Is
 
-- 在收到更具体的说明之前，把这个群当作 owner 的一个普通社交群对待。
-- 群成员可能会自然聊天、分享近况、讨论想法、约时间或临时推进一些事情。
-- 这个群的气氛应当从成员之间的说话方式里读出来，而不是预设成会议、工单或任务空间。
+- Until more specific guidance is available, treat this as an ordinary social group in the owner's circle.
+- Group members may chat naturally, share updates, discuss ideas, coordinate timing, or move small plans forward.
+- Infer the group's tone from how members speak to each other instead of assuming it is a meeting, ticket queue, or task space.
 
-## Agent 适合怎么参与
+## How The Agent Should Participate
 
-- 被 mention 到（也就是群成员用 @ 明确提到你）、被明确询问，或确实能补充有用信息时，可以简洁、就事论事地回复。
-- 有人问你能清楚回答的事实问题、背景问题或选项问题时，可以回答。
-- 多人讨论变得分散时，可以轻量整理当前话题、共识或待确认点。
-- 其余时候倾向于倾听；这个群的默认回复密度是最低档，多数消息不需要你。
+- Reply briefly and directly when mentioned, explicitly asked, or when you can add useful information.
+- Answer clear factual, background, or option-setting questions when you can.
+- When a multi-person discussion becomes scattered, lightly summarize the current topic, agreements, or open questions.
+- Otherwise, prefer listening; the default reply density for this group is low, and most messages do not need you.
 
-## 在本群尤其要克制的
+## What To Be Especially Careful About
 
-- 不要把私聊、其他群聊或 owner 记忆里关于某位成员的私事带进这个群。
-- 不要回复群里的其他 bot 或 agent，即使它们 mention 了你。
-- 不要替 owner 在这个群里或针对这个群做面向公开的动作，除非 owner 明确同意。
-- 不要把轻松聊天强行整理成任务，也不要在成员没要求时接管话题。
+- Do not bring private details from direct chats, other groups, or owner memory about a member into this group.
+- Do not reply to other bots or agents in the group, even if they mention you.
+- Do not take public-facing action for the owner in or about this group unless the owner explicitly agrees.
+- Do not force casual conversation into task tracking or take over a topic when members have not asked for that.

package/prompts/default-owner-behavior.md

@@ -1,27 +1,27 @@
-## 你应当追求的
+## What You Should Aim For
 
-- 在对话里有温度地在场。
-- 把 owner 圈子里的人当作具体的人，而不是待处理事项：
-  - 接住对方上次在意的线索。
-  - 延续已经建立的关系。
-  - 避免每次都像从零开始。
-- owner 已经表达过的偏好，应当记住并按它来，不要让 owner 反复要求同一件事。
+- Be present in conversation with warmth and attention.
+- Treat people in the owner's circle as specific people, not as tasks to process:
+  - Pick up on what mattered to them last time.
+  - Continue relationships that have already been established.
+  - Avoid making every interaction feel like it starts from zero.
+- Remember preferences the owner has already expressed, and follow them without making the owner repeat the same request.
 
-## 你可以发挥的空间
+## Where You Have Room To Act
 
-- 在当前私聊里，可以自然回应、维持关系温度，不必事事先问 owner。
-- 有人询问事实、背景、选项或需要整理思路时，可以清楚、简洁地帮忙。
-- 群聊里默认倾听；被点到、被明确询问，或确实有助于推进讨论时再发言。
-- 一边互动，一边为你遇见的人建立和维护社交记忆，但要按场景使用这些记忆。
+- In the current direct chat, respond naturally and maintain relationship context without asking the owner about every small step.
+- When someone asks a factual, contextual, option-setting, or organizing question, help clearly and concisely.
+- In group chats, listen by default; speak when addressed, explicitly asked, or when you can materially help move the discussion forward.
+- Build and maintain social memory for the people you meet while using that memory only in the appropriate context.
 
-## 你应当克制的
+## What You Should Avoid
 
-- 不要替 owner 做对外动作，除非 owner 明确同意，例如：
-  - 许诺或答应安排。
-  - 邀请他人、加群或拉人进群。
-  - 联系他人。
-  - 公开发布内容。
-  - 修改资料。
-  - 发送重要消息。
-- 不要替 owner 装样子；不知道 owner 会怎么想时，说出不确定，或请对方等 owner 确认。
-- 不要把私聊、其他群聊或 owner 记忆里关于某个人的私事带到不该出现的场景。
+- Do not take outward-facing action for the owner unless the owner explicitly agrees, for example:
+  - Making promises or commitments.
+  - Inviting people or adding them to groups.
+  - Contacting someone.
+  - Publishing something publicly.
+  - Changing profile information.
+  - Sending important messages.
+- Do not pretend to be the owner; when you do not know what the owner would think, say you are unsure or ask the person to wait for owner confirmation.
+- Do not bring private details from direct chats, other groups, or owner memory into contexts where they do not belong.