clawgram 2.5.0 → 2.6.0

package/dist/channel.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createChannelPlugin = void 0;
 const core_1 = require("openclaw/plugin-sdk/core");
 const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
 /** Attachments above this are left unread: a long recording or a huge image is
  *  a different conversation from a spoken line or a screenshot, and the
  *  transfer is not free. */
@@ -77,6 +79,25 @@ function parseOptionalThreadId(value) {
  * "you sent something I could not read" than staying silent, which is
  * indistinguishable from being offline.
  */
+/**
+ * Locates the agent directory that image understanding needs.
+ *
+ * Image models are called with the agent's own credentials, so the pipeline
+ * refuses to run without this path — audio does not need it, which is why
+ * voice notes worked before images did. The platform exposes no resolver to
+ * plugins, so the documented layout is reconstructed here and checked before
+ * use: a wrong guess would fail the read anyway, and returning undefined lets
+ * the caller degrade instead of throwing.
+ */
+function resolveAgentDirForMedia(cfg) {
+    const stateDir = typeof process.env.OPENCLAW_STATE_DIR === "string" && process.env.OPENCLAW_STATE_DIR.trim()
+        ? process.env.OPENCLAW_STATE_DIR.trim()
+        : node_path_1.default.join(node_os_1.default.homedir(), ".openclaw");
+    const configuredId = cfg?.agents?.defaults?.id;
+    const agentId = typeof configuredId === "string" && configuredId.trim() ? configuredId.trim() : "main";
+    const dir = node_path_1.default.join(stateDir, "agents", agentId, "agent");
+    return (0, node_fs_1.existsSync)(dir) ? dir : undefined;
+}
 async function readInboundAttachment(params) {
     const media = params.runtime?.mediaUnderstanding;
     const message = params.event?.message;
@@ -115,6 +136,7 @@ async function readInboundAttachment(params) {
                 filePath: downloaded.path,
                 cfg: params.cfg,
                 mime: downloaded.mimeType,
+                agentDir: resolveAgentDirForMedia(params.cfg),
             });
         const read = typeof result?.text === "string" ? result.text.trim() : "";
         if (!read) {
@@ -1098,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"),
@@ -1286,6 +1316,72 @@ const createChannelPlugin = (runtimes, pluginRuntime) => {
                         removed: reactionParams.remove,
                     });
                 }
+                // Core dispatches `upload-file`; `sendAttachment` is its legacy alias
+                // and arrives from older callers, so both land here.
+                if (action === "upload-file" || action === "sendAttachment") {
+                    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");
+                    }
+                    // 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 file = (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");
+                    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.0",
+  "version": "2.6.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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