@pawastation/wechat-kf 0.1.1

package/dist/src/unicode-format.js

@@ -0,0 +1,157 @@
+/**
+ * Markdown → Unicode text formatting
+ *
+ * Converts markdown bold/italic/bold-italic to Unicode Mathematical
+ * Alphanumeric Symbols. Only converts ASCII letters (a-z, A-Z) and
+ * digits (0-9) — other characters pass through unchanged.
+ *
+ * This is meant for plain-text surfaces like WeChat KF where
+ * rich text / HTML isn't supported.
+ */
+// Unicode Mathematical Alphanumeric offsets for A-Z, a-z
+// Bold: U+1D400 (A) / U+1D41A (a)
+// Italic: U+1D434 (A) / U+1D44E (a)
+// Bold Italic: U+1D468 (A) / U+1D482 (a)
+// Bold digits: U+1D7CE (0)
+const BOLD_UPPER_START = 0x1d400;
+const BOLD_LOWER_START = 0x1d41a;
+const BOLD_DIGIT_START = 0x1d7ce;
+const ITALIC_UPPER_START = 0x1d434;
+const ITALIC_LOWER_START = 0x1d44e;
+// Italic has no digit variant — use normal digits
+const BOLD_ITALIC_UPPER_START = 0x1d468;
+const BOLD_ITALIC_LOWER_START = 0x1d482;
+function mapChar(ch, upperStart, lowerStart, digitStart) {
+    const code = ch.charCodeAt(0);
+    if (code >= 65 && code <= 90) {
+        // A-Z
+        return String.fromCodePoint(upperStart + (code - 65));
+    }
+    if (code >= 97 && code <= 122) {
+        // a-z
+        return String.fromCodePoint(lowerStart + (code - 97));
+    }
+    if (digitStart !== undefined && code >= 48 && code <= 57) {
+        // 0-9
+        return String.fromCodePoint(digitStart + (code - 48));
+    }
+    return ch;
+}
+function toBold(text) {
+    return [...text].map((ch) => mapChar(ch, BOLD_UPPER_START, BOLD_LOWER_START, BOLD_DIGIT_START)).join("");
+}
+function toItalic(text) {
+    return [...text]
+        .map((ch) => {
+        // Special case: italic lowercase 'h' is U+210E (ℎ) not in the block
+        if (ch === "h")
+            return "\u210E";
+        return mapChar(ch, ITALIC_UPPER_START, ITALIC_LOWER_START);
+    })
+        .join("");
+}
+function toBoldItalic(text) {
+    return [...text].map((ch) => mapChar(ch, BOLD_ITALIC_UPPER_START, BOLD_ITALIC_LOWER_START)).join("");
+}
+/** Regex matching any placeholder inserted by steps 1-4. */
+const PLACEHOLDER_RE = /\x00(?:CB|IC|ES)\d+\x00/g;
+/**
+ * Apply a Unicode transform while preserving placeholder sequences.
+ * Splits text on placeholder boundaries, transforms only non-placeholder
+ * segments, and reassembles.
+ */
+function applyTransform(text, transform) {
+    let result = "";
+    let lastIndex = 0;
+    for (const match of text.matchAll(PLACEHOLDER_RE)) {
+        const idx = match.index;
+        if (idx > lastIndex) {
+            result += transform(text.slice(lastIndex, idx));
+        }
+        result += match[0];
+        lastIndex = idx + match[0].length;
+    }
+    if (lastIndex < text.length) {
+        result += transform(text.slice(lastIndex));
+    }
+    return result;
+}
+/**
+ * Convert markdown formatting to Unicode styled text.
+ *
+ * Handles:
+ * - `***text***` or `___text___` → bold italic
+ * - `**text**` or `__text__` → bold
+ * - `*text*` or `_text_` → italic
+ * - `` `code` `` → left as-is (backtick preserved)
+ * - ``` code blocks ``` → left as-is
+ * - `# headings` → 𝗛𝗲𝗮𝗱𝗶𝗻𝗴 (bold, # stripped)
+ * - `- list items` / `* list items` → • item
+ * - `1. numbered` → 1. (kept)
+ * - `[text](url)` → text (url)
+ * - `~~strikethrough~~` → stripped markers (no unicode strikethrough that's reliable)
+ */
+export function markdownToUnicode(text) {
+    if (!text)
+        return text;
+    // 1. Preserve code blocks
+    const codeBlocks = [];
+    let result = text.replace(/```[\s\S]*?```/g, (match) => {
+        codeBlocks.push(match.replace(/^```\w*\n?/, "").replace(/\n?```$/, ""));
+        return `\x00CB${codeBlocks.length - 1}\x00`;
+    });
+    // 2. Preserve inline code
+    const inlineCodes = [];
+    result = result.replace(/`([^`\n]+)`/g, (_match, code) => {
+        inlineCodes.push(code);
+        return `\x00IC${inlineCodes.length - 1}\x00`;
+    });
+    // 3. Images: ![alt](url) → [alt](url)  (must come before link handling)
+    result = result.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, "[$1]($2)");
+    // 4. Escape characters: protect \* \_ \~ \` \# \[ \] \( \) \\ \- \!
+    const escapes = [];
+    result = result.replace(/\\([*_~`#[\]()\\!-])/g, (_m, ch) => {
+        escapes.push(ch);
+        return `\x00ES${escapes.length - 1}\x00`;
+    });
+    // 5. Links: [text](url) → text (url)
+    result = result.replace(/\[([^\]]*)\]\(([^)]+)\)/g, "$1 ($2)");
+    // 6. Headings: # text → bold text (before bold/italic so inner markers are also bolded)
+    result = result.replace(/^(#{1,6})\s+(.+)$/gm, (_m, _hashes, content) => {
+        // Strip any inline bold/italic markers before applying bold
+        const stripped = content.replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(/_{1,3}([^_]+)_{1,3}/g, "$1");
+        return applyTransform(stripped, toBold);
+    });
+    // 7. Bold italic: ***text*** or ___text___ (multiline with [\s\S])
+    result = result.replace(/\*{3}([\s\S]+?)\*{3}/g, (_m, inner) => applyTransform(inner, toBoldItalic));
+    result = result.replace(/_{3}([\s\S]+?)_{3}/g, (_m, inner) => applyTransform(inner, toBoldItalic));
+    // 8. Bold: **text** or __text__ (multiline with [\s\S])
+    result = result.replace(/\*{2}([\s\S]+?)\*{2}/g, (_m, inner) => applyTransform(inner, toBold));
+    result = result.replace(/_{2}([\s\S]+?)_{2}/g, (_m, inner) => applyTransform(inner, toBold));
+    // 9. Italic: *text* or _text_ (but not inside words for _)
+    // Use [^*\n] to avoid matching list markers like "* item *"
+    result = result.replace(/(?<!\w)\*([^*\n]+?)\*(?!\w)/g, (_m, inner) => applyTransform(inner, toItalic));
+    result = result.replace(/(?<!\w)_([^_\n]+?)_(?!\w)/g, (_m, inner) => applyTransform(inner, toItalic));
+    // 10. Strikethrough: ~~text~~ → just remove markers
+    result = result.replace(/~~([\s\S]+?)~~/g, "$1");
+    // 11. Task lists (must come before unordered list handling)
+    result = result.replace(/^([ \t]*)-\s+\[x\]\s+/gm, "$1\u2611 ");
+    result = result.replace(/^([ \t]*)-\s+\[ \]\s+/gm, "$1\u2610 ");
+    // 12. Unordered list: - item or * item → • item
+    result = result.replace(/^[ \t]*[-*]\s+/gm, "• ");
+    // 13. Blockquotes: > text → ┃ text
+    result = result.replace(/^>\s?/gm, "┃ ");
+    // 14. Horizontal rules
+    result = result.replace(/^[-*_]{3,}$/gm, "─────────");
+    // 15. Restore code blocks with visual markers
+    result = result.replace(/\x00CB(\d+)\x00/g, (_m, idx) => {
+        const code = codeBlocks[Number(idx)] ?? "";
+        return `\n━━━ code ━━━\n${code}\n━━━━━━━━━━━━\n`;
+    });
+    // 16. Restore inline code with backtick markers
+    result = result.replace(/\x00IC(\d+)\x00/g, (_m, idx) => `\`${inlineCodes[Number(idx)] ?? ""}\``);
+    // 17. Restore escape characters
+    result = result.replace(/\x00ES(\d+)\x00/g, (_m, idx) => escapes[Number(idx)] ?? "");
+    return result;
+}
+//# sourceMappingURL=unicode-format.js.map

