@wecom/wecom-openclaw-plugin 2026.7.2 → 2026.8.17-beta.1

package/dist/src/cli/process-output.js

@@ -0,0 +1,43 @@
+export class BoundedOutputCollector {
+    maxBytes;
+    keep;
+    buffer = Buffer.alloc(0);
+    originalBytes = 0;
+    constructor(maxBytes, keep = "head") {
+        this.maxBytes = maxBytes;
+        this.keep = keep;
+    }
+    append(chunk) {
+        const data = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        this.originalBytes += data.length;
+        if (this.maxBytes <= 0)
+            return;
+        if (this.keep === "head") {
+            const remaining = this.maxBytes - this.buffer.length;
+            if (remaining > 0)
+                this.buffer = Buffer.concat([this.buffer, data.subarray(0, remaining)]);
+            return;
+        }
+        if (data.length >= this.maxBytes) {
+            this.buffer = Buffer.from(data.subarray(data.length - this.maxBytes));
+            return;
+        }
+        const combined = Buffer.concat([this.buffer, data]);
+        this.buffer =
+            combined.length <= this.maxBytes
+                ? combined
+                : Buffer.from(combined.subarray(combined.length - this.maxBytes));
+    }
+    result() {
+        let text = this.buffer.toString("utf8");
+        if (this.keep === "head")
+            text = text.replace(/\uFFFD+$/, "");
+        else
+            text = text.replace(/^\uFFFD+/, "");
+        return {
+            text,
+            originalBytes: this.originalBytes,
+            truncated: this.originalBytes > this.buffer.length,
+        };
+    }
+}

package/dist/src/cli/tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * wecom-cli — 把 @wecom/cli 包装成 openclaw tool
+ *
+ * 为什么包装成 tool 而不是让 agent 用 exec 直接跑：
+ * 1. 企微会话常见的 `messaging` profile 里没有 exec 工具
+ * 2. **更关键**：exec 无法可靠注入 per-bot 的 WECOM_CLI_CONFIG_DIR。
+ *    模型漏带一次 env 就会落到默认目录，拿 A 企业的凭据调 B 企业的接口——
+ *    这是数据越权，不是功能降级。tool 让配置目录完全由服务端决定。
+ * 3. 插件私有 node_modules/.bin 不在 PATH，PATH 上反而可能是用户全局装的 cli
+ */
+import * as path from "node:path";
+export interface CreateWeComCliToolOptions {
+    /** 当前会话对应的账号 ID（来自 ctx.agentAccountId） */
+    accountId?: string;
+}
+export declare function prepareCliArguments(params: unknown): unknown;
+export declare function createWeComCliTool(options?: CreateWeComCliToolOptions): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            args: {
+                type: "array";
+                items: {
+                    type: "string";
+                };
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    prepareArguments: typeof prepareCliArguments;
+    execute(_toolCallId: string, params: unknown): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: unknown;
+    }>;
+};
+/** 仅用于测试 */
+export declare function resetCliToolState(): void;
+export { path as _path };

package/dist/src/cli/tool.js

