@claw-lab/wxclawbot-cli 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lroolle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,161 @@
+# @claw-lab/wxclawbot-cli
+
+[简体中文](./README.md) | [npm](https://www.npmjs.com/package/@claw-lab/wxclawbot-cli) | [GitHub](https://github.com/lroolle/wxclawbot-cli) | [ClawHub](https://clawhub.ai/lroolle/wxclawbot-send)
+
+Let your AI agent proactively send WeChat messages. Text, images, video, files -- whatever you need.
+
+## Why This Exists
+
+WeChat bots can only reply. They can't initiate. That's like having a secretary who only talks when spoken to and otherwise sits there staring at the wall.
+
+> "Currently doesn't support proactively sending you messages on a schedule"
+>
+> -- [Lobster's WeChat Integration Tutorial](https://mp.weixin.qq.com/s/nYDQ1obQEHe1WavGpNzasQ)
+
+**Now it does.**
+
+## Install
+
+Send this to your OpenClaw agent (Lobster). That's the whole install process:
+
+```
+Install a skill so you can proactively WeChat me: npm install -g @claw-lab/wxclawbot-cli
+
+npm: https://www.npmjs.com/package/@claw-lab/wxclawbot-cli
+Source: https://github.com/lroolle/wxclawbot-cli
+
+Let me know when it's done.
+```
+
+Copy. Paste. Send. The agent handles installation, config, scheduling -- all of it.
+
+You don't touch the CLI. You don't write cron jobs. You don't need the technical docs below.
+
+## What You Can Do With It
+
+You're not "running commands." You're talking to your agent. These are prompts you send directly:
+
+**Stay-alive reminders:**
+
+> Remind me to drink water every 45 minutes, don't be polite about it
+
+> Every hour of sitting, tell me to get up and move. Be aggressive.
+
+> If I'm still chatting with you after 1 AM, yell at me to go to sleep
+
+> Friday 5:55 PM -- remind me to stop working. Do not accept new tasks.
+
+> Weekdays 11:15 -- remind me to order lunch before delivery queues explode
+
+**DevOps alerts:**
+
+> If CI breaks, WeChat me immediately with whose commit blew it up
+
+> PR sitting unreviewed for 24 hours? Ping me.
+
+> Notify me on every deploy -- success or failure, I want to know
+
+> Production error rate over 1%? Alert me via WeChat, right now
+
+**Business ops:**
+
+> Every morning at 9, send me yesterday's key metrics summary
+
+> Ticket exceeds SLA by 4 hours -- auto-escalate and notify me
+
+> Suspicious login detected? Alert me immediately
+
+> Server disk over 90%? WeChat me
+
+You talk. The agent works. That's the whole idea.
+
+---
+
+Everything below is technical reference for agents, scripts, and developers. Normal humans can stop here.
+
+## CLI Reference
+
+```bash
+wxclawbot send --text "message" --json
+wxclawbot send --file ./photo.jpg --json
+wxclawbot send --file ./report.pdf --text "See attached" --json
+wxclawbot send --to "user@im.wechat" --text "Hello" --json
+echo "report ready" | wxclawbot send --json
+wxclawbot send --text "test" --dry-run
+```
+
+| Flag | Description |
+|------|-------------|
+| `--text <msg>` | Message text. `"-"` to explicitly read stdin |
+| `--file <path>` | Local file path or URL (image/video/file) |
+| `--to <userId>` | Target user ID. Default: bound user from account |
+| `--account <id>` | Account ID. Default: first available |
+| `--json` | JSON output. **Always use this.** |
+| `--dry-run` | Preview without sending |
+
+Media type auto-detected by extension:
+
+- Image: .png .jpg .jpeg .gif .webp .bmp
+- Video: .mp4 .mov .webm .mkv .avi
+- File: everything else
+
+## Output Format
+
+```json
+{"ok":true,"to":"user@im.wechat","clientId":"..."}
+{"ok":false,"error":"ret=-2 (rate limited, try again later)"}
+```
+
+Exit codes: 0 = CLI ran, 1 = failure. Note: exit 0 means the CLI executed, not that the message was delivered. Check the `ok` field.
+
+## Error Codes
+
+| ret | meaning | action |
+|-----|---------|--------|
+| -2 | rate limited | wait 5-10s, retry. Don't tight-loop this. |
+| -14 | session expired | re-login via openclaw |
+
+Rate limit: **~7 msgs / 5 min** per bot account, server-side, shared across all clients on the same token.
+
+## Accounts
+
+```bash
+wxclawbot accounts --json
+```
+
+Auto-discovers from `~/.openclaw/openclaw-weixin/accounts/`. Env override:
+
+```bash
+export WXCLAW_TOKEN="bot@im.bot:your-token"
+export WXCLAW_BASE_URL="https://ilinkai.weixin.qq.com"
+```
+
+## Programmatic API
+
+```typescript
+import { WxClawClient } from "@claw-lab/wxclawbot-cli";
+import { resolveAccount } from "@claw-lab/wxclawbot-cli/accounts";
+
+const account = resolveAccount();
+const client = new WxClawClient({
+  baseUrl: account.baseUrl,
+  token: account.token,
+  botId: account.botId,
+});
+
+await client.sendText("user@im.wechat", "Hello");
+await client.sendFile("user@im.wechat", "./photo.jpg", { text: "Check this" });
+```
+
+See [references/programmatic-api.md](references/programmatic-api.md) for full details.
+
+## Links
+
+- [npm](https://www.npmjs.com/package/@claw-lab/wxclawbot-cli)
+- [GitHub](https://github.com/lroolle/wxclawbot-cli)
+- [ClawHub](https://clawhub.ai/lroolle/wxclawbot-send) -- `clawhub install wxclawbot-send`
+- [WeChat Integration Tutorial](https://mp.weixin.qq.com/s/nYDQ1obQEHe1WavGpNzasQ) -- start here for the basics
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,160 @@
+# @claw-lab/wxclawbot-cli
+
+[English](./README.en.md) | [npm](https://www.npmjs.com/package/@claw-lab/wxclawbot-cli) | [GitHub](https://github.com/lroolle/wxclawbot-cli) | [ClawHub](https://clawhub.ai/lroolle/wxclawbot-send)
+
+让你的 AI agent 主动给微信用户发消息。文本、图片、视频、文件，想发就发。
+
+## 为什么做这个
+
+> 7）现在还不支持主动定时给你发消息
+> 也就是说，它不会像小秘书一样，自己跳出来提醒你。
+>
+> -- [龙虾接入微信教程](https://mp.weixin.qq.com/s/nYDQ1obQEHe1WavGpNzasQ)
+
+**现在可以了。**
+
+## 安装
+
+把下面这段直接发给你的龙虾就行：
+
+```
+装个技能让你能主动给我发微信，先装 CLI：npm install -g @claw-lab/wxclawbot-cli
+
+npm 包：https://www.npmjs.com/package/@claw-lab/wxclawbot-cli
+源码：https://github.com/lroolle/wxclawbot-cli
+
+装好了告诉我。
+```
+
+没了。复制，粘贴，发送。agent 自己搞定安装、配置、定时任务。
+
+你不需要碰命令行。你不需要写 cron。你不需要看下面的技术文档。
+
+## 使用场景
+
+你不是在"用 CLI"，你是在跟 agent 说话。以下是你可以直接发给龙虾的提示词：
+
+**活着提醒系列：**
+
+> 每 45 分钟提醒我喝水，别客气直接骂
+
+> 每坐满 1 小时提醒我站起来，语气凶一点
+
+> 凌晨 1 点还在跟你聊天直接骂我去睡觉
+
+> 周五 5:55 提醒我下班，不要接新需求
+
+> 工作日 11:15 提醒我点外卖，不然配送排到下午两点
+
+**搬砖告警系列：**
+
+> CI 挂了第一时间微信通知我，告诉我是谁的 commit 炸的
+
+> 有 PR 超过 24 小时没人 review 就催我
+
+> 每次部署完成通知我，成功失败都要说
+
+> 生产环境错误率超过 1% 立刻告警
+
+**老板视角系列：**
+
+> 每天早上 9 点把昨天的核心指标发给我
+
+> 工单超 SLA 4 小时自动升级通知我
+
+> 检测到异常登录立刻告警
+
+> 服务器磁盘超 90% 微信通知我
+
+你说人话，agent 干活。就这么简单。
+
+---
+
+以下是给 agent、脚本和开发者看的技术文档。普通用户到这里就可以关掉了。
+
+## CLI 参考
+
+```bash
+wxclawbot send --text "消息内容" --json
+wxclawbot send --file ./photo.jpg --json
+wxclawbot send --file ./report.pdf --text "请查收" --json
+wxclawbot send --to "user@im.wechat" --text "你好" --json
+echo "日报已生成" | wxclawbot send --json
+wxclawbot send --text "test" --dry-run
+```
+
+| 参数 | 说明 |
+|------|------|
+| `--text <msg>` | 消息文本。`"-"` 显式读 stdin |
+| `--file <path>` | 本地文件或 URL（图片 / 视频 / 文件） |
+| `--to <userId>` | 目标用户 ID。默认：账号绑定用户 |
+| `--account <id>` | 指定账号。默认：第一个可用的 |
+| `--json` | JSON 格式输出。**始终带上** |
+| `--dry-run` | 预览，不发送 |
+
+媒体类型按扩展名自动识别：
+
+- 图片：.png .jpg .jpeg .gif .webp .bmp
+- 视频：.mp4 .mov .webm .mkv .avi
+- 文件：其他所有
+
+## 输出格式
+
+```json
+{"ok":true,"to":"user@im.wechat","clientId":"..."}
+{"ok":false,"error":"ret=-2 (rate limited, try again later)"}
+```
+
+退出码：0 = CLI 执行成功，1 = 失败。注意：exit 0 只代表 CLI 跑完了，不代表消息送达。看 `ok` 字段。
+
+## 错误码
+
+| ret | 含义 | 处理 |
+|-----|------|------|
+| -2 | 频率限制 | 等 5-10 秒重试，别搞紧循环 |
+| -14 | 会话过期 | 通过 openclaw 重新登录 |
+
+频率限制：每个机器人账号约 **7 条 / 5 分钟**，服务端限制，所有客户端共享。
+
+## 账号
+
+```bash
+wxclawbot accounts --json
+```
+
+自动从 `~/.openclaw/openclaw-weixin/accounts/` 发现。环境变量覆盖：
+
+```bash
+export WXCLAW_TOKEN="bot@im.bot:your-token"
+export WXCLAW_BASE_URL="https://ilinkai.weixin.qq.com"
+```
+
+## 编程接口
+
+```typescript
+import { WxClawClient } from "@claw-lab/wxclawbot-cli";
+import { resolveAccount } from "@claw-lab/wxclawbot-cli/accounts";
+
+const account = resolveAccount();
+const client = new WxClawClient({
+  baseUrl: account.baseUrl,
+  token: account.token,
+  botId: account.botId,
+});
+
+await client.sendText("user@im.wechat", "你好");
+await client.sendFile("user@im.wechat", "./photo.jpg", { text: "请查收" });
+```
+
+详见 [references/programmatic-api.md](references/programmatic-api.md)。
+
+## 相关链接
+
+- [npm](https://www.npmjs.com/package/@claw-lab/wxclawbot-cli)
+- [GitHub](https://github.com/lroolle/wxclawbot-cli)
+- [ClawHub](https://clawhub.ai/lroolle/wxclawbot-send) -- `clawhub install wxclawbot-send`
+- [龙虾接入微信教程](https://mp.weixin.qq.com/s/nYDQ1obQEHe1WavGpNzasQ) -- 先看这个搞定基础接入
+
+## 开源许可
+
+MIT

package/dist/accounts.d.ts

@@ -0,0 +1,9 @@
+import type { AccountData, ResolvedAccount } from "./types.js";
+export declare function listAccountIds(): string[];
+export declare function loadAccountData(accountId: string): AccountData | null;
+export declare function resolveAccount(accountId?: string): ResolvedAccount | null;
+export declare function listAccounts(): Array<{
+    id: string;
+    configured: boolean;
+    baseUrl: string;
+}>;

package/dist/accounts.js

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+function extractBotId(token) {
+    const colonIdx = token.indexOf(":");
+    return colonIdx > 0 ? token.substring(0, colonIdx) : "";
+}
+function stateDir() {
+    return (process.env.OPENCLAW_STATE_DIR?.trim() ||
+        process.env.CLAWDBOT_STATE_DIR?.trim() ||
+        path.join(os.homedir(), ".openclaw"));
+}
+function weixinStateDir() {
+    return path.join(stateDir(), "openclaw-weixin");
+}
+function accountsDir() {
+    return path.join(weixinStateDir(), "accounts");
+}
+function indexPath() {
+    return path.join(weixinStateDir(), "accounts.json");
+}
+export function listAccountIds() {
+    try {
+        const raw = fs.readFileSync(indexPath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            const ids = parsed.filter((id) => typeof id === "string" && id !== "");
+            if (ids.length > 0)
+                return ids;
+        }
+    }
+    catch {
+        // fall through to directory scan
+    }
+    return scanAccountsDir();
+}
+function scanAccountsDir() {
+    try {
+        const dir = accountsDir();
+        return fs
+            .readdirSync(dir)
+            .filter((f) => f.endsWith(".json") && !f.endsWith(".sync.json"))
+            .map((f) => f.replace(/\.json$/, ""));
+    }
+    catch {
+        return [];
+    }
+}
+export function loadAccountData(accountId) {
+    if (accountId.includes("/") ||
+        accountId.includes("\\") ||
+        accountId.includes("..")) {
+        return null;
+    }
+    const filePath = path.join(accountsDir(), `${accountId}.json`);
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function resolveBotId(data) {
+    return data.userId?.trim() || extractBotId(data.token ?? "");
+}
+export function resolveAccount(accountId) {
+    const envToken = process.env.WXCLAW_TOKEN?.trim();
+    const envBaseUrl = process.env.WXCLAW_BASE_URL?.trim();
+    if (envToken && !accountId) {
+        return {
+            id: "env",
+            token: envToken,
+            baseUrl: envBaseUrl || DEFAULT_BASE_URL,
+            botId: extractBotId(envToken),
+        };
+    }
+    const ids = listAccountIds();
+    const targetId = accountId || ids[0];
+    if (!targetId)
+        return null;
+    const data = loadAccountData(targetId);
+    if (!data?.token)
+        return null;
+    return {
+        id: targetId,
+        token: data.token,
+        baseUrl: data.baseUrl?.trim() || DEFAULT_BASE_URL,
+        botId: resolveBotId(data),
+        defaultTo: data.userId?.trim() || undefined,
+    };
+}
+export function listAccounts() {
+    const ids = listAccountIds();
+    return ids.map((id) => {
+        const data = loadAccountData(id);
+        return {
+            id,
+            configured: Boolean(data?.token),
+            baseUrl: data?.baseUrl?.trim() || DEFAULT_BASE_URL,
+        };
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/dist/accounts.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { Command } from "commander";
+import { listAccounts, resolveAccount } from "./accounts.js";
+import { WxClawClient } from "./client.js";
+import { VERSION } from "./version.js";
+function readStdin() {
+    return readFileSync(0, "utf-8").trim();
+}
+function fail(msg, json) {
+    if (json) {
+        console.log(JSON.stringify({ ok: false, error: msg }));
+    }
+    else {
+        console.error(msg);
+    }
+    process.exit(1);
+}
+const program = new Command();
+program
+    .name("wxclawbot")
+    .description("WeixinClawBot CLI - proactive messaging")
+    .version(VERSION);
+program
+    .command("send")
+    .description("Send a message to a WeChat user")
+    .option("--to <userId>", "target user ID (default: bound user from account)")
+    .option("--text <message>", 'message text (use "-" to read from stdin)')
+    .option("--file <path>", "file or URL to send (image/video/file)")
+    .option("--account <id>", "account ID (default: first available)")
+    .option("--json", "output result as JSON")
+    .option("--dry-run", "preview without sending")
+    .argument("[text...]", "message text (alternative to --text)")
+    .action(async (args, opts) => {
+    let text = opts.text;
+    if (text === "-") {
+        text = readStdin();
+    }
+    else if (!text && !opts.file && args.length > 0) {
+        text = args.join(" ");
+    }
+    else if (!text && !opts.file) {
+        if (!process.stdin.isTTY) {
+            text = readStdin();
+        }
+    }
+    if (!text && !opts.file) {
+        fail("no message. use --text, --file, positional args, or pipe via stdin.", opts.json);
+    }
+    const account = resolveAccount(opts.account);
+    if (!account) {
+        fail("no account found. login via openclaw first, or set WXCLAW_TOKEN env var.", opts.json);
+    }
+    const to = opts.to || account.defaultTo;
+    if (!to) {
+        fail("no --to specified and no default user bound to this account.", opts.json);
+    }
+    const client = new WxClawClient({
+        baseUrl: account.baseUrl,
+        token: account.token,
+        botId: account.botId,
+    });
+    try {
+        let result;
+        if (opts.file) {
+            result = await client.sendFile(to, opts.file, {
+                text,
+                dryRun: opts.dryRun,
+            });
+        }
+        else {
+            result = await client.sendText(to, text, {
+                dryRun: opts.dryRun,
+            });
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(result));
+        }
+        else if (result.ok) {
+            const prefix = opts.dryRun ? "[dry-run] would send" : "sent";
+            const what = opts.file ? `file ${opts.file}` : "text";
+            console.log(`${prefix} ${what} to ${to}`);
+        }
+        else {
+            console.error(`send failed: ${result.error}`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fail(`send failed: ${msg}`, opts.json);
+    }
+});
+program
+    .command("accounts")
+    .description("List available OpenClaw WeChat accounts")
+    .option("--json", "output as JSON")
+    .action((opts) => {
+    const accounts = listAccounts();
+    if (opts.json) {
+        console.log(JSON.stringify(accounts));
+        return;
+    }
+    if (accounts.length === 0) {
+        console.log("no accounts found. login via openclaw first.");
+        return;
+    }
+    for (const a of accounts) {
+        const status = a.configured ? "ok" : "no token";
+        console.log(`  ${a.id}  [${status}]  ${a.baseUrl}`);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export interface SendResult {
+    ok: boolean;
+    to: string;
+    clientId: string;
+    error?: string;
+}
+export declare class WxClawClient {
+    private baseUrl;
+    private token;
+    private botId;
+    constructor(opts: {
+        baseUrl: string;
+        token: string;
+        botId?: string;
+    });
+    sendText(to: string, text: string, opts?: {
+        dryRun?: boolean;
+    }): Promise<SendResult>;
+    sendFile(to: string, filePath: string, opts?: {
+        text?: string;
+        dryRun?: boolean;
+    }): Promise<SendResult>;
+    private sendItems;
+    private post;
+}

package/dist/client.js

@@ -0,0 +1,114 @@
+import crypto from "node:crypto";
+import { readFileOrUrl, uploadFile } from "./media.js";
+import { ItemType, MessageState, MessageType, } from "./types.js";
+import { VERSION } from "./version.js";
+const SEND_TIMEOUT_MS = 15_000;
+const KNOWN_ERRORS = {
+    [-2]: "rate limited, try again later",
+    [-14]: "session expired, re-login via openclaw",
+};
+function randomUIN() {
+    const n = crypto.randomBytes(4).readUInt32BE(0);
+    return Buffer.from(String(n), "utf-8").toString("base64");
+}
+export class WxClawClient {
+    baseUrl;
+    token;
+    botId;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this.token = opts.token;
+        this.botId = opts.botId ?? "";
+    }
+    async sendText(to, text, opts) {
+        const clientId = crypto.randomUUID();
+        if (opts?.dryRun) {
+            return { ok: true, to, clientId };
+        }
+        const items = [
+            { type: ItemType.TEXT, text_item: { text } },
+        ];
+        return this.sendItems(to, items, clientId);
+    }
+    async sendFile(to, filePath, opts) {
+        const clientId = crypto.randomUUID();
+        if (opts?.dryRun) {
+            return { ok: true, to, clientId };
+        }
+        const { data, name } = await readFileOrUrl(filePath);
+        const { item } = await uploadFile({
+            data,
+            filePath: name,
+            toUserId: to,
+            baseUrl: this.baseUrl,
+            token: this.token,
+        });
+        const items = [];
+        if (opts?.text) {
+            items.push({ type: ItemType.TEXT, text_item: { text: opts.text } });
+        }
+        items.push(item);
+        return this.sendItems(to, items, clientId);
+    }
+    async sendItems(to, items, clientId) {
+        const req = {
+            msg: {
+                from_user_id: this.botId,
+                to_user_id: to,
+                client_id: clientId,
+                message_type: MessageType.BOT,
+                message_state: MessageState.FINISH,
+                item_list: items,
+            },
+            base_info: { channel_version: VERSION },
+        };
+        const resp = await this.post("/ilink/bot/sendmessage", req);
+        const ret = typeof resp.ret === "number" ? resp.ret : 0;
+        if (ret !== 0) {
+            const hint = KNOWN_ERRORS[ret] ?? "";
+            const detail = hint ? ` (${hint})` : "";
+            return { ok: false, to, clientId, error: `ret=${ret}${detail}` };
+        }
+        return { ok: true, to, clientId };
+    }
+    async post(endpoint, body) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const bodyStr = JSON.stringify(body);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), SEND_TIMEOUT_MS);
+        try {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    AuthorizationType: "ilink_bot_token",
+                    Authorization: `Bearer ${this.token}`,
+                    "X-WECHAT-UIN": randomUIN(),
+                },
+                body: bodyStr,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            const raw = await res.text();
+            if (!res.ok) {
+                const truncated = raw.length > 200 ? raw.slice(0, 200) + "..." : raw;
+                throw new Error(`HTTP ${res.status}: ${truncated}`);
+            }
+            try {
+                return JSON.parse(raw);
+            }
+            catch {
+                const truncated = raw.length > 200 ? raw.slice(0, 200) + "..." : raw;
+                throw new Error(`invalid JSON response (HTTP ${res.status}): ${truncated}`);
+            }
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new Error(`request timeout after ${SEND_TIMEOUT_MS}ms`);
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/media.d.ts

@@ -0,0 +1,21 @@
+import { type MessageItem } from "./types.js";
+export declare function aesEcbPaddedSize(plaintextSize: number): number;
+export declare function encryptAesEcb(plaintext: Buffer, key: Buffer): Buffer;
+export declare function classifyMedia(filePath: string): {
+    cdnType: number;
+    itemType: number;
+};
+export declare function uploadFile(opts: {
+    data: Buffer;
+    filePath: string;
+    toUserId: string;
+    baseUrl: string;
+    token: string;
+    cdnBaseUrl?: string;
+}): Promise<{
+    item: MessageItem;
+}>;
+export declare function readFileOrUrl(filePath: string): Promise<{
+    data: Buffer;
+    name: string;
+}>;

package/dist/media.js

@@ -0,0 +1,195 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { CDNMediaType, ItemType, } from "./types.js";
+import { VERSION } from "./version.js";
+const CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+const API_TIMEOUT_MS = 15_000;
+const CDN_UPLOAD_TIMEOUT_MS = 60_000;
+const CDN_MAX_RETRIES = 3;
+const MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
+const IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp"]);
+const VIDEO_EXTS = new Set([".mp4", ".mov", ".webm", ".mkv", ".avi"]);
+// PKCS7 padded ciphertext size for AES-128-ECB (16-byte blocks).
+// Matches openclaw-weixin's formula. Note: weclaw Go uses a slightly
+// different formula that over-reports by 16 bytes at block boundaries,
+// but the server accepts both.
+export function aesEcbPaddedSize(plaintextSize) {
+    return Math.ceil((plaintextSize + 1) / 16) * 16;
+}
+export function encryptAesEcb(plaintext, key) {
+    const cipher = crypto.createCipheriv("aes-128-ecb", key, null);
+    return Buffer.concat([cipher.update(plaintext), cipher.final()]);
+}
+export function classifyMedia(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (IMAGE_EXTS.has(ext)) {
+        return { cdnType: CDNMediaType.IMAGE, itemType: ItemType.IMAGE };
+    }
+    if (VIDEO_EXTS.has(ext)) {
+        return { cdnType: CDNMediaType.VIDEO, itemType: ItemType.VIDEO };
+    }
+    return { cdnType: CDNMediaType.FILE, itemType: ItemType.FILE };
+}
+function filenameFromPath(filePath) {
+    return path.basename(filePath) || "file";
+}
+export async function uploadFile(opts) {
+    const { data, filePath, toUserId, baseUrl, token } = opts;
+    const cdnBaseUrl = opts.cdnBaseUrl || CDN_BASE_URL;
+    const { cdnType, itemType } = classifyMedia(filePath);
+    const uploaded = await uploadToCdn({
+        data,
+        toUserId,
+        cdnMediaType: cdnType,
+        baseUrl,
+        token,
+        cdnBaseUrl,
+    });
+    const media = {
+        encrypt_query_param: uploaded.downloadParam,
+        aes_key: Buffer.from(uploaded.aesKeyHex).toString("base64"),
+        encrypt_type: 1,
+    };
+    let item;
+    switch (itemType) {
+        case ItemType.IMAGE:
+            item = {
+                type: ItemType.IMAGE,
+                image_item: { media, mid_size: uploaded.cipherSize },
+            };
+            break;
+        case ItemType.VIDEO:
+            item = {
+                type: ItemType.VIDEO,
+                video_item: { media, video_size: uploaded.cipherSize },
+            };
+            break;
+        default:
+            item = {
+                type: ItemType.FILE,
+                file_item: {
+                    media,
+                    file_name: filenameFromPath(filePath),
+                    len: String(uploaded.fileSize),
+                },
+            };
+    }
+    return { item };
+}
+async function fetchWithTimeout(url, init, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { ...init, signal: controller.signal });
+        return res;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function uploadToCdn(opts) {
+    const { data, toUserId, cdnMediaType, baseUrl, token, cdnBaseUrl } = opts;
+    const filekey = crypto.randomBytes(16).toString("hex");
+    const aeskey = crypto.randomBytes(16);
+    const aesKeyHex = aeskey.toString("hex");
+    const rawMd5 = crypto.createHash("md5").update(data).digest("hex");
+    const cipherSize = aesEcbPaddedSize(data.length);
+    const body = {
+        filekey,
+        media_type: cdnMediaType,
+        to_user_id: toUserId,
+        rawsize: data.length,
+        rawfilemd5: rawMd5,
+        filesize: cipherSize,
+        no_need_thumb: true,
+        aeskey: aesKeyHex,
+        base_info: { channel_version: VERSION },
+    };
+    const uin = crypto.randomBytes(4).readUInt32BE(0);
+    const uinHeader = Buffer.from(String(uin), "utf-8").toString("base64");
+    const uploadRes = await fetchWithTimeout(`${baseUrl}/ilink/bot/getuploadurl`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            AuthorizationType: "ilink_bot_token",
+            Authorization: `Bearer ${token}`,
+            "X-WECHAT-UIN": uinHeader,
+        },
+        body: JSON.stringify(body),
+    }, API_TIMEOUT_MS);
+    const uploadRespRaw = await uploadRes.text();
+    if (!uploadRes.ok) {
+        throw new Error(`getuploadurl HTTP ${uploadRes.status}: ${uploadRespRaw.slice(0, 200)}`);
+    }
+    let uploadResp;
+    try {
+        uploadResp = JSON.parse(uploadRespRaw);
+    }
+    catch {
+        throw new Error(`getuploadurl invalid JSON: ${uploadRespRaw.slice(0, 200)}`);
+    }
+    if ((uploadResp.ret ?? 0) !== 0 || !uploadResp.upload_param) {
+        throw new Error(`getuploadurl failed: ret=${uploadResp.ret} errmsg=${uploadResp.errmsg ?? "no upload_param"}`);
+    }
+    const ciphertext = encryptAesEcb(data, aeskey);
+    const cdnUrl = `${cdnBaseUrl}/upload?encrypted_query_param=${encodeURIComponent(uploadResp.upload_param)}&filekey=${encodeURIComponent(filekey)}`;
+    let downloadParam;
+    let lastError;
+    for (let attempt = 1; attempt <= CDN_MAX_RETRIES; attempt++) {
+        try {
+            const cdnRes = await fetchWithTimeout(cdnUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/octet-stream" },
+                body: new Uint8Array(ciphertext),
+            }, CDN_UPLOAD_TIMEOUT_MS);
+            if (cdnRes.status >= 400 && cdnRes.status < 500) {
+                throw new Error(`CDN upload client error ${cdnRes.status}`);
+            }
+            if (cdnRes.status !== 200) {
+                throw new Error(`CDN upload server error ${cdnRes.status}`);
+            }
+            downloadParam = cdnRes.headers.get("x-encrypted-param") ?? undefined;
+            if (!downloadParam) {
+                throw new Error("CDN response missing x-encrypted-param header");
+            }
+            break;
+        }
+        catch (err) {
+            lastError = err;
+            if (err instanceof Error && err.message.includes("client error"))
+                throw err;
+            if (attempt >= CDN_MAX_RETRIES)
+                throw err;
+            await new Promise((r) => setTimeout(r, 1000 * attempt));
+        }
+    }
+    if (!downloadParam) {
+        throw lastError instanceof Error
+            ? lastError
+            : new Error(`CDN upload failed after ${CDN_MAX_RETRIES} attempts`);
+    }
+    return { downloadParam, aesKeyHex, fileSize: data.length, cipherSize };
+}
+export async function readFileOrUrl(filePath) {
+    if (filePath.startsWith("http://") || filePath.startsWith("https://")) {
+        const res = await fetchWithTimeout(filePath, {}, CDN_UPLOAD_TIMEOUT_MS);
+        if (!res.ok) {
+            throw new Error(`download ${filePath}: HTTP ${res.status}`);
+        }
+        const buf = Buffer.from(await res.arrayBuffer());
+        if (buf.length > MAX_FILE_SIZE) {
+            throw new Error(`file too large: ${buf.length} bytes (max ${MAX_FILE_SIZE / 1024 / 1024}MB)`);
+        }
+        const urlPath = new URL(filePath).pathname;
+        const name = path.basename(urlPath) || "file";
+        return { data: buf, name };
+    }
+    const stat = fs.statSync(filePath);
+    if (stat.size > MAX_FILE_SIZE) {
+        throw new Error(`file too large: ${stat.size} bytes (max ${MAX_FILE_SIZE / 1024 / 1024}MB)`);
+    }
+    const data = fs.readFileSync(filePath);
+    return { data, name: filePath };
+}
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+export declare const MessageType: {
+    readonly USER: 1;
+    readonly BOT: 2;
+};
+export declare const MessageState: {
+    readonly NEW: 0;
+    readonly GENERATING: 1;
+    readonly FINISH: 2;
+};
+export declare const ItemType: {
+    readonly TEXT: 1;
+    readonly IMAGE: 2;
+    readonly VOICE: 3;
+    readonly FILE: 4;
+    readonly VIDEO: 5;
+};
+export declare const CDNMediaType: {
+    readonly IMAGE: 1;
+    readonly VIDEO: 2;
+    readonly FILE: 3;
+};
+type ValueOf<T> = T[keyof T];
+export interface TextItem {
+    text: string;
+}
+export interface MediaInfo {
+    encrypt_query_param: string;
+    aes_key: string;
+    encrypt_type: number;
+}
+export interface ImageItem {
+    media: MediaInfo;
+    mid_size: number;
+}
+export interface VideoItem {
+    media: MediaInfo;
+    video_size: number;
+}
+export interface FileItem {
+    media: MediaInfo;
+    file_name: string;
+    len: string;
+}
+export interface MessageItem {
+    type: ValueOf<typeof ItemType>;
+    text_item?: TextItem;
+    image_item?: ImageItem;
+    video_item?: VideoItem;
+    file_item?: FileItem;
+}
+export interface SendMsg {
+    from_user_id: string;
+    to_user_id: string;
+    client_id: string;
+    message_type: ValueOf<typeof MessageType>;
+    message_state: ValueOf<typeof MessageState>;
+    item_list: MessageItem[];
+    context_token?: string;
+}
+export interface SendMessageReq {
+    msg: SendMsg;
+    base_info?: {
+        channel_version?: string;
+    };
+}
+export interface GetUploadUrlReq {
+    filekey: string;
+    media_type: ValueOf<typeof CDNMediaType>;
+    to_user_id: string;
+    rawsize: number;
+    rawfilemd5: string;
+    filesize: number;
+    no_need_thumb: boolean;
+    aeskey: string;
+    base_info?: {
+        channel_version?: string;
+    };
+}
+export interface GetUploadUrlResp {
+    ret?: number;
+    errmsg?: string;
+    upload_param?: string;
+}
+export interface AccountData {
+    token?: string;
+    savedAt?: string;
+    baseUrl?: string;
+    userId?: string;
+}
+export interface ResolvedAccount {
+    id: string;
+    token: string;
+    baseUrl: string;
+    botId: string;
+    defaultTo?: string;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,22 @@
+export const MessageType = {
+    USER: 1,
+    BOT: 2,
+};
+export const MessageState = {
+    NEW: 0,
+    GENERATING: 1,
+    FINISH: 2,
+};
+export const ItemType = {
+    TEXT: 1,
+    IMAGE: 2,
+    VOICE: 3,
+    FILE: 4,
+    VIDEO: 5,
+};
+export const CDNMediaType = {
+    IMAGE: 1,
+    VIDEO: 2,
+    FILE: 3,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,CAAC;IACN,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@claw-lab/wxclawbot-cli",
+  "version": "0.4.0",
+  "description": "WeixinClawBot CLI - send text, images, video, and files to WeChat users",
+  "type": "module",
+  "bin": {
+    "wxclawbot": "dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/client.js",
+    "./accounts": "./dist/accounts.js",
+    "./media": "./dist/media.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "node --import tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "node --import tsx --test src/accounts.test.ts src/media.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lroolle/wxclawbot-cli.git"
+  },
+  "keywords": [
+    "wechat",
+    "weixin",
+    "openclaw",
+    "clawbot",
+    "weixinclawbot",
+    "cli",
+    "proactive-messaging"
+  ],
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "license": "MIT"
+}