clawgram 2.5.1 → 2.6.1

package/dist/channel.js

@@ -1120,8 +1120,16 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
                     return null;
                 }
                 return {
-                    actions: ["send", "read", "participants", "joins", "react", "chatInfo"],
+                    // `upload-file` is what core dispatches when an agent has an
+                    // attachment to deliver — a generated image is the common case.
+                    // Leaving it out does not degrade to a text send: the agent simply
+                    // never sees a way to send the file, announces it in words, and the
+                    // file stays on disk. That is exactly what happened on 2026-08-07.
+                    actions: ["send", "read", "participants", "joins", "react", "chatInfo", "upload-file"],
                     capabilities: [],
+                    mediaSourceParams: {
+                        "upload-file": ["filePath", "path", "media"],
+                    },
                 };
             },
             extractToolSend: ({ args }) => (0, tool_send_1.extractToolSend)(args, "sendMessage"),
@@ -1308,6 +1316,75 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
                         removed: reactionParams.remove,
                     });
                 }
+                // Core normalizes whichever of these it filled in to a local path (see
+                // `mediaSourceParams` above); `mediaUrl` stays a URL, which GramJS
+                // accepts as well.
+                const attachedFile = (0, param_readers_1.readStringParam)(params, "filePath")
+                    ?? (0, param_readers_1.readStringParam)(params, "path")
+                    ?? (0, param_readers_1.readStringParam)(params, "media")
+                    ?? (0, param_readers_1.readStringParam)(params, "mediaUrl");
+                // Core dispatches `upload-file`; `sendAttachment` is its legacy alias
+                // and arrives from older callers. A plain `send` carrying a file lands
+                // here too — `openclaw message send --media` does exactly that, and
+                // routing it to the text path dropped the file without a word.
+                if (action === "upload-file" || action === "sendAttachment" || (action === "send" && attachedFile)) {
+                    const rawUploadTo = (0, helpers_1.resolveActionTarget)(params, toolContext);
+                    const uploadTo = (0, helpers_1.normalizeOutboundTarget)(rawUploadTo);
+                    const uploadAccountId = resolveRuntimeAccountId(cfg, accountId);
+                    if (!uploadAccountId) {
+                        throw new Error("clawgram: no configured account found");
+                    }
+                    const file = attachedFile;
+                    if (!file) {
+                        throw new Error("clawgram: upload-file requires filePath, path, media, or mediaUrl");
+                    }
+                    const captionText = (0, helpers_1.readMessageText)(params) || ((0, param_readers_1.readStringParam)(params, "caption") ?? "");
+                    // A caption is optional, but the silent-reply sentinel must never
+                    // reach Telegram as one — same reasoning as the `send` path below.
+                    const caption = captionText.trim() && (0, helpers_1.isSilentReplyText)(captionText)
+                        ? ""
+                        : captionText.replaceAll("\\n", "\n");
+                    const uploadReplyToId = (0, param_readers_1.readStringOrNumberParam)(params, "replyToId") ?? (0, param_readers_1.readStringOrNumberParam)(params, "replyTo");
+                    const uploadThreadId = (0, param_readers_1.readStringOrNumberParam)(params, "threadId");
+                    actionLog.info("clawgram handleAction upload-file", {
+                        accountId: uploadAccountId,
+                        dryRun: dryRun === true,
+                        to: uploadTo,
+                        hasCaption: Boolean(caption),
+                        replyToId: uploadReplyToId ?? null,
+                        threadId: uploadThreadId ?? null,
+                    });
+                    if (dryRun === true) {
+                        return (0, core_1.jsonResult)({
+                            ok: true,
+                            dryRun: true,
+                            to: uploadTo,
+                            accountId: uploadAccountId,
+                        });
+                    }
+                    const uploadGram = runtimes.get(uploadAccountId);
+                    if (!uploadGram) {
+                        throw new Error(`clawgram: runtime not found for account ${uploadAccountId}`);
+                    }
+                    const uploaded = await uploadGram.sendMedia({
+                        target: uploadTo,
+                        file,
+                        caption: caption || undefined,
+                        replyToMessageId: (0, helpers_1.resolveReplyToMessageIdForTarget)(rawUploadTo, uploadReplyToId),
+                        messageThreadId: parseOptionalThreadId(uploadThreadId),
+                    });
+                    actionLog.info("clawgram handleAction upload-file completed", {
+                        accountId: uploadAccountId,
+                        to: uploadTo,
+                        sentMessageId: String(uploaded?.id ?? ""),
+                    });
+                    return (0, core_1.jsonResult)({
+                        ok: true,
+                        to: uploadTo,
+                        accountId: uploadAccountId,
+                        messageId: String(uploaded?.id ?? ""),
+                    });
+                }
                 if (action !== "send") {
                     throw new Error(`clawgram: unsupported message action ${action}`);
                 }

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "clawgram",
   "name": "Clawgram",
   "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawgram",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
   "main": "./dist/index.js",
   "scripts": {