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

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/commands.js

@@ -64,18 +64,16 @@ function persistOutputVisibility(draft, chatId, outputVisibility) {
     });
 }
 function formatOutputVisibilityResult(outputVisibility) {
-    const runtimeStatus = outputVisibility === "full" ? "on" : "off";
     const detailLevel = {
-        minimal: "quiet",
-        normal: "normal",
-        full: "verbose",
+        minimal: "final only",
+        normal: "final plus block media",
+        full: "final plus buffered reasoning, tool/progress, and block output",
     };
     return [
         "**ClawChat output updated**",
         "",
         `- visibility: \`${outputVisibility}\``,
-        `- runtime status: \`${runtimeStatus}\``,
-        `- detail level: \`${detailLevel[outputVisibility]}\``,
+        `- output: \`${detailLevel[outputVisibility]}\``,
         "",
         "Applies to new ClawChat messages.",
     ].join("\n");

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" },
@@ -189,6 +191,29 @@ function readGroupMode(value) {
 function readGroupCommandMode(value) {
     return value === "all" || value === "off" ? value : "owner";
 }
+function readOutputVisibility(value) {
+    return value === "minimal" || value === "full" ? value : "normal";
+}
+function readOptionalOutputVisibility(value) {
+    return value === "minimal" || value === "normal" || value === "full" ? value : undefined;
+}
+function readChats(value) {
+    const rawChats = value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+    const chats = {};
+    for (const [chatId, rawChat] of Object.entries(rawChats)) {
+        if (!chatId)
+            continue;
+        const chat = rawChat && typeof rawChat === "object" && !Array.isArray(rawChat)
+            ? rawChat
+            : {};
+        const outputVisibility = readOptionalOutputVisibility(chat.outputVisibility);
+        if (outputVisibility)
+            chats[chatId] = { outputVisibility };
+    }
+    return chats;
+}
 function readGroups(value) {
     const rawGroups = value && typeof value === "object" && !Array.isArray(value)
         ? value
@@ -200,9 +225,11 @@ function readGroups(value) {
         const group = rawGroup && typeof rawGroup === "object" && !Array.isArray(rawGroup)
             ? rawGroup
             : {};
+        const outputVisibility = readOptionalOutputVisibility(group.outputVisibility);
         groups[chatId] = {
             groupMode: readGroupMode(group.groupMode),
             groupCommandMode: readGroupCommandMode(group.groupCommandMode),
+            ...(outputVisibility ? { outputVisibility } : {}),
         };
     }
     return groups;
@@ -217,6 +244,13 @@ export function effectiveGroupCommandMode(account, chatId) {
         ?? account.groups["*"]?.groupCommandMode
         ?? account.groupCommandMode;
 }
+export function effectiveOutputVisibility(account, chatId, chatType) {
+    return account.chats?.[chatId]?.outputVisibility
+        ?? (chatType === "group" ? account.groups?.[chatId]?.outputVisibility : undefined)
+        ?? (chatType === "group" ? account.groups?.["*"]?.outputVisibility : undefined)
+        ?? account.outputVisibility
+        ?? "normal";
+}
 function readReconnect(raw) {
     const s = raw && typeof raw === "object" ? raw : {};
     return {
@@ -253,11 +287,14 @@ 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);
     const ownerUserId = readOptionalString(channel.ownerUserId) || readEnvString(env, CLAWCHAT_OWNER_USER_ID_ENV);
     const enabled = typeof channel.enabled === "boolean" ? channel.enabled : true;
+    const outputVisibility = readOutputVisibility(channel.outputVisibility);
+    const chats = readChats(channel.chats);
     const groupMode = readGroupMode(channel.groupMode);
     const groupCommandMode = readGroupCommandMode(channel.groupCommandMode);
     const groups = readGroups(channel.groups);
@@ -276,10 +313,13 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
         }),
         websocketUrl,
         baseUrl,
+        mediaBaseUrl,
         token,
         agentId,
         userId,
         ownerUserId,
+        outputVisibility,
+        chats,
         groupMode,
         groupCommandMode,
         groups,

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

@@ -1,6 +1,7 @@
 import { interactiveReplyToPresentation, renderMessagePresentationFallbackText, } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolveOutboundMediaUrls } from "openclaw/plugin-sdk/reply-payload";
 import { createOpenclawClawlingApiClient } from "./api-client.js";
+import { effectiveOutputVisibility, } from "./config.js";
 import { uploadOutboundMedia } from "./media-runtime.js";
 import { sendOpenclawClawlingText, } from "./outbound.js";
 import { isClawChatNoopResponseText } from "./profile-prompt.js";
@@ -106,15 +107,14 @@ function resolvePayloadText(payload) {
 /**
  * Reply dispatcher for clawchat-plugin-openclaw.
  *
- * The plugin intentionally forces complete-message delivery. It sets
- * `disableBlockStreaming: true` in reply options so OpenClaw does not split
- * deliver blocks for this channel. If the host still delivers non-final
- * blocks, the dispatcher buffers or ignores them and only emits materialized
- * `message.send` / `message.reply` frames for the final reply.
+ * ClawChat emits only materialized `message.send` / `message.reply` frames for
+ * the final reply. Non-final OpenClaw deliveries are ignored or buffered
+ * according to outputVisibility and are never sent as separate ClawChat frames.
  */
 export function createOpenclawClawlingReplyDispatcher(options) {
     const { cfg, runtime, account, client, target, replyCtx, inboundMessageId, store, log, } = options;
     const isGroupTarget = target.chatType === "group";
+    const outputVisibility = effectiveOutputVisibility(account, target.chatId, target.chatType);
     const ownerDirectTarget = () => {
         const ownerUserId = account.ownerUserId?.trim();
         return ownerUserId ? { chatId: ownerUserId, chatType: "direct" } : null;
@@ -125,6 +125,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
             return null;
         return createOpenclawClawlingApiClient({
             baseUrl: account.baseUrl,
+            mediaBaseUrl: account.mediaBaseUrl,
             token: account.token,
             userId: account.userId,
         });
@@ -141,6 +142,8 @@ export function createOpenclawClawlingReplyDispatcher(options) {
     }
     // ----- Reply state ------------------------------------------------------
     let reasoningText = "";
+    let bufferedOutputText = "";
+    const bufferedOutputUrls = [];
     let runDone = false;
     let typingActive = false;
     let terminalReplySuppressed = false;
@@ -228,6 +231,37 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         recordOutbound("thinking", messageId, thinkingText);
         reasoningText = "";
     };
+    const resetBufferedOutput = () => {
+        bufferedOutputText = "";
+        bufferedOutputUrls.length = 0;
+    };
+    const appendBufferedText = (value) => {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return;
+        bufferedOutputText = bufferedOutputText ? `${bufferedOutputText}\n${trimmed}` : trimmed;
+    };
+    const appendBufferedUrls = (urls) => {
+        for (const url of urls) {
+            if (url && !bufferedOutputUrls.includes(url))
+                bufferedOutputUrls.push(url);
+        }
+    };
+    const mergeFinalText = (text) => {
+        if (outputVisibility !== "full")
+            return text;
+        return [bufferedOutputText.trim(), text.trim()].filter(Boolean).join("\n");
+    };
+    const mergeFinalUrls = (urls) => {
+        if (outputVisibility === "minimal")
+            return urls;
+        const merged = bufferedOutputUrls.slice();
+        for (const url of urls) {
+            if (url && !merged.includes(url))
+                merged.push(url);
+        }
+        return merged;
+    };
     const mintStaticMessageId = () => `${account.userId}-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     const emitTyping = (isTyping) => {
         if (!isTyping && !typingActive)
@@ -341,6 +375,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         onReplyStart: async () => {
             emitTyping(true);
             reasoningText = "";
+            resetBufferedOutput();
             runDone = false;
         },
         deliver: async (payload, info) => {
@@ -361,13 +396,30 @@ export function createOpenclawClawlingReplyDispatcher(options) {
                 return;
             }
             if (payload.isReasoning) {
-                if (isGroupTarget || !account.forwardThinking)
+                if (isGroupTarget || outputVisibility !== "full")
                     return;
-                reasoningText = text;
+                appendBufferedText(text);
+                const trimmed = text.trim();
+                if (trimmed)
+                    reasoningText = reasoningText ? `${reasoningText}\n${trimmed}` : trimmed;
+                return;
+            }
+            if (info?.kind === "tool") {
+                if (!isGroupTarget && outputVisibility === "full") {
+                    appendBufferedText(text);
+                    appendBufferedUrls(urls);
+                }
                 return;
             }
-            if (info?.kind === "tool")
+            if (info?.kind === "block") {
+                if (!isGroupTarget && outputVisibility === "normal")
+                    appendBufferedUrls(urls);
+                if (!isGroupTarget && outputVisibility === "full") {
+                    appendBufferedText(text);
+                    appendBufferedUrls(urls);
+                }
                 return;
+            }
             if (info?.kind === "final") {
                 if (isClawChatNoopResponseText(text) && !richFragment && urls.length === 0) {
                     log?.info?.(`[${account.accountId}] clawchat-plugin-openclaw final suppressed: no-reply token`);
@@ -390,15 +442,15 @@ export function createOpenclawClawlingReplyDispatcher(options) {
                     });
                     return;
                 }
-                const mediaFragments = await uploadMediaUrls(urls);
-                const result = await sendStatic(text, mediaFragments, richFragment && account.richInteractions ? [richFragment] : [], { recordMessage: true });
+                const finalText = richFragment && account.richInteractions ? mergeFinalText("") : mergeFinalText(text);
+                const finalUrls = mergeFinalUrls(urls);
+                const mediaFragments = await uploadMediaUrls(finalUrls);
+                const result = await sendStatic(finalText, mediaFragments, richFragment && account.richInteractions ? [richFragment] : [], { recordMessage: true });
                 if (result?.messageId)
                     recordThinkingIfLinked(result.messageId);
                 return;
             }
-            // kind === "block" or unknown: OpenClaw may still call this path while
-            // the model is producing output. ClawChat gets only the final materialized
-            // reply.
+            // Unknown delivery kind: keep ClawChat output tied to OpenClaw final.
         },
         onError: (error, info) => {
             const errorText = normalizeReplyErrorText(error);
@@ -423,7 +475,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         replyOptions: {
             ...base.replyOptions,
             sourceReplyDeliveryMode: "automatic",
-            disableBlockStreaming: true,
+            disableBlockStreaming: outputVisibility !== "full",
         },
         markDispatchIdle: base.markDispatchIdle,
     };

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",