@@ -0,0 +1,363 @@
+/**
+ * wecom-cli — 把 @wecom/cli 包装成 openclaw tool
+ *
+ * 为什么包装成 tool 而不是让 agent 用 exec 直接跑：
+ * 1. 企微会话常见的 `messaging` profile 里没有 exec 工具
+ * 2. **更关键**：exec 无法可靠注入 per-bot 的 WECOM_CLI_CONFIG_DIR。
+ *    模型漏带一次 env 就会落到默认目录，拿 A 企业的凭据调 B 企业的接口——
+ *    这是数据越权，不是功能降级。tool 让配置目录完全由服务端决定。
+ * 3. 插件私有 node_modules/.bin 不在 PATH，PATH 上反而可能是用户全局装的 cli
+ */
+import * as path from "node:path";
+import { spawn } from "./process-launcher.js";
+import { getWeComRuntime } from "../runtime.js";
+import { hasMultiAccounts, resolveWeComAccountMulti } from "../accounts.js";
+import { resolveStateDir } from "../state-dir-resolve.js";
+import { CLI_ENV_PASSTHROUGH, CLI_KILL_FORCE_WAIT_MS, CLI_KILL_GRACE_MS, CLI_LOG, CLI_MAX_OUTPUT_BYTES, CLI_RESIGN_CODES, CLI_TIMEOUT_MS, CLI_TOOL_NAME, } from "./const.js";
+import { CliArgvError, normalizeArgs } from "./argv.js";
+import { CliAuthError, ensureSynced } from "./credentials.js";
+import { locateCliBinary } from "./locate.js";
+import { BoundedOutputCollector } from "./process-output.js";
+// ============================================================================
+// 响应构造
+// ============================================================================
+const textResult = (data) => {
+    const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return { content: [{ type: "text", text }], details: data };
+};
+const errorResult = (message, extra) => textResult({ error: message, ...extra });
+/**
+ * 解析当前会话对应的 bot 凭据。
+ *
+ * ⚠️刻意**不继承** resolveCurrentAccountId() 的"回退默认账号"行为：
+ * 多账号场景下上下文丢失时回退，等于拿 A 企业的凭据调 B 企业的接口。
+ * 宁可失败也不能串号—— 只有单账号模式才允许回退。
+ */
+function resolveBot(accountId) {
+    let cfg;
+    try {
+        cfg = getWeComRuntime().config.loadConfig();
+    }
+    catch {
+        throw new CliAuthError("插件运行时未初始化，无法读取 openclaw 配置");
+    }
+    const multi = hasMultiAccounts(cfg);
+    const id = accountId?.trim();
+    if (!id && multi) {
+        throw new CliAuthError("当前会话缺少账号上下文（agentAccountId），而配置中存在多个企业微信账号。" +
+            "为避免误用其他企业的凭据，本次调用已被拒绝。请在有明确会话上下文的场景下使用。");
+    }
+    const resolved = resolveWeComAccountMulti({ cfg, accountId: id ?? null });
+    const botId = resolved.botId?.trim();
+    const secret = resolved.secret?.trim();
+    if (!botId || !secret) {
+        throw new CliAuthError(`企业微信账号 "${resolved.accountId}" 未配置 botId / secret，` +
+            "请检查 openclaw 配置 `channels.wecom`");
+    }
+    // 端点覆盖（仅联调用；在未启用 custom-endpoint feature 的正式包上不生效）
+    const rawCliCfg = resolved.config?.cli;
+    const env = {};
+    for (const key of CLI_ENV_PASSTHROUGH) {
+        const v = rawCliCfg?.env?.[key];
+        if (typeof v === "string" && v.trim())
+            env[key] = v.trim();
+    }
+    return { botId, secret, accountId: resolved.accountId, env };
+}
+function resolveBinPath(accountId) {
+    let explicit;
+    try {
+        const cfg = getWeComRuntime().config.loadConfig();
+        const resolved = resolveWeComAccountMulti({ cfg, accountId: accountId ?? null });
+        explicit = resolved.config?.cli?.binPath;
+    }
+    catch {
+        /* 配置不可读时走默认寻址 */
+    }
+    const located = locateCliBinary(explicit);
+    if (located.ok)
+        return { binPath: located.binPath, source: located.source };
+    throw new CliAuthError("未找到 wecom-cli 可执行文件，插件安装可能不完整。\n" +
+        `尝试过的位置：\n  ${located.tried.join("\n  ")}\n` +
+        "可通过 openclaw 配置 `channels.wecom.cli.binPath` 显式指定二进制路径。");
+}
+// ============================================================================
+// spawn（按 botId 串行化）
+// ============================================================================
+/**
+ * 同一 botId 的调用串行执行。
+ *
+ * 原因：cli 的 refresh_lock 只是**进程内**锁，credentials.enc 虽然是原子写但
+ * 没有跨进程文件锁。并发进程同时遇到 853004 会各自去换token（可能撞 45009）
+ * 并互相覆盖。企微场景 QPS 极低，串行化几乎无感知。
+ */
+const queues = new Map();
+function serialize(botId, task) {
+    const prev = queues.get(botId) ?? Promise.resolve();
+    const next = prev.then(task, task);
+    queues.set(botId, next.catch(() => undefined));
+    return next;
+}
+function runCli(binPath, argv, configDir, env) {
+    return new Promise((resolve, reject) => {
+        const started = Date.now();
+        const child = spawn(binPath, argv, {
+            shell: false,
+            // cwd 固定到 state 目录：cli 启动时会读cwd 下的 .env，避免被无关目录污染；
+            // 同时 cli 用 cwd 解析相对路径，因此 skills 中一律要求绝对路径
+            cwd: resolveStateDir(),
+            env: {
+                PATH: process.env.PATH ?? "",
+                HOME: process.env.HOME ?? "",
+                ...(process.platform === "win32"
+                    ? { USERPROFILE: process.env.USERPROFILE ?? "", SystemRoot: process.env.SystemRoot ?? "" }
+                    : {}),
+                WECOM_CLI_CONFIG_DIR: configDir,
+                // 压掉 cli 的 info/debug 噪音，避免 stderr 淹没真实错误
+                WECOM_CLI_LOG_LEVEL: "warn",
+                ...env,
+            },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdout = new BoundedOutputCollector(CLI_MAX_OUTPUT_BYTES, "head");
+        const stderr = new BoundedOutputCollector(CLI_MAX_OUTPUT_BYTES, "tail");
+        let timedOut = false;
+        let settled = false;
+        let graceTimer;
+        let forceWaitTimer;
+        child.stdout.on("data", (chunk) => stdout.append(chunk));
+        child.stderr.on("data", (chunk) => stderr.append(chunk));
+        const clearTimers = () => {
+            clearTimeout(killTimer);
+            if (graceTimer)
+                clearTimeout(graceTimer);
+            if (forceWaitTimer)
+                clearTimeout(forceWaitTimer);
+        };
+        const finish = (status) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimers();
+            const stdoutResult = stdout.result();
+            resolve({
+                status,
+                stdout: stdoutResult.text,
+                stderr: stderr.result().text,
+                stdoutBytes: stdoutResult.originalBytes,
+                stdoutTruncated: stdoutResult.truncated,
+                ms: Date.now() - started,
+                timedOut,
+            });
+        };
+        const killTimer = setTimeout(() => {
+            timedOut = true;
+            if (child.exitCode === null && child.signalCode === null)
+                child.kill("SIGTERM");
+            graceTimer = setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null)
+                    child.kill("SIGKILL");
+                forceWaitTimer = setTimeout(() => {
+                    child.stdout.destroy();
+                    child.stderr.destroy();
+                    finish(child.exitCode);
+                }, CLI_KILL_FORCE_WAIT_MS);
+            }, CLI_KILL_GRACE_MS);
+        }, CLI_TIMEOUT_MS);
+        child.on("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimers();
+            reject(err);
+        });
+        child.on("close", (status) => finish(status));
+    });
+}
+// ============================================================================
+// 结果分类
+// ============================================================================
+function parseErrorPayload(stdout) {
+    try {
+        const parsed = JSON.parse(stdout);
+        return parsed?.error ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 从 cli 的裸企微响应里提取 errcode（如 token 过期时会直接透出 {errcode,errmsg}） */
+function parseErrcode(stdout) {
+    try {
+        const parsed = JSON.parse(stdout);
+        return typeof parsed?.errcode === "number" ? parsed.errcode : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 改写 cli 的错误文案。
+ *
+ * cli 会提示用户去跑 `wecom auth init`，但手工执行会绕过 openclaw 配置、
+ * 把凭据写到默认目录（而本会话读的是插件按 botId+secret 分配的目录），
+ * 且需要用户自己拿到 secret。凭据由插件统一管理，必须改写为引导改配置。
+ */
+function rewriteMessage(message) {
+    if (/auth\s+init/i.test(message)) {
+        return "企业微信凭据不可用。请检查 openclaw 配置 `channels.wecom` 中的 botId / secret（请勿手动执行 wecom-cli auth init，凭据由插件统一管理）。";
+    }
+    return message;
+}
+// ============================================================================
+// 工具定义
+// ============================================================================
+const DESCRIPTION = [
+    "执行企业微信命令行（wecom-cli），用于访问通讯录、文档、会议、日程、待办、智能表格等企业微信能力。",
+    "",
+    "参数 `args` 是命令行中 `wecom-cli ` 之后的字符串数组。",
+    "例如：[\"contact\",\"users\",\"search\",\"--json\",\"{\\\"keywords\\\":[\\\"张三\\\"]}\"]",
+    "参数值本身含引号、空格或特殊字符时，仍作为一个完整数组元素传入。",
+    "",
+    "重要约束：",
+    "  - 相关 skill 文档中给出的命令，一律通过本 tool 执行；",
+    "    **禁止**使用 exec / bash / shell / npx 或全局命令直接运行 wecom-cli，那会绕过当前会话的企业凭据隔离。",
+    "  - 本 tool 内部自行寻址并启动 wecom-cli 二进制是正常实现；禁止的是 Agent 主动改用通用执行工具。",
+    "  - 本 tool 调用失败、不可见、权限不足或提示授权时，不得降级到 exec，也不得手动执行 auth init；应直接报告工具权限或 `channels.wecom` 配置问题。",
+    "  - 不要在 args 中写 `wecom-cli` 前缀，也不要拼接 shell 命令（管道、重定向、&& 等）。",
+    "  - 不要传入任何 WECOM_CLI_* 环境变量或 --config-dir：运行环境由插件按当前会话的机器人自动注入。",
+    "  - 涉及本地文件的参数请使用绝对路径。",
+    "  - 想了解某个方法的参数结构时，可在命令末尾加 `--schema` 或 `--doc`。",
+].join("\n");
+export function prepareCliArguments(params) {
+    if (!params || typeof params !== "object" || Array.isArray(params))
+        return params;
+    const value = params;
+    if (typeof value.args !== "string")
+        return params;
+    return { ...value, args: normalizeArgs(value.args) };
+}
+export function createWeComCliTool(options = {}) {
+    const accountId = options.accountId?.trim() || undefined;
+    return {
+        name: CLI_TOOL_NAME,
+        label: "企业微信命令行",
+        description: DESCRIPTION,
+        parameters: {
+            type: "object",
+            properties: {
+                args: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "命令行中 `wecom-cli ` 之后的字符串数组，" +
+                        "例如 [\"contact\",\"users\",\"search\",\"--json\",\"{\\\"keywords\\\":[\\\"张三\\\"]}\"]",
+                },
+            },
+            required: ["args"],
+            additionalProperties: false,
+        },
+        prepareArguments: prepareCliArguments,
+        async execute(_toolCallId, params) {
+            const raw = params?.args;
+            // 1. 入参归一化 + 安全校验
+            let argv;
+            try {
+                argv = normalizeArgs(raw);
+            }
+            catch (err) {
+                if (err instanceof CliArgvError)
+                    return errorResult(err.message);
+                throw err;
+            }
+            // 2. 解析当前会话的 bot 与二进制
+            let bot;
+            let binPath;
+            let binSource;
+            try {
+                bot = resolveBot(accountId);
+                ({ binPath, source: binSource } = resolveBinPath(accountId));
+            }
+            catch (err) {
+                return errorResult(err instanceof Error ? err.message : String(err));
+            }
+            const cmdForLog = argv.join(" ");
+            return serialize(bot.botId, async () => {
+                const attempt = async (force) => {
+                    const dir = await ensureSynced({
+                        binPath,
+                        botId: bot.botId,
+                        secret: bot.secret,
+                        env: bot.env,
+                        force,
+                    });
+                    return runCli(binPath, argv, dir, bot.env);
+                };
+                try {
+                    let out = await attempt(false);
+                    // 3. 凭据类错误 → 强制重签一次后重试（受 5 分钟熔断约束）
+                    //必要性：cli 的 853004 自动刷新在当前版本会因缺少请求头被 48002 拒绝，
+                    //    插件不能完全依赖 cli 自愈。
+                    const code = parseErrorPayload(out.stdout)?.code ?? parseErrcode(out.stdout);
+                    if (out.status !== 0 && code != null && CLI_RESIGN_CODES.has(code)) {
+                        console.warn(`${CLI_LOG} 凭据失效 (code=${code})，强制重签后重试：${cmdForLog}`);
+                        try {
+                            out = await attempt(true);
+                        }
+                        catch (err) {
+                            if (err instanceof CliAuthError)
+                                return errorResult(err.message, { errcode: err.errcode });
+                            throw err;
+                        }
+                    }
+                    // 4. 结果整理
+                    if (out.timedOut) {
+                        return errorResult(`命令执行超时（${CLI_TIMEOUT_MS / 1000}s）：wecom-cli ${cmdForLog}`, { stderr: out.stderr.slice(-2048) || undefined });
+                    }
+                    // exit2 = clap 参数/子命令错误，错误文本在 stderr，且常意味着 skills 与 cli 版本不匹配
+                    if (out.status === 2) {
+                        console.warn(`${CLI_LOG} 命令不存在或参数非法 (exit 2) via=${binSource}：${cmdForLog}`);
+                        return errorResult(`命令不存在或参数非法：wecom-cli ${cmdForLog}\n${out.stderr.trim().slice(0, 1500)}`, { hint: "该命令在当前 wecom-cli 版本中不可用，技能文档可能与 CLI 版本不一致。可用 `--help` 查看可用子命令。" });
+                    }
+                    const errPayload = parseErrorPayload(out.stdout);
+                    if (out.status !== 0 || errPayload) {
+                        const message = rewriteMessage(errPayload?.message ?? (out.stderr.trim() || `命令执行失败（exit ${out.status}）`));
+                        console.warn(`${CLI_LOG} 调用失败 (${out.ms}ms, exit=${out.status}) ${cmdForLog} → ` +
+                            JSON.stringify(errPayload ?? out.stderr.slice(-500)));
+                        return errorResult(message, {
+                            errcode: errPayload?.code,
+                            endpoint: errPayload?.endpoint,
+                            httpStatus: errPayload?.status,
+                        });
+                    }
+                    const text = out.stdout.trim();
+                    console.log(`${CLI_LOG} ok (${out.ms}ms, ${out.stdoutBytes}B${out.stdoutTruncated ? " 已截断" : ""}) ` +
+                        `via=${binSource} ${cmdForLog}`);
+                    if (out.stdoutTruncated) {
+                        return textResult(`${text}\n\n[输出过大已截断：原始 ${out.stdoutBytes} 字节，上限 ${CLI_MAX_OUTPUT_BYTES} 字节。` +
+                            "请缩小查询范围（例如使用更精确的关键词、加上分页或筛选参数）后重试。]");
+                    }
+                    return textResult(text);
+                }
+                catch (err) {
+                    if (err instanceof CliAuthError)
+                        return errorResult(err.message, { errcode: err.errcode });
+                    const e = err;
+                    if (e?.code === "ENOENT") {
+                        return errorResult(`wecom-cli 可执行文件不存在：${binPath}。插件安装可能不完整，请重新安装，` +
+                            "或通过 `channels.wecom.cli.binPath` 指定路径。");
+                    }
+                    if (e?.code === "EACCES") {
+                        return errorResult(`wecom-cli 没有执行权限：${binPath}。请执行 chmod +x 或重新安装插件。`);
+                    }
+                    console.error(`${CLI_LOG} 异常 ${cmdForLog} → ${e?.message ?? String(err)}`);
+                    return errorResult(e?.message ?? String(err));
+                }
+            });
+        },
+    };
+}
+/** 仅用于测试 */
+export function resetCliToolState() {
+    queues.clear();
+}
+export { path as _path };

package/dist/src/const.d.ts

@@ -46,14 +46,6 @@ export declare const THINKING_MESSAGE = "<think></think>";
 export declare const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
 /** 仅包含文件时的消息占位符 */
 export declare const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
-/** 获取 MCP 配置的 WebSocket 命令 */
-export declare const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
-/** 发送业务消息的 WebSocket 命令（如文档授权卡片） */
-export declare const AIBOT_SEND_BIZ_MSG_CMD = "aibot_send_biz_msg";
-/** 业务消息超时时间（毫秒） */
-export declare const BIZ_MSG_SEND_TIMEOUT_MS = 10000;
-/** MCP 配置拉取超时时间（毫秒） */
-export declare const MCP_CONFIG_FETCH_TIMEOUT_MS = 15000;
 /** 默认媒体大小上限（MB） */
 export declare const DEFAULT_MEDIA_MAX_MB = 5;
 /** 文本分块大小上限 */

package/dist/src/const.js

@@ -59,20 +59,6 @@ export const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
 // ============================================================================
 // 默认值
 // ============================================================================
-// ============================================================================
-// MCP 配置
-// ============================================================================
-/** 获取 MCP 配置的 WebSocket 命令 */
-export const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
-/** 发送业务消息的 WebSocket 命令（如文档授权卡片） */
-export const AIBOT_SEND_BIZ_MSG_CMD = "aibot_send_biz_msg";
-/** 业务消息超时时间（毫秒） */
-export const BIZ_MSG_SEND_TIMEOUT_MS = 10_000;
-/** MCP 配置拉取超时时间（毫秒） */
-export const MCP_CONFIG_FETCH_TIMEOUT_MS = 15_000;
-// ============================================================================
-// 默认值
-// ============================================================================
 /** 默认媒体大小上限（MB） */
 export const DEFAULT_MEDIA_MAX_MB = 5;
 /** 文本分块大小上限 */

package/dist/src/monitor.js

@@ -29,7 +29,7 @@ import { sendWeComReply, StreamExpiredError } from "./message-sender.js";
 import { enqueueWeComChatTask } from "./chat-queue.js";
 import { getDefaultMediaLocalRoots, resolveStateDir } from "./openclaw-compat.js";
 import { getWeComRuntime } from "./runtime.js";
-import { setWeComWebSocket, setMessageState, deleteMessageState, setReqIdForChat, setSessionChatInfo, warmupReqIdStore, startMessageStateCleanup, stopMessageStateCleanup, cleanupAccount, } from "./state-manager.js";
+import { setWeComWebSocket, setMessageState, deleteMessageState, setReqIdForChat, warmupReqIdStore, startMessageStateCleanup, stopMessageStateCleanup, cleanupAccount, } from "./state-manager.js";
 import { updateTemplateCardOnEvent, processTemplateCardsIfNeeded, } from "./template-card-manager.js";
 import { maskTemplateCardBlocks } from "./template-card-parser.js";
 import { PLUGIN_VERSION } from "./version.js";
@@ -628,17 +628,6 @@ async function processWeComMessageNow(entry) {
     // }
     // Step 7: 构建上下文并路由到核心处理流程（带整体超时保护）
     const { ctxPayload, route, storePath, chatId: resolvedChatId, chatType, } = buildMessageContext(frame, account, config, text, mediaList, quoteContent, runtime);
-    // 以 sessionKey 为键记录「原始大小写」的 chatId 与 chatType，
-    // 供 MCP 工具工厂（index.ts:registerTool）在构造工具闭包时取回，
-    // 进而传递给需要原始 chatId 的拦截器（如 doc-auth-error 发送 biz_msg）。
-    //
-    // 注意：不要使用 parseSessionKeyChat 反解 sessionKey —— OpenClaw core
-    //       构建 sessionKey 时会将 peer.id 强制小写化，会导致企业微信
-    //       aibot_send_biz_msg 报 errcode=93006 invalid chatid。
-    setSessionChatInfo(route.sessionKey, {
-        chatId: resolvedChatId,
-        chatType: chatType === "group" ? "group" : "single",
-    });
     // runtime.log?.(`[plugin -> openclaw] body=${text}, mediaPaths=${JSON.stringify(mediaList.map(m => m.path))}${quoteContent ? `, quote=${quoteContent}` : ''}`);
     try {
         await routeAndDispatchMessage({

package/dist/src/state-manager.d.ts

@@ -70,25 +70,6 @@ export declare function warmupReqIdStore(accountId?: string, log?: (...args: unk
  * 注意：由于移除了磁盘存储，此函数现在是无操作
  */
 export declare function flushReqIdStore(accountId?: string): Promise<void>;
-/** 会话 chat 信息 */
-export interface SessionChatInfo {
-    /** 原始大小写的 chatId（群 ID 或用户 ID） */
-    chatId: string;
-    /** 聊天类型：single（单聊）或 group（群聊） */
-    chatType: "single" | "group";
-}
-/**
- * 记录 sessionKey 对应的原始会话信息（由 monitor.ts 在消息入站时调用）
- */
-export declare function setSessionChatInfo(sessionKey: string, info: SessionChatInfo): void;
-/**
- * 获取 sessionKey 对应的原始会话信息（由 registerTool 闭包调用）
- */
-export declare function getSessionChatInfo(sessionKey: string | undefined): SessionChatInfo | undefined;
-/**
- * 删除 sessionKey 对应的会话信息（会话结束时可选调用）
- */
-export declare function deleteSessionChatInfo(sessionKey: string): void;
 /**
  * 清理指定账户的所有资源
  */

package/dist/src/state-manager.js

@@ -201,41 +201,8 @@ export async function warmupReqIdStore(accountId = "default", log) {
 export async function flushReqIdStore(accountId = "default") {
     // 由于移除了磁盘存储，不再需要刷写操作
 }
-/** sessionKey → SessionChatInfo 映射 */
-const sessionChatInfoMap = new Map();
-/** 容量上限，超出按插入顺序淘汰最旧项，避免长时间运行内存增长 */
-const SESSION_CHAT_INFO_MAX_SIZE = 5000;
-/**
- * 记录 sessionKey 对应的原始会话信息（由 monitor.ts 在消息入站时调用）
- */
-export function setSessionChatInfo(sessionKey, info) {
-    if (!sessionKey)
-        return;
-    // 容量控制：超限时淘汰最早插入的条目（Map 保留插入顺序）
-    if (sessionChatInfoMap.size >= SESSION_CHAT_INFO_MAX_SIZE && !sessionChatInfoMap.has(sessionKey)) {
-        const oldestKey = sessionChatInfoMap.keys().next().value;
-        if (oldestKey !== undefined) {
-            sessionChatInfoMap.delete(oldestKey);
-        }
-    }
-    sessionChatInfoMap.set(sessionKey, info);
-}
-/**
- * 获取 sessionKey 对应的原始会话信息（由 registerTool 闭包调用）
- */
-export function getSessionChatInfo(sessionKey) {
-    if (!sessionKey)
-        return undefined;
-    return sessionChatInfoMap.get(sessionKey);
-}
-/**
- * 删除 sessionKey 对应的会话信息（会话结束时可选调用）
- */
-export function deleteSessionChatInfo(sessionKey) {
-    sessionChatInfoMap.delete(sessionKey);
-}
 // ============================================================================
-// 全局 cleanup 原始位置
+// 全局 cleanup（断开连接时释放所有资源）
 // ============================================================================
 /**
  * 清理指定账户的所有资源

package/dist/src/utils.d.ts

@@ -40,6 +40,8 @@ export interface WeComConfig {
     media?: WecomMediaConfig;
     /** 动态 Agent 配置 */
     dynamicAgents?: WecomDynamicAgentsConfig;
+    /** wecom-cli tool 配置 */
+    cli?: WecomCliConfig;
     /** 连接模式：webhook | websocket（默认 websocket） */
     connectionMode?: "webhook" | "websocket";
     /** Webhook 验证 token */
@@ -53,6 +55,31 @@ export interface WeComConfig {
     /** 流式占位符提示内容 */
     streamPlaceholderContent?: string;
 }
+/**
+ * wecom-cli tool 配置
+ */
+export interface WecomCliConfig {
+    /**
+     * 显式指定 wecom-cli 二进制路径。
+     * 不配置时按 `@tencent/wecom-cli-<platform>` → `@wecom/cli-<platform>` 顺序自动寻址。
+     * 联调期可指向本地 cargo 构建产物。
+     */
+    binPath?: string;
+    /**
+     * 透传给 wecom-cli 的环境变量（仅接受下列三个键）。
+     *
+     * 用于把cli 指向测试环境。注意这三个变量在 cli 侧受 `custom-endpoint`
+     * 编译特性门控（默认关闭），未启用该特性的正式包上不生效。
+     *
+     * ⚠️ WECOM_CLI_AUTH_ENDPOINT 必须与插件换取凭据所用端点保持一致，
+     * 否则登录态与业务调用会分属不同环境。
+     */
+    env?: {
+        WECOM_CLI_BASE_URL?: string;
+        WECOM_CLI_AUTH_ENDPOINT?: string;
+        WECOM_CLI_ADDITIONAL_HEADERS?: string;
+    };
+}
 /**
  * 单个企业微信账号的配置类型（用于 accounts 字段下的每个账号）。
  * 与 WeComConfig 字段完全一致，账号级字段会覆盖顶层同名字段。

package/openclaw.plugin.json

@@ -5,7 +5,7 @@
   ],
   "contracts": {
     "tools": [
-      "wecom_mcp"
+      "wecom-cli"
     ]
   },
   "skills": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecom/wecom-openclaw-plugin",
-  "version": "2026.7.2",
+  "version": "2026.8.17-beta.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -65,10 +65,10 @@
   },
   "dependencies": {
     "@wecom/aibot-node-sdk": "^1.0.6",
+    "@wecom/cli": "^1.0.0",
     "fast-xml-parser": "^5.5.9",
     "file-type": "^21.3.0",
-    "undici": "^7.24.6",
-    "zod": "^4.3.6"
+    "undici": "^7.24.6"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.28"

package/skills/wecom-send-media/SKILL.md

@@ -10,6 +10,8 @@ metadata: {"openclaw":{"emoji":"📤","requires":{"config":["channels.wecom"]}}}
 
 通过 `MEDIA:` 指令将本地文件发送给用户。支持的文件类型为：图片、视频、语音、其它文件等。系统会自动识别文件类型，并以对应的消息格式（图片消息、视频消息、语音消息或文件消息）发送。
 
+> **职责边界**：这是企业微信 Channel 的**当前会话文件投递能力**。需要把本轮生成或已有的本地文件交付给当前用户时使用 `MEDIA:`；不要调用 `wecom-cli message` 代替本轮回复的文件投递。`wecom-cli message` 适用于向另一个已选定的企微会话主动发送消息，不属于本技能。
+
 ## 触发条件
 
 - 用户要求发送、展示或分享图片、视频、语音或文件