openclaw-github-trending 1.4.1 → 1.4.3

package/README.md

@@ -375,15 +375,29 @@ The plugin supports OpenAI-compatible API providers. If not configured in the pl
 
 | Field | Type | Required | Default | Description |
 |-------|------|----------|---------|-------------|
-| `enabled` | boolean | No | `false` | Enable WeChat notifications via @tencent-weixin/openclaw-weixin plugin |
-| `receiver_id` | string | No | - | WeChat receiver ID (format: `xxx@im.wechat`) |
+| `enabled` | boolean | No | `true` | Enable WeChat notifications via @tencent-weixin/openclaw-weixin plugin |
+| `receiver_id` | string | No | Auto-detect | WeChat receiver ID (format: `xxx@im.wechat`) |
 | `bot_account_id` | string | No | - | WeChat bot account ID (format: `xxx-im-bot`) |
 
+**receiver_id Auto-Detection:**
+
+The plugin will automatically detect `receiver_id` using the following priority (no manual configuration needed in most cases):
+
+1. **Plugin Config**: `plugins.openclaw-github-trending.config.channels.wechat.receiver_id`
+2. **Environment Variable**: `OPENCLAW_WECHAT_RECEIVER_ID`
+3. **Message Context**: If current session is from WeChat, auto-reply to sender
+4. **Session History**: Extract from `~/.openclaw/agents/main/sessions/sessions.json`
+5. **OpenClaw Config**: Search WeChat plugin configuration and sessions
+
+**⚠️ Important:**
+- WeChat ID is **case-sensitive**, e.g., `o9cq806Il_QmHA022BUNXe0hUv4I@im.wechat`
+- If auto-detection fails, detailed configuration guide will be shown
+
 **WeChat Requirements:**
 
 1. **Install WeChat Plugin**:
    ```bash
-   npm install @tencent-weixin/openclaw-weixin
+   openclaw plugins install @tencent-weixin/openclaw-weixin
    ```
 
 2. **Configure in OpenClaw** (`~/.openclaw/openclaw.json`):
