Complete working setup

Author: 1to3for5vi7ate9x

QUICKSTART.md

@@ -0,0 +1,122 @@
+# Quickstart Guide for Discord and Telegram Integration
+
+This guide provides quick setup instructions for integrating Discord and Telegram with Eliza.
+
+## ⚠️ Discord Setup
+
+### Important Warning
+```diff
+- CAUTION: Using this on a user account is prohibited by the Discord TOS and can lead to the account block.
+- Use at your own risk. We recommend using official bot accounts instead.
+```
+
+### Getting Discord User Token
+1. Log into Discord in your web browser
+2. Open Developer Console (F12 or Ctrl+Shift+I)
+3. Paste and run the following code in the console:
+
+```javascript
+window.webpackChunkdiscord_app.push([
+  [Math.random()],
+  {},
+  req => {
+    if (!req.c) return;
+    for (const m of Object.keys(req.c)
+      .map(x => req.c[x].exports)
+      .filter(x => x)) {
+      if (m.default && m.default.getToken !== undefined) {
+        return copy(m.default.getToken());
+      }
+      if (m.getToken !== undefined) {
+        return copy(m.getToken());
+      }
+    }
+  },
+]);
+window.webpackChunkdiscord_app.pop();
+console.log('%cWorked!', 'font-size: 50px');
+console.log(`%cYou now have your token in the clipboard!`, 'font-size: 16px');
+```
+
+4. The token will be copied to your clipboard
+5. Add the token to your `.env` file:
+```env
+DISCORD_USER_TOKEN=your_token_here
+DISCORD_ALLOWED_CHANNELS=channel1,channel2
+```
+
+## 🤖 Telegram Setup
+
+### Creating Telegram Application
+1. Visit [Telegram API Development Tools](https://my.telegram.org/apps)
+2. Log in with your phone number
+3. Create a new application
+4. You will receive:
+   - API ID (number)
+   - API Hash (string)
+
+### Environment Setup
+Add the following to your `.env` file:
+```env
+TELEGRAM_API_ID=your_api_id
+TELEGRAM_API_HASH=your_api_hash
+TELEGRAM_ALLOWED_GROUPS=group1,group2
+```
+
+## Quick Implementation
+
+### Discord Client
+```typescript
+import { DiscordUserClient } from '@eliza/client-discord';
+
+const client = new DiscordUserClient(runtime);
+await client.start();
+```
+
+### Telegram Client
+```typescript
+import { TelegramUserClient } from '@eliza/client-telegram';
+
+const client = new TelegramUserClient(runtime);
+await client.start();
+```
+
+## Character Configuration
+Update your character configuration to specify which clients to use:
+
+```json
+{
+  "name": "YourBot",
+  "clients": ["discord", "telegram"],
+  "modelProvider": "your_provider",
+  "settings": {
+    "secrets": {}
+  }
+}
+```
+
+## Marketing Features
+Both clients support automated marketing with these defaults:
+- Message Interval: 15-45 minutes
+- Daily Limit: 96 messages per channel/group
+
+Enable marketing:
+```typescript
+// Discord
+await discordClient.messageManager.startMarketing();
+
+// Telegram
+await telegramClient.messageManager.startMarketing();
+```
+
+## Common Issues
+
+### Discord
+- Token Invalid: Regenerate token using the console script
+- Rate Limits: Ensure you're not sending too many messages too quickly
+- Channel Access: Verify the channels in DISCORD_ALLOWED_CHANNELS exist
+
+### Telegram
+- API ID/Hash Invalid: Double-check values on my.telegram.org
+- Session Errors: Clear session data and restart
+- Group Access: Ensure bot is member of groups in TELEGRAM_ALLOWED_GROUPS

characters/neuronlink.character.json

@@ -1,7 +1,7 @@
 {
     "name": "NeuronLink",
     "plugins": [],
-    "clients": ["telegram"],
+    "clients": ["discord"],
     "modelProvider": "ollama",
     "settings": {
       "secrets": {},

packages/client-discord/src/messageManager.ts

@@ -69,6 +69,9 @@ export class MessageManager {
     private lastMarketingTimes: Map<string, number> = new Map();
     private channelMessageCounts: Map<string, number> = new Map();
     private channelTimeReductions: Map<string, number> = new Map();
+    private readonly MIN_MARKETING_INTERVAL = 15 * 60 * 1000; // 15 minutes
+    private readonly MAX_MARKETING_INTERVAL = 45 * 60 * 1000; // 45 minutes
+    private readonly MAX_MARKETING_MESSAGES_PER_CHANNEL = 96; // Max messages per channel per day
     private marketingEnabled: boolean = false;
 
     constructor(runtime: IAgentRuntime, client: DiscordUserClient) {
@@ -78,9 +81,52 @@ export class MessageManager {
     }
 
     async startMarketing(): Promise<void> {
-        elizaLogger.log('Starting Discord marketing...');
-        this.marketingEnabled = true;
-        await this.initializeChannelMarketing();
+        try {
+            elizaLogger.log('Starting Discord marketing...');
+
+            // Get allowed channels from settings
+            const allowedChannelsStr = this.runtime.getSetting('DISCORD_ALLOWED_CHANNELS');
+            if (allowedChannelsStr?.trim()) {
+                const channels = allowedChannelsStr.split(',').map(name => name.trim());
+                this.targetChannels = new Set(channels);
+                elizaLogger.log('📢 Marketing initialized for channels:', Array.from(this.targetChannels));
+            }
+
+            this.marketingEnabled = true;
+            elizaLogger.log('✅ Marketing started successfully');
+
+            // Start marketing for each target channel
+            for (const channelName of this.targetChannels) {
+                this.scheduleNextMarketingMessage(channelName);
+            }
+        } catch (error) {
+            elizaLogger.error('❌ Failed to start marketing:', error);
+            throw error;
+        }
+    }
+
+    private scheduleNextMarketingMessage(channelName: string): void {
+        if (!this.marketingEnabled) return;
+
+        const interval = Math.floor(
+            Math.random() * (this.MAX_MARKETING_INTERVAL - this.MIN_MARKETING_INTERVAL) + this.MIN_MARKETING_INTERVAL
+        );
+
+        setTimeout(async () => {
+            try {
+                if (!this.marketingEnabled) return;
+
+                const channel = await this.client.getChannelByName(channelName);
+                if (channel && channel instanceof TextChannel) {
+                    await this.sendMarketingMessage(channel);
+                }
+                this.scheduleNextMarketingMessage(channelName);
+            } catch (error) {
+                elizaLogger.error('Error in marketing message schedule:', error);
+                // Retry after a delay
+                setTimeout(() => this.scheduleNextMarketingMessage(channelName), this.MIN_MARKETING_INTERVAL);
+            }
+        }, interval);
     }
 
     async stopMarketing(): Promise<void> {
@@ -123,7 +169,7 @@ export class MessageManager {
             MARKETING_CONSTANTS.BASE_WAIT_TIME - timeReduction
         );
 
-        return timeSinceLastMessage >= waitTime && 
+        return timeSinceLastMessage >= waitTime &&
                messageCount >= MARKETING_CONSTANTS.MIN_MESSAGES_BEFORE_REPLY;
     }
 
@@ -165,7 +211,7 @@ export class MessageManager {
 
     async getChatState(message: Message): Promise<State> {
         const channelId = message.channel.id;
-        
+
         // Format character data
         const character = this.runtime.character;
         const characterData = {
@@ -280,10 +326,10 @@ export class MessageManager {
             }
 
             const text = messageText.toLowerCase();
-            
+
             // Check if message contains character's name or aliases
             const nameMatch = text.includes(this.runtime.character.name.toLowerCase());
-            
+
             // Check if message matches character's topics
             const topics = this.runtime.character.topics || [];
             const topicMatch = topics.some(topic => {
@@ -295,7 +341,7 @@ export class MessageManager {
 
             // Get character's response rules
             const responseRules = this.runtime.character.style?.response_rules || [];
-            
+
             // Check against response patterns
             const respondPatterns = responseRules
                 .filter(rule => rule.toLowerCase().startsWith('respond:'))