@yungho/noclaw-channel 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# @yungho/noclaw-channel
+
+NoClaw Channel Server — WebSocket IPC bridge that connects external chat platforms (WeChat, Telegram) to [NoClaw](https://github.com/noclaw/noclaw) for Obsidian.
+
+## How It Works
+
+```
+  Phone (WeChat/Telegram)
+        ↕ HTTP Long Polling
+  @noclaw/channel (this package)
+        ↕ WebSocket (ws://127.0.0.1:8123)
+  NoClaw Plugin (Obsidian)
+```
+
+The Channel Server runs as a standalone Node.js process. It handles communication with external chat platforms and bridges messages to the NoClaw Obsidian plugin via WebSocket.
+
+## Requirements
+
+- **Node.js** >= 18
+- **NoClaw** plugin installed in Obsidian
+
+## Installation
+
+### Option A — npx (no install required)
+
+```bash
+npx @yungho/noclaw-channel start
+```
+
+### Option B — global install (recommended for daily use)
+
+```bash
+npm i -g @yungho/noclaw-channel
+noclaw-channel start
+```
+
+## Usage
+
+### Start the server
+
+```bash
+# Default (ws://127.0.0.1:8123)
+noclaw-channel start
+
+# Custom port
+noclaw-channel start --port=9000
+
+# Custom host
+noclaw-channel start --host=0.0.0.0
+```
+
+### Other commands
+
+```bash
+noclaw-channel status   # Check if server is running
+noclaw-channel stop     # Stop the server
+noclaw-channel setup    # Interactive configuration wizard
+```
+
+## Connecting to NoClaw
+
+1. Start the Channel Server in your terminal
+2. Open Obsidian → Settings → NoClaw → Chat Channels
+3. Enable "Chat Channels"
+4. Click "Connect"
+5. For WeChat: scan the QR code shown in the terminal
+
+## Supported Platforms
+
+| Platform | Status | Auth Method |
+|----------|--------|-------------|
+| WeChat   | ✅ Working | QR Code (ClawBot ilink API) |
+| Telegram | 🔜 Planned | Bot Token |
+
+## Configuration
+
+The server stores its config at `~/.noclaw/channel-config.json`:
+
+```json
+{
+  "port": 8123,
+  "host": "127.0.0.1",
+  "logLevel": "info",
+  "wechat": {
+    "enabled": true,
+    "permissions": {
+      "chat": "all",
+      "executeTools": true,
+      "permissionRelay": true,
+      "adminUsers": []
+    }
+  },
+  "telegram": {
+    "enabled": false,
+    "botToken": "",
+    "allowedUsers": [],
+    "permissions": {
+      "chat": "whitelist",
+      "executeTools": true,
+      "permissionRelay": true,
+      "adminUsers": []
+    }
+  }
+}
+```
+
+## License
+
+Apache-2.0

package/bin/cli.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { ChannelServer } from '../dist/server/ChannelServer.js';
+import { ConfigManager } from '../dist/config/ConfigManager.js';
+import { Logger } from '../dist/utils/Logger.js';
+
+const loggerWrapper = new Logger();
+const logger = loggerWrapper.getPinoLogger();
+
+program
+  .name('noclaw-channel')
+  .description('NoClaw Channel Server - WebSocket IPC bridge for external chat platforms')
+  .version('0.1.0');
+
+program
+  .command('start')
+  .description('Start the channel server')
+  .option('--port <port>', 'WebSocket port (default: 8123)', '8123')
+  .option('--host <host>', 'WebSocket host (default: 127.0.0.1)', '127.0.0.1')
+  .option('--background', 'Run as background process', false)
+  .action(async (options) => {
+    try {
+      const config = new ConfigManager();
+      const server = new ChannelServer(config, logger);
+
+      await server.start({
+        port: parseInt(options.port),
+        host: options.host,
+        background: options.background
+      });
+
+      logger.info('Channel server started successfully');
+    } catch (error) {
+      logger.error('Failed to start server:', error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('stop')
+  .description('Stop the channel server')
+  .action(async () => {
+    try {
+      const config = new ConfigManager();
+      await config.stopChannel();
+      logger.info('Channel server stopped');
+    } catch (error) {
+      logger.error('Failed to stop server:', error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('status')
+  .description('Check the status of the channel server')
+  .action(async () => {
+    try {
+      const config = new ConfigManager();
+      const status = await config.getStatus();
+      logger.info('Channel server status:', status);
+    } catch (error) {
+      logger.error('Failed to get status:', error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('setup')
+  .description('Setup the channel server configuration')
+  .action(async () => {
+    try {
+      const config = new ConfigManager();
+      await config.interactiveSetup();
+      logger.info('Setup completed successfully');
+    } catch (error) {
+      logger.error('Setup failed:', error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/dist/channels/TelegramChannel.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Telegram Channel Implementation
+ *
+ * Uses Telegram Bot API for message communication.
+ * This is a placeholder implementation for future use.
+ */
+import { IChannel, IpcMessage, TelegramConfig, ChannelStatus, ChannelCapabilities, MediaObject } from '../types.js';
+import pino from 'pino';
+export declare class TelegramChannel implements IChannel {
+    private readonly baseUrl;
+    private config;
+    private logger;
+    private status;
+    private pollingInterval?;
+    private messageCallback?;
+    private statusCallbacks;
+    private qrCodeCallbacks;
+    private lastUpdateId;
+    private readonly POLLING_INTERVAL;
+    constructor(config: TelegramConfig, logger: pino.Logger);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(text: string, contextToken: string, media?: MediaObject[]): Promise<void>;
+    onMessage(callback: (msg: IpcMessage) => void): void;
+    getStatus(): ChannelStatus;
+    getCapabilities(): ChannelCapabilities;
+    onStatusChange(callback: (status: ChannelStatus) => void): void;
+    requestQrCode(): void;
+    onQrCode(callback: (qrCodeUrl: string) => void): void;
+    /**
+     * Start polling for incoming messages
+     */
+    private startMessagePolling;
+    /**
+     * Stop all polling
+     */
+    private stopPolling;
+    /**
+     * Send text message
+     */
+    private sendMessage;
+    /**
+     * Send photo
+     */
+    private sendPhoto;
+    /**
+     * Make HTTP request to Telegram API
+     */
+    private makeRequest;
+    /**
+     * Update connection status
+     */
+    private setStatus;
+    /**
+     * Notify listeners about QR code
+     */
+    private notifyQrCode;
+}
+//# sourceMappingURL=TelegramChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramChannel.d.ts","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,IAAI,MAAM,MAAM,CAAC;AAqCxB,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,eAAe,CAAC,CAA4B;IACpD,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;IAMjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpF,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,SAAS,IAAI,aAAa;IAI1B,eAAe,IAAI,mBAAmB;IAUtC,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI/D,aAAa,IAAI,IAAI;IAKrB,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,WAAW;IAyBzB;;OAEG;YACW,SAAS;IA2BvB;;OAEG;YACW,WAAW;IAYzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB"}

package/dist/channels/TelegramChannel.js

@@ -0,0 +1,223 @@
+/**
+ * Telegram Channel Implementation
+ *
+ * Uses Telegram Bot API for message communication.
+ * This is a placeholder implementation for future use.
+ */
+export class TelegramChannel {
+    baseUrl;
+    config;
+    logger;
+    status = 'disconnected';
+    pollingInterval;
+    messageCallback;
+    statusCallbacks = new Set();
+    qrCodeCallbacks = new Set();
+    lastUpdateId = 0;
+    POLLING_INTERVAL = 2000; // 2 seconds
+    constructor(config, logger) {
+        this.config = config;
+        this.baseUrl = `https://api.telegram.org/bot${config.botToken}`;
+        this.logger = logger.child({ channel: 'telegram' });
+    }
+    async connect() {
+        if (!this.config.enabled) {
+            this.logger.warn('Telegram channel is disabled in config');
+            return;
+        }
+        this.setStatus('connecting');
+        try {
+            // Test token by making a request
+            const response = await this.makeRequest('/getUpdates', {
+                method: 'GET',
+            });
+            if (!response.ok) {
+                throw new Error('Invalid bot token or API error');
+            }
+            this.startMessagePolling();
+            this.setStatus('connected');
+            this.logger.info('Connected to Telegram Bot API');
+        }
+        catch (error) {
+            this.logger.error({ error }, 'Failed to connect to Telegram');
+            this.setStatus('error');
+            throw error;
+        }
+    }
+    async disconnect() {
+        this.stopPolling();
+        this.setStatus('disconnected');
+        this.logger.info('Disconnected from Telegram');
+    }
+    async send(text, contextToken, media) {
+        try {
+            const chatId = contextToken.replace('tg_', '');
+            if (media && media.length > 0) {
+                // Send media first
+                for (const item of media) {
+                    if (item.type === 'image') {
+                        await this.sendPhoto(chatId, item.data, text);
+                        break; // Only send first image for now
+                    }
+                }
+            }
+            else {
+                // Send text message
+                await this.sendMessage(chatId, text);
+            }
+            this.logger.debug({ chatId, textLength: text.length }, 'Message sent to Telegram');
+        }
+        catch (error) {
+            this.logger.error({ error, contextToken }, 'Failed to send message to Telegram');
+            throw error;
+        }
+    }
+    onMessage(callback) {
+        this.messageCallback = callback;
+    }
+    getStatus() {
+        return this.status;
+    }
+    getCapabilities() {
+        return {
+            textMessaging: true,
+            mediaSharing: true,
+            permissionRelay: true,
+            richFormatting: true,
+            webhooks: false,
+        };
+    }
+    onStatusChange(callback) {
+        this.statusCallbacks.add(callback);
+    }
+    requestQrCode() {
+        // Telegram uses bot token, not QR code
+        this.logger.info('Telegram uses bot token authentication, no QR code');
+    }
+    onQrCode(callback) {
+        this.qrCodeCallbacks.add(callback);
+    }
+    /**
+     * Start polling for incoming messages
+     */
+    startMessagePolling() {
+        this.stopPolling(); // Clear any existing polling
+        this.pollingInterval = setInterval(async () => {
+            try {
+                const response = await this.makeRequest(`/getUpdates?offset=${this.lastUpdateId}`, {
+                    method: 'GET',
+                });
+                if (response.result && response.result.length > 0) {
+                    this.logger.debug({ messageCount: response.result.length }, 'Received messages from Telegram');
+                    for (const update of response.result) {
+                        // Update last update ID
+                        this.lastUpdateId = update.update_id;
+                        // Emit message to callback
+                        if (update.message?.text) {
+                            this.messageCallback?.({
+                                type: 'MSG_IN',
+                                platform: 'telegram',
+                                content: update.message.text,
+                                contextToken: `tg_${update.message.chat.id}`,
+                                userId: String(update.message.from.id),
+                                metadata: {
+                                    timestamp: Date.now(),
+                                    platform: 'telegram',
+                                    userId: String(update.message.from.id),
+                                    messageId: String(update.message.message_id),
+                                },
+                            });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.error({ error }, 'Error polling for messages');
+                // Don't stop polling on error, just log it
+            }
+        }, this.POLLING_INTERVAL);
+    }
+    /**
+     * Stop all polling
+     */
+    stopPolling() {
+        if (this.pollingInterval) {
+            clearInterval(this.pollingInterval);
+            this.pollingInterval = undefined;
+        }
+    }
+    /**
+     * Send text message
+     */
+    async sendMessage(chatId, text) {
+        const url = `${this.baseUrl}/sendMessage`;
+        const body = JSON.stringify({
+            chat_id: parseInt(chatId),
+            text,
+        });
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body,
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send message: ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (!data.ok) {
+            throw new Error('Failed to send message');
+        }
+    }
+    /**
+     * Send photo
+     */
+    async sendPhoto(chatId, photoData, caption) {
+        const url = `${this.baseUrl}/sendPhoto`;
+        const formData = new FormData();
+        formData.append('chat_id', chatId);
+        const buffer = Buffer.from(photoData, 'base64');
+        const blob = new Blob([buffer], { type: 'image/jpeg' });
+        formData.append('photo', blob, 'photo.jpg');
+        if (caption) {
+            formData.append('caption', caption);
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            body: formData,
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send photo: ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (!data.ok) {
+            throw new Error('Failed to send photo');
+        }
+    }
+    /**
+     * Make HTTP request to Telegram API
+     */
+    async makeRequest(endpoint, options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Update connection status
+     */
+    setStatus(status) {
+        this.status = status;
+        this.statusCallbacks.forEach((callback) => callback(status));
+    }
+    /**
+     * Notify listeners about QR code
+     */
+    notifyQrCode(qrCodeUrl) {
+        this.qrCodeCallbacks.forEach((callback) => callback(qrCodeUrl));
+    }
+}
+//# sourceMappingURL=TelegramChannel.js.map

package/dist/channels/TelegramChannel.js.map

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

package/dist/channels/WechatChannel.d.ts

@@ -0,0 +1,65 @@
+/**
+ * WeChat Channel Implementation
+ *
+ * Uses WeChat's official ClawBot ilink API for safe, official integration
+ * without risk of account suspension.
+ */
+import { IChannel, IpcMessage, WechatConfig, ChannelStatus, ChannelCapabilities, MediaObject } from '../types.js';
+import pino from 'pino';
+export declare class WechatChannel implements IChannel {
+    private readonly baseUrl;
+    private readonly defaultBaseUrl;
+    private botToken?;
+    private config;
+    private logger;
+    private status;
+    private pollingInterval?;
+    private qrCodePollingInterval?;
+    private messageCallback?;
+    private statusCallbacks;
+    private qrCodeCallbacks;
+    private lastQrCodeUrl?;
+    private lastUpdateId;
+    private readonly POLLING_INTERVAL;
+    private readonly QR_CODE_POLLING_INTERVAL;
+    private readonly LONG_POLLING_TIMEOUT;
+    constructor(config: WechatConfig, logger: pino.Logger);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(text: string, contextToken: string, media?: MediaObject[]): Promise<void>;
+    onMessage(callback: (msg: IpcMessage) => void): void;
+    getStatus(): ChannelStatus;
+    getCapabilities(): ChannelCapabilities;
+    onStatusChange(callback: (status: ChannelStatus) => void): void;
+    requestQrCode(): void;
+    onQrCode(callback: (qrCodeUrl: string) => void): void;
+    /**
+     * Authenticate with WeChat using QR code
+     */
+    private authenticateWithQrCode;
+    /**
+     * Poll for QR code scan status
+     */
+    private pollQrCodeStatus;
+    /**
+     * Start polling for incoming messages
+     */
+    private startMessagePolling;
+    /**
+     * Stop all polling
+     */
+    private stopPolling;
+    /**
+     * Make HTTP request to WeChat API
+     */
+    private makeRequest;
+    /**
+     * Update connection status
+     */
+    private setStatus;
+    /**
+     * Notify listeners about QR code
+     */
+    private notifyQrCode;
+}
+//# sourceMappingURL=WechatChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WechatChannel.d.ts","sourceRoot":"","sources":["../../src/channels/WechatChannel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,IAAI,MAAM,MAAM,CAAC;AA8BxB,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,qBAAqB,CAAC,CAAiB;IAC/C,OAAO,CAAC,eAAe,CAAC,CAA4B;IACpD,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAQ;IACjD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;IAS/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BpF,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,SAAS,IAAI,aAAa;IAI1B,eAAe,IAAI,mBAAmB;IAUtC,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI/D,aAAa,IAAI,IAAI;IAQrB,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,gBAAgB;IA+D9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoD3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;YACW,WAAW;IAgCzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB"}