@@ -391,20 +405,25 @@ The plugin supports OpenAI-compatible API providers. If not configured in the pl
    {
      "plugins": {
        "entries": {
-         "@tencent-weixin/openclaw-weixin": {
-           "enabled": true,
-           "config": {
-             "enable_login": true
-           }
-         },
+         "openclaw-weixin": {
+           "enabled": true
+         }
+       }
+     }
+   }
+   ```
+
+3. **Optional: Configure receiver_id** (only if you need to push to a specific user):
+   ```json
+   {
+     "plugins": {
+       "entries": {
          "openclaw-github-trending": {
-           "enabled": true,
            "config": {
              "channels": {
                "wechat": {
                  "enabled": true,
-                 "receiver_id": "xxx@im.wechat",
-                 "bot_account_id": "xxx-im-bot"
+                 "receiver_id": "o9cq806Il_QmHA022BUNXe0hUv4I@im.wechat"
                }
              }
            }
@@ -414,38 +433,24 @@ The plugin supports OpenAI-compatible API providers. If not configured in the pl
    }
    ```
 
-3. **Configuration Options (choose one)**:
-   - **Config File (Recommended)**: Set `receiver_id` and `bot_account_id` in the `wechat` section of `openclaw.json`
-   - **Environment Variables**: Set `OPENCLAW_WECHAT_RECEIVER_ID` and `OPENCLAW_WECHAT_BOT_ACCOUNT_ID`
-   - **Default Values**: Use built-in default configuration (for testing only)
+   **💡 Tip**: If `receiver_id` is not configured, the plugin will auto-detect it from session history.
 
-4. **Login to WeChat**:
-   - OpenClaw will prompt you to scan QR code with your personal WeChat
-   - After login, messages will be sent to the configured WeChat account
+**🔍 How to Get Your WeChat ID:**
 
-5. **Usage**:
-   **⚠️ Important: WeChat notifications are only supported in OpenClaw chat context, not in CLI mode (`openclaw gen-cron` command)**
+```bash
+# Method 1: Check OpenClaw session history
+cat ~/.openclaw/agents/main/sessions/sessions.json | jq 'to_entries[] | select(.key | contains("wechat")) | {key, lastTo}'
 
-   **Use in OpenClaw Chat** (Recommended):
-   ```text
-   Use openclaw-github-trending tool to get today's trending and push to WeChat
-   or
-   Run immediately: Fetch today's trending and push to WeChat
-   ```
+# Method 2: Check message send records
+cat ~/.openclaw/agents/main/sessions/sessions.json | grep -i "o9cq.*@im.wechat"
 
-   **Create scheduled task in chat**:
-   ```bash
-   openclaw cron add --name "GitHub Trending Daily WeChat" \
-     --cron "0 18 * * *" \
-     --system-event '{"tool":"openclaw-github-trending","params":{"since":"daily","channels":["wechat"]}}'
-   ```
+# Method 3: Send a test message and check logs
+openclaw message send --channel openclaw-weixin --target "your-wechat-id" "test"
+```
 
-**Notes:**
-- WeChat notifications are sent as markdown messages to your personal WeChat account
-- Messages include new repositories (with full AI summaries) and trending repositories (with brief summaries)
-- WeChat functionality depends on the `executeTool` API provided by @tencent-weixin/openclaw-weixin plugin
-- CLI mode will return an error when using WeChat channel
-- If the WeChat plugin is not installed or configured, the plugin will show a warning but continue with other channels
+**⚠️ Notes:**
+- WeChat ID format: `o9cq806Il_QmHA022BUNXe0hUv4I@im.wechat` (case-sensitive!)
+- If auto-detection fails, error message includes detailed configuration guide
 
 *Required when using this channel
 

package/dist/channels/wechat.d.ts

@@ -1,51 +1,43 @@
 import { RepositoryInfo } from '../models/repository';
 import { PushResult } from './types';
 /**
- * WeChat channel configuration interface
+ * WeChat channel configuration
  */
 export interface WeChatConfig {
-    plugin_enabled?: boolean;
+    enabled?: boolean;
     receiver_id?: string;
     bot_account_id?: string;
+    channel_name?: string;
 }
 /**
- * WeChat Channel for pushing GitHub trending repositories via personal WeChat
- * Uses the @tencent-weixin/openclaw-weixin plugin
+ * WeChat Channel - 通过企业微信推送 GitHub 热榜
  */
 export declare class WeChatChannel {
     /**
-     * Build markdown message for WeChat
-     * @param newRepositories Array of new repositories
-     * @param seenRepositories Array of seen repositories
-     * @param since Time period for trending
-     * @returns Markdown formatted message
+     * 构建纯文本消息（企业微信不支持 markdown）
      */
-    static buildMarkdown(newRepositories: RepositoryInfo[], seenRepositories: RepositoryInfo[], since?: 'daily' | 'weekly' | 'monthly'): string;
+    static buildPlainText(newRepositories: RepositoryInfo[], seenRepositories: RepositoryInfo[], since?: 'daily' | 'weekly' | 'monthly'): string;
     /**
-     * Format number with 'k' suffix for thousands
-     * @param num Number to format
-     * @returns Formatted string
+     * 文本自动换行
+     */
+    static wrapText(text: string, maxWidth?: number): string[];
+    /**
+     * 格式化数字（添加 k 后缀）
      */
     static formatNumberWithK(num: number): string;
     /**
-     * Send message via OpenClaw WeChat plugin
-     * The plugin should be installed and configured in OpenClaw
-     *
-     * @param markdownContent Markdown content to send
-     * @param openclawApi OpenClaw API instance for invoking channels
-     * @param config WeChat configuration
-     * @returns Push result
+     * 发送消息到微信（通过 openclaw CLI）
+     */
+    static send(content: string, openclawApi: any, config: WeChatConfig): Promise<PushResult>;
+    /**
+     * 从多个来源解析 receiver_id
+     * 优先级：1. 插件配置 2. 环境变量 3. 消息上下文 4. 会话历史 5. OpenClaw API
      */
-    static send(markdownContent: string, openclawApi: any, config: WeChatConfig): Promise<PushResult>;
+    private static resolveReceiverId;
     /**
-     * Alternative method: Use OpenClaw's chat interface to send message
-     * This sends the message as if the plugin itself is "chatting" to the user
-     *
-     * @param markdownContent Markdown content to send
-     * @param openclawApi OpenClaw API instance
-     * @returns Push result
+     * 通过 openclaw CLI 发送消息
      */
-    static sendViaChat(markdownContent: string, openclawApi: any): Promise<PushResult>;
+    private static sendViaCli;
 }
 export default WeChatChannel;
 //# sourceMappingURL=wechat.d.ts.map

package/dist/channels/wechat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/channels/wechat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAClB,eAAe,EAAE,cAAc,EAAE,EACjC,gBAAgB,EAAE,cAAc,EAAE,EAClC,KAAK,GAAE,OAAO,GAAG,QAAQ,GAAG,SAAqB,GAChD,MAAM;IAuFT;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAO7C;;;;;;;;OAQG;WACU,IAAI,CACf,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,GAAG,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC;IA4EtB;;;;;;;OAOG;WACU,WAAW,CACtB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,UAAU,CAAC;CAoCvB;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/channels/wechat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,eAAe,EAAE,cAAc,EAAE,EACjC,gBAAgB,EAAE,cAAc,EAAE,EAClC,KAAK,GAAE,OAAO,GAAG,QAAQ,GAAG,SAAqB,GAChD,MAAM;IA0GT;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,EAAE;IAmB9D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAO7C;;OAEG;WACU,IAAI,CACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,CAAC;IAsEtB;;;OAGG;mBACkB,iBAAiB;IA2ItC;;OAEG;mBACkB,UAAU;CA6DhC;AAED,eAAe,aAAa,CAAC"}