package/dist/src/unicode-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode-format.js","sourceRoot":"","sources":["../../src/unicode-format.ts"],"names":[],"mappings":"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"}

package/dist/src/webhook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP webhook server for WeChat KF callbacks
+ *
+ * Handles:
+ * - GET: URL verification (echostr decrypt)
+ * - POST: Event notification (decrypt XML → trigger sync_msg)
+ */
+import { type Server } from "node:http";
+export type WebhookHandler = (openKfId: string, token: string) => void | Promise<void>;
+export type WebhookOptions = {
+    port: number;
+    path: string;
+    callbackToken: string;
+    encodingAESKey: string;
+    corpId: string;
+    onEvent: WebhookHandler;
+    log?: {
+        info: (...a: unknown[]) => void;
+        error: (...a: unknown[]) => void;
+    };
+};
+export declare function createWebhookServer(opts: WebhookOptions): Server;

package/dist/src/webhook.js

@@ -0,0 +1,138 @@
+/**
+ * HTTP webhook server for WeChat KF callbacks
+ *
+ * Handles:
+ * - GET: URL verification (echostr decrypt)
+ * - POST: Event notification (decrypt XML → trigger sync_msg)
+ */
+import { createServer } from "node:http";
+import { decrypt, verifySignature } from "./crypto.js";
+function parseQuery(url) {
+    const idx = url.indexOf("?");
+    if (idx < 0)
+        return {};
+    const params = {};
+    for (const pair of url.slice(idx + 1).split("&")) {
+        const eqIdx = pair.indexOf("=");
+        if (eqIdx < 0)
+            continue;
+        const k = pair.slice(0, eqIdx);
+        const v = pair.slice(eqIdx + 1);
+        if (k)
+            params[decodeURIComponent(k)] = decodeURIComponent(v);
+    }
+    return params;
+}
+function readBody(req, maxSize = 64 * 1024) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let rejected = false;
+        req.on("data", (c) => {
+            if (rejected)
+                return;
+            size += c.length;
+            if (size > maxSize) {
+                rejected = true;
+                // Stop buffering but keep the connection alive so the server
+                // can still write a response (413). Resume drains remaining data.
+                req.removeAllListeners("data");
+                req.resume();
+                reject(new Error("[wechat-kf] request body too large"));
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on("end", () => {
+            if (!rejected)
+                resolve(Buffer.concat(chunks).toString("utf8"));
+        });
+        req.on("error", (err) => {
+            if (!rejected)
+                reject(err);
+        });
+    });
+}
+/** Extract a tag value from XML string */
+function xmlTag(xml, tag) {
+    const re = new RegExp(`<${tag}><!\\[CDATA\\[(.+?)\\]\\]></${tag}>|<${tag}>(.+?)</${tag}>`);
+    const m = xml.match(re);
+    return m?.[1] ?? m?.[2];
+}
+export function createWebhookServer(opts) {
+    const { path, callbackToken, encodingAESKey, onEvent, log } = opts;
+    const server = createServer(async (req, res) => {
+        const url = req.url ?? "/";
+        const pathname = url.split("?")[0];
+        if (pathname !== path) {
+            res.writeHead(404);
+            res.end("not found");
+            return;
+        }
+        const query = parseQuery(url);
+        try {
+            if (req.method === "GET") {
+                // URL verification
+                const { msg_signature, timestamp, nonce, echostr } = query;
+                if (!msg_signature || !timestamp || !nonce || !echostr) {
+                    res.writeHead(400);
+                    res.end("missing params");
+                    return;
+                }
+                if (!verifySignature(callbackToken, timestamp, nonce, echostr, msg_signature)) {
+                    res.writeHead(403);
+                    res.end("signature mismatch");
+                    return;
+                }
+                const { message } = decrypt(encodingAESKey, echostr);
+                res.writeHead(200, { "Content-Type": "text/plain" });
+                res.end(message);
+                return;
+            }
+            if (req.method === "POST") {
+                const { msg_signature, timestamp, nonce } = query;
+                const body = await readBody(req);
+                // Extract Encrypt from XML
+                const encryptedMsg = xmlTag(body, "Encrypt");
+                if (!encryptedMsg || !msg_signature || !timestamp || !nonce) {
+                    res.writeHead(400);
+                    res.end("bad request");
+                    return;
+                }
+                if (!verifySignature(callbackToken, timestamp, nonce, encryptedMsg, msg_signature)) {
+                    res.writeHead(403);
+                    res.end("signature mismatch");
+                    return;
+                }
+                const { message } = decrypt(encodingAESKey, encryptedMsg);
+                // Parse decrypted XML for Token and OpenKfId
+                const eventToken = xmlTag(message, "Token") ?? "";
+                const openKfId = xmlTag(message, "OpenKfId") ?? "";
+                // Respond immediately, process async
+                res.writeHead(200, { "Content-Type": "text/plain" });
+                res.end("success");
+                // Trigger message sync
+                Promise.resolve(onEvent(openKfId, eventToken)).catch((err) => {
+                    (log?.error ?? console.error)("[wechat-kf] onEvent error:", err);
+                });
+                return;
+            }
+            res.writeHead(405);
+            res.end("method not allowed");
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes("body too large")) {
+                res.writeHead(413);
+                res.end("payload too large");
+                return;
+            }
+            (log?.error ?? console.error)("[wechat-kf] webhook error:", err);
+            if (!res.headersSent) {
+                res.writeHead(500);
+                res.end("internal error");
+            }
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=webhook.js.map

package/dist/src/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/webhook.ts"],"names":[],"mappings":"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"}

package/dist/src/wechat-kf-directives.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WeChat KF directive parser
+ *
+ * Parses [[wechat_link: title | desc | url | thumbUrl]] directives
+ * embedded in agent text replies. The framework doesn't recognize these
+ * directives, so the text arrives intact for plugin-level interception.
+ *
+ * Syntax (pipe-separated fields):
+ *   [[wechat_link: title | url]]                      → 2 fields
+ *   [[wechat_link: title | desc | url]]               → 3 fields
+ *   [[wechat_link: title | desc | url | thumbUrl]]    → 4 fields
+ */
+export type WechatLinkDirective = {
+    title: string;
+    desc?: string;
+    url: string;
+    thumbUrl?: string;
+};
+export type WechatDirectiveResult = {
+    text: string;
+    link?: WechatLinkDirective;
+};
+/**
+ * Quick check whether text contains a `[[wechat_link:...]]` directive.
+ */
+export declare function hasWechatLinkDirective(text: string): boolean;
+/**
+ * Extract the first `[[wechat_link:...]]` directive from text.
+ *
+ * Returns the remaining text (with directive stripped and trimmed)
+ * plus the parsed link fields. If parsing fails (e.g. invalid URL),
+ * returns the original text unchanged with no link.
+ */
+export declare function parseWechatLinkDirective(text: string): WechatDirectiveResult;

package/dist/src/wechat-kf-directives.js

@@ -0,0 +1,65 @@
+/**
+ * WeChat KF directive parser
+ *
+ * Parses [[wechat_link: title | desc | url | thumbUrl]] directives
+ * embedded in agent text replies. The framework doesn't recognize these
+ * directives, so the text arrives intact for plugin-level interception.
+ *
+ * Syntax (pipe-separated fields):
+ *   [[wechat_link: title | url]]                      → 2 fields
+ *   [[wechat_link: title | desc | url]]               → 3 fields
+ *   [[wechat_link: title | desc | url | thumbUrl]]    → 4 fields
+ */
+const DIRECTIVE_RE = /\[\[wechat_link:\s*([^\]]+)\]\]/i;
+/**
+ * Quick check whether text contains a `[[wechat_link:...]]` directive.
+ */
+export function hasWechatLinkDirective(text) {
+    return DIRECTIVE_RE.test(text);
+}
+/**
+ * Extract the first `[[wechat_link:...]]` directive from text.
+ *
+ * Returns the remaining text (with directive stripped and trimmed)
+ * plus the parsed link fields. If parsing fails (e.g. invalid URL),
+ * returns the original text unchanged with no link.
+ */
+export function parseWechatLinkDirective(text) {
+    const match = DIRECTIVE_RE.exec(text);
+    if (!match) {
+        return { text };
+    }
+    const parts = match[1].split("|").map((s) => s.trim());
+    let link;
+    if (parts.length === 2) {
+        const [title, url] = parts;
+        if (isValidUrl(url)) {
+            link = { title, url };
+        }
+    }
+    else if (parts.length === 3) {
+        const [title, desc, url] = parts;
+        if (isValidUrl(url)) {
+            link = { title, desc, url };
+        }
+    }
+    else if (parts.length >= 4) {
+        const [title, desc, url, thumbUrl] = parts;
+        if (isValidUrl(url)) {
+            link = { title, desc, url, thumbUrl: thumbUrl || undefined };
+        }
+    }
+    if (!link) {
+        return { text };
+    }
+    // Strip the directive from text and clean up whitespace
+    const stripped = text
+        .replace(match[0], "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    return { text: stripped, link };
+}
+function isValidUrl(url) {
+    return url.startsWith("http://") || url.startsWith("https://");
+}
+//# sourceMappingURL=wechat-kf-directives.js.map

package/dist/src/wechat-kf-directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-kf-directives.js","sourceRoot":"","sources":["../../src/wechat-kf-directives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,IAAqC,CAAC;IAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACjC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;QAC3C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;IACV,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/index.ts

@@ -0,0 +1,32 @@
+/**
+ * WeChat KF (微信客服) OpenClaw Channel Plugin
+ */
+
+import { wechatKfPlugin } from "./src/channel.js";
+import { type PluginRuntime, setRuntime } from "./src/runtime.js";
+
+export { sendTextMessage, syncMessages } from "./src/api.js";
+export { wechatKfPlugin } from "./src/channel.js";
+export { computeSignature, decrypt, encrypt, verifySignature } from "./src/crypto.js";
+export { getAccessToken } from "./src/token.js";
+
+type OpenClawPluginApi = {
+  runtime: PluginRuntime;
+  registerChannel: (opts: { plugin: typeof wechatKfPlugin }) => void;
+};
+
+const plugin = {
+  id: "wechat-kf",
+  name: "WeChat KF",
+  description: "WeChat Customer Service (企业微信客服) channel plugin",
+  // Plugin-level config schema (not channel-level).
+  // Channel config is handled via openclaw.plugin.json configSchema
+  // and the runtime schema in channel.ts → configSchema.
+  configSchema: { type: "object", additionalProperties: false, properties: {} },
+  register(api: OpenClawPluginApi) {
+    setRuntime(api.runtime);
+    api.registerChannel({ plugin: wechatKfPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,31 @@
+{
+  "id": "wechat-kf",
+  "name": "WeChat Customer Service",
+  "description": "OpenClaw channel plugin for WeChat Customer Service (企业微信客服) via WeCom KF API",
+  "version": "0.1.0",
+  "channels": ["wechat-kf"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enabled": { "type": "boolean" },
+      "corpId": { "type": "string", "description": "WeCom Corp ID (企业ID)" },
+      "appSecret": { "type": "string", "description": "Self-built app secret (应用密钥)" },
+      "token": { "type": "string", "description": "Webhook callback token" },
+      "encodingAESKey": { "type": "string", "description": "43-character base64 AES key", "minLength": 43, "maxLength": 43 },
+      "webhookPort": { "type": "integer", "minimum": 1, "maximum": 65535, "default": 9999 },
+      "webhookPath": { "type": "string", "default": "/wechat-kf" },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist", "disabled"], "default": "open" },
+      "allowFrom": { "type": "array", "items": { "type": "string" } }
+    },
+    "uiHints": {
+      "corpId": { "label": "Corp ID", "placeholder": "ww0123456789abcdef" },
+      "appSecret": { "label": "App Secret", "placeholder": "Your WeCom app secret", "sensitive": true },
+      "token": { "label": "Callback Token", "placeholder": "Webhook verification token", "sensitive": true },
+      "encodingAESKey": { "label": "Encoding AES Key", "placeholder": "43-character base64 key", "sensitive": true },
+      "webhookPort": { "label": "Webhook Port", "placeholder": "9999" },
+      "webhookPath": { "label": "Webhook Path", "placeholder": "/wechat-kf" },
+      "dmPolicy": { "label": "DM Policy", "placeholder": "open" },
+      "allowFrom": { "label": "Allowlist", "placeholder": "List of allowed external user IDs" }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@pawastation/wechat-kf",
+  "version": "0.1.1",
+  "description": "OpenClaw channel plugin for WeChat Customer Service (企业微信客服) — enables AI-powered customer service bots via WeCom KF API",
+  "type": "module",
+  "license": "MIT",
+  "author": "pawaca",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pawastation/wechat-kf.git"
+  },
+  "homepage": "https://github.com/pawastation/wechat-kf#readme",
+  "bugs": {
+    "url": "https://github.com/pawastation/wechat-kf/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "wechat",
+    "wecom",
+    "customer-service",
+    "chatbot",
+    "ai-assistant"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./crypto": {
+      "types": "./dist/src/crypto.d.ts",
+      "import": "./dist/src/crypto.js"
+    },
+    "./api": {
+      "types": "./dist/src/api.d.ts",
+      "import": "./dist/src/api.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "index.ts",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.2",
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "wechat-kf",
+      "label": "WeChat KF",
+      "selectionLabel": "WeChat Customer Service (微信客服)",
+      "docsPath": "/channels/wechat-kf",
+      "docsLabel": "wechat-kf",
+      "blurb": "企业微信客服 API channel for WeChat users.",
+      "aliases": [
+        "wxkf"
+      ],
+      "order": 80
+    },
+    "install": {
+      "npmSpec": "@pawastation/wechat-kf",
+      "localPath": "extensions/wechat-kf",
+      "defaultChoice": "local"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src/ index.ts",
+    "lint:fix": "biome check --write src/ index.ts",
+    "format": "biome format --write src/ index.ts",
+    "check": "biome check src/ index.ts"
+  }
+}