@yeego/yeego-openclaw 1.0.2 → 1.1.0

package/QUICKSTART.md

@@ -1,82 +1,179 @@
 # Quick Start Guide
 
-## 🚀 Get Started in 3 Steps
+## 🚀 Get Started in 4 Steps
 
-### Step 1: Get Your Configuration
+### Step 1: Install the Plugin
+
+```bash
+openclaw plugins install @yeego/yeego-openclaw
+```
+
+### Step 2: Get Your Configuration from Yeego App
 
 1. Open Yeego mobile app
 2. Go to your profile → Settings
 3. Tap "Connect to OpenClaw" 🦞
-4. Tap "Copy Configuration"
-
-You'll get something like:
-
+4. Copy the configuration provided
+
+You'll get JSON configuration like:
+
+```json
+{
+  "token": "eyJhbG...",
+  "profileId": "abc123...",
+  "baseUrl": "https://yeego.app",
+  "sidecarUrl": "https://yeego.app/_sidecar",
+  "connectUrl": "https://yeego.app/_sidecar/public/openclaw/connect"
+}
 ```
-# Yeego OpenClaw Plugin Configuration
-YEEGO_TOKEN=eyJhbG...
-YEEGO_PROFILE_ID=abc123...
-YEEGO_BASE_URL=http://localhost:8091
-YEEGO_PLUGIN_URL=http://localhost:8092/openclaw-plugin
-```
-
-### Step 2: Save Configuration
 
-```bash
-cd openclaw-plugin
-
-# Paste your config and save
-bun run setup "YEEGO_TOKEN=eyJhbG...
-YEEGO_PROFILE_ID=abc123...
-YEEGO_BASE_URL=http://localhost:8091"
+### Step 3: Configure OpenClaw
+
+Add the configuration to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "channels": {
+    "yeego": {
+      "enabled": true,
+      "config": {
+        "token": "eyJhbG...",
+        "profileId": "abc123...",
+        "baseUrl": "https://yeego.app",
+        "sidecarUrl": "https://yeego.app/_sidecar",
+        "connectUrl": "https://yeego.app/_sidecar/public/openclaw/connect"
+      }
+    }
+  },
+  "hooks": {
+    "token": "YOUR_WEBHOOK_TOKEN_HERE"
+  }
+}
 ```
 
-✅ Configuration saved to `~/.yeego/config.json`
+**Important**: Set a secure webhook token. This is used for the poller to communicate with OpenClaw Gateway.
 
-### Step 3: Start Polling
+### Step 4: Restart OpenClaw Gateway
 
 ```bash
-bun run start
+openclaw gateway restart
 ```
 
-That's it! The plugin will:
-- ✅ Connect to your Yeego profile
-- ✅ Poll for new messages every 5 seconds  
-- ✅ Process them through OpenClaw
-- ✅ Send AI responses back to Yeego
+✅ The plugin will automatically:
+- Connect to your Yeego profile
+- Start polling for new messages
+- Process them through OpenClaw agent
+- Send AI responses back to Yeego
 
 ## 📱 Test It
 
 1. Open Yeego app
 2. Send a message to your AI persona
-3. Watch the poller process it
+3. OpenClaw will receive and process it
 4. See the AI response appear in the app
 
-## 🔧 Troubleshooting
+## 🔧 How It Works
+
+The Yeego plugin uses a **webhook-based architecture**:
+
+1. **Poller** detects new messages in Yeego
+2. Sends message to OpenClaw via `/hooks/agent` webhook
+3. **Gateway** processes message through your agent
+4. Calls `channel.sendText` to send response
+5. **Channel** creates message in Yeego via PocketBase API
+
+## 🔍 Troubleshooting
 
 **No messages being processed?**
-- Make sure you sent a message in the Yeego app
-- Check the profile_id matches your actual profile
+- Check OpenClaw Gateway is running: `openclaw gateway status`
+- Verify webhook token is configured in both places
+- Check logs: `tail -f ~/.openclaw/logs/gateway.log`
 
 **Connection errors?**
-- Verify backend is running (`http://localhost:8091`)
+- Verify your Yeego backend is accessible
 - Check your token hasn't expired (30 days validity)
+- Test the connection endpoint manually
+
+**Webhook authentication failed?**
+- Make sure `hooks.token` in `~/.openclaw/openclaw.json` matches
+- The poller reads this token to authenticate webhook calls
 
 **Want to reset?**
 ```bash
-rm -rf ~/.yeego
-# Then run setup again
+# Clear processed messages cache
+rm ~/.yeego/processed.json
+
+# Clear session mappings
+rm -rf ~/.openclaw/yeego-sessions/
+
+# Restart gateway
+openclaw gateway restart
 ```
 
-## 📦 Production Deployment
+## 📝 Configuration Reference
 
-When ready to deploy:
+### Yeego Channel Config
 
-```bash
-# Build standalone executable
-bun run build
+- `token`: JWT token from Yeego (30-day expiry)
+- `profileId`: Your Yeego profile ID
+- `baseUrl`: Yeego backend URL (PocketBase)
+- `sidecarUrl`: Yeego sidecar URL (for connect endpoint)
+- `connectUrl`: Full URL to the connect endpoint
+
+### Webhook Config
+
+- `hooks.token`: Secure token for webhook authentication
+  - Used by poller to call `/hooks/agent`
+  - Should be a long random string
+  - Example: `openssl rand -hex 32`
+
+## 🚀 Advanced
+
+### Development Mode
+
+For local development with localhost URLs:
+
+```json
+{
+  "channels": {
+    "yeego": {
+      "config": {
+        "baseUrl": "http://localhost:8091",
+        "sidecarUrl": "http://localhost:8092",
+        "connectUrl": "http://localhost:8092/public/openclaw/connect"
+      }
+    }
+  }
+}
+```
 
-# Run it anywhere
-./yeego-poller start
+### Custom Gateway Port
+
+If your Gateway runs on a different port:
+
+1. Find your Gateway port: `openclaw config get gateway.port`
+2. Update poller code or use environment variable
+
+### Multiple Profiles
+
+You can configure multiple Yeego profiles by using different channel IDs:
+
+```json
+{
+  "channels": {
+    "yeego-work": { ... },
+    "yeego-personal": { ... }
+  }
+}
 ```
 
-No dependencies needed - it's a single binary! 🎉
+## 📦 Production Tips
+
+- **Security**: Use HTTPS URLs in production
+- **Token Rotation**: Tokens expire after 30 days - regenerate in Yeego app
+- **Monitoring**: Check `~/.openclaw/logs/` for errors
+- **Performance**: Poller polls every 5 seconds - adjust if needed
+
+---
+
+🦞 **Happy chatting with Yeego + OpenClaw!**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeego/yeego-openclaw",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Yeego plugin for OpenClaw - Connect your AI personas",
   "main": "index.ts",
   "type": "module",

package/poller.ts

@@ -10,7 +10,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { spawn, ChildProcess } from 'child_process';
-import { setSessionConversation, setPlaceholderId } from './src/sessionMapping.js';
+import { setSessionConversation } from './src/sessionMapping.js';
 
 // ============================================================================
 // Types
@@ -172,52 +172,20 @@ class YeegoPoller {
     message: PocketBaseMessage,
     conversation: PocketBaseConversation
   ): Promise<void> {
-    let placeholderId: string | null = null;
-
     try {
       console.log(`[Yeego] Processing message: ${message.id}`);
 
-      // Create placeholder message to show loading state
-      const placeholder = await this.pb.collection('profile_chat_messages').create({
-        conversation: conversation.id,
-        message: '',
-        by: 'persona',
-        is_ai_generated: true,
-        has_finished_generating: false,
-        source: 'openclaw',
-      });
-      placeholderId = placeholder.id;
-      console.log(`[Yeego] Created placeholder: ${placeholderId}`);
-
-      // Save placeholder ID in memory cache for channel to use
-      setPlaceholderId(conversation.id, placeholderId);
-
-      // Save session mapping before calling OpenClaw
+      // Save session mapping
       this.saveSessionMapping(conversation.id);
 
-      // Call OpenClaw agent - it will update the placeholder via channel.sendText
-      await this.callOpenClawAgent(message, conversation);
+      // Call OpenClaw via webhook API
+      await this.sendToOpenClawWebhook(message, conversation);
 
-      // Workaround: Set messageChannel in session file after agent creates it
-      setTimeout(() => {
-        this.setSessionMessageChannel(conversation.id, 'yeego');
-      }, SESSION_METADATA_DELAY_MS);
-
-      console.log(`[Yeego] ✓ Processed message ${message.id}`);
+      console.log(`[Yeego] ✓ Sent message to OpenClaw webhook`);
     } catch (error) {
       console.error(`[Yeego] Error processing message:`, error);
 
-      // On error, clean up placeholder and create error message
-      if (placeholderId) {
-        try {
-          await this.pb.collection('profile_chat_messages').delete(placeholderId);
-          console.log(`[Yeego] Deleted placeholder: ${placeholderId}`);
-        } catch (deleteError) {
-          console.error(`[Yeego] Failed to delete placeholder:`, deleteError);
-        }
-      }
-
-      // Create error message
+      // Create error message if webhook call fails
       try {
         await this.pb.collection('profile_chat_messages').create({
           conversation: conversation.id,
@@ -240,103 +208,56 @@ class YeegoPoller {
     setSessionConversation(`yeego:${conversationId}`, conversationId);
   }
 
-  private async callOpenClawAgent(
+  private async sendToOpenClawWebhook(
     message: PocketBaseMessage,
     conversation: PocketBaseConversation
   ): Promise<void> {
-    console.log(`[Yeego] Calling OpenClaw agent for conversation: ${conversation.id}`);
-
-    const proc = spawn('openclaw', [
-      'agent',
-      '--session-id',
-      conversation.id,
-      '--reply-channel',
-      'yeego',
-      '--reply-to',
-      conversation.id,
-      '--message',
-      message.message,
-    ], {
-      stdio: ['ignore', 'pipe', 'pipe'],
-    });
+    console.log(`[Yeego] Sending message to OpenClaw webhook for conversation: ${conversation.id}`);
 
-    const { stdout, stderr, exitCode } = await this.captureProcessOutput(proc);
-
-    if (exitCode !== 0) {
-      console.error(`[Yeego] OpenClaw agent failed with exit code ${exitCode}`);
-      console.error(`[Yeego] stderr:`, stderr);
-      throw new Error(`OpenClaw agent failed: ${stderr}`);
-    }
+    // Get webhook token from OpenClaw config
+    const webhookToken = await this.getOpenClawWebhookToken();
 
-    console.log(`[Yeego] OpenClaw agent completed successfully`);
-    if (stdout) {
-      console.log(`[Yeego] stdout:`, stdout);
+    if (!webhookToken) {
+      throw new Error('No webhook token configured in OpenClaw. Please set hooks.token in ~/.openclaw/openclaw.json');
     }
-  }
-
-  private captureProcessOutput(proc: ChildProcess): Promise<{
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-  }> {
-    return new Promise((resolve) => {
-      let stdout = '';
-      let stderr = '';
-
-      proc.stdout?.on('data', (data) => {
-        stdout += data.toString();
-      });
 
-      proc.stderr?.on('data', (data) => {
-        stderr += data.toString();
-      });
-
-      proc.on('close', (code) => {
-        resolve({ stdout, stderr, exitCode: code || 0 });
-      });
+    // Call OpenClaw webhook API
+    // Note: channel should be just "yeego", the conversation ID will be passed via session routing
+    const response = await fetch('http://localhost:4242/hooks/agent', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${webhookToken}`,
+      },
+      body: JSON.stringify({
+        message: message.message,
+        sessionKey: conversation.id,
+        channel: 'yeego',
+      }),
     });
-  }
 
+    if (!response.ok) {
+      const errorText = await response.text();
+      console.error(`[Yeego] Webhook call failed: ${response.status} ${errorText}`);
+      throw new Error(`OpenClaw webhook failed: ${response.status} ${errorText}`);
+    }
 
-  // --------------------------------------------------------------------------
-  // Session Metadata Workaround
-  // --------------------------------------------------------------------------
+    console.log(`[Yeego] Webhook call successful (${response.status})`);
+  }
 
-  /**
-   * Sets messageChannel in OpenClaw session metadata file.
-   * This is a workaround because --reply-channel CLI flag doesn't set the session's messageChannel property.
-   */
-  private setSessionMessageChannel(sessionId: string, channel: string): boolean {
+  private async getOpenClawWebhookToken(): Promise<string | null> {
     try {
-      const sessionDir = join(homedir(), '.openclaw', 'agents', 'main', 'sessions');
-      const sessionFile = join(sessionDir, `${sessionId}.jsonl`);
-
-      if (!existsSync(sessionFile)) {
-        console.log(`[Yeego] Session file not found yet: ${sessionFile}`);
-        return false;
-      }
-
-      const lines = readFileSync(sessionFile, 'utf-8')
-        .split('\n')
-        .filter(l => l.trim());
-
-      if (lines.length === 0) {
-        return false;
-      }
-
-      const firstLine = JSON.parse(lines[0]);
-      if (firstLine.type === 'session') {
-        firstLine.messageChannel = channel;
-        lines[0] = JSON.stringify(firstLine);
-        writeFileSync(sessionFile, lines.join('\n') + '\n', 'utf-8');
-        console.log(`[Yeego] ✓ Set messageChannel="${channel}" for session ${sessionId}`);
-        return true;
+      const configPath = join(homedir(), '.openclaw', 'openclaw.json');
+      if (!existsSync(configPath)) {
+        console.error(`[Yeego] OpenClaw config not found: ${configPath}`);
+        return null;
       }
 
-      return false;
+      const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+      return config?.hooks?.token || null;
     } catch (error) {
-      console.error(`[Yeego] Failed to set messageChannel:`, error);
-      return false;
+      console.error(`[Yeego] Failed to read OpenClaw config:`, error);
+      return null;
     }
   }
 

package/src/channel.ts

@@ -22,7 +22,6 @@ import { createYeegoTools } from "./tools/index.js";
 import {
   setSessionConversation,
   getSessionConversation,
-  consumePlaceholderId,
 } from "./sessionMapping.js";
 
 // ============================================================================
@@ -309,57 +308,17 @@ export const yeegoPlugin: ChannelPlugin<YeegoConfig> = {
         const pb = new PocketBase(config.base_url);
         pb.authStore.save(config.token);
 
-        // First, try to get the placeholder ID from memory cache (most reliable)
-        const cachedPlaceholderId = consumePlaceholderId(conversationId);
-        let placeholderMessage = null;
-
-        if (cachedPlaceholderId) {
-          // We have the exact placeholder ID from poller
-          try {
-            placeholderMessage = await pb.collection('profile_chat_messages').getOne(cachedPlaceholderId);
-            console.log(`[Yeego] Found placeholder from cache: ${placeholderMessage.id}`);
-          } catch (error) {
-            console.warn(`[Yeego] Cached placeholder not found, falling back to query`);
-          }
-        }
-
-        // Fallback: search for placeholder message if cache miss
-        if (!placeholderMessage) {
-          try {
-            const recentMessages = await pb.collection('profile_chat_messages').getList(1, 1, {
-              filter: `conversation="${conversationId}" && by="persona" && has_finished_generating=false && source="openclaw"`,
-              sort: '-created',
-            });
-
-            if (recentMessages.items.length > 0) {
-              placeholderMessage = recentMessages.items[0];
-              console.log(`[Yeego] Found placeholder via query: ${placeholderMessage.id}`);
-            }
-          } catch (error) {
-            console.log(`[Yeego] No placeholder found, will create new message`);
-          }
-        }
+        // Simply create a new message - no placeholder logic needed
+        const message = await pb.collection('profile_chat_messages').create({
+          conversation: conversationId,
+          message: text,
+          by: 'persona',
+          is_ai_generated: true,
+          has_finished_generating: true,
+          source: 'openclaw',
+        });
 
-        let message;
-        if (placeholderMessage) {
-          // Update existing placeholder
-          message = await pb.collection('profile_chat_messages').update(placeholderMessage.id, {
-            message: text,
-            has_finished_generating: true,
-          });
-          console.log(`[Yeego] Updated placeholder: ${message.id}`);
-        } else {
-          // Create new message if no placeholder exists
-          message = await pb.collection('profile_chat_messages').create({
-            conversation: conversationId,
-            message: text,
-            by: 'persona',
-            is_ai_generated: true,
-            has_finished_generating: true,
-            source: 'openclaw',
-          });
-          console.log(`[Yeego] Created new message: ${message.id}`);
-        }
+        console.log(`[Yeego] Created message: ${message.id}`);
 
         return {
           channel: "yeego",

package/src/sessionMapping.ts

@@ -56,58 +56,6 @@ function saveMappings(mappings: SessionMappings): void {
   }
 }
 
-// ============================================================================
-// In-Memory Placeholder Cache
-// ============================================================================
-
-// Cache placeholder message IDs temporarily (in memory only)
-// Use array to support multiple concurrent messages per conversation
-const placeholderCache = new Map<string, string[]>();
-
-/**
- * Sets the placeholder message ID for a conversation (in-memory cache).
- * This is used to pass the placeholder ID from poller to channel.
- * Supports multiple placeholders per conversation for concurrent messages.
- */
-export function setPlaceholderId(conversationId: string, placeholderId: string): void {
-  const existing = placeholderCache.get(conversationId) || [];
-  existing.push(placeholderId);
-  placeholderCache.set(conversationId, existing);
-
-  // Auto-expire after 30 seconds to avoid memory leaks
-  setTimeout(() => {
-    const current = placeholderCache.get(conversationId);
-    if (current) {
-      const filtered = current.filter(id => id !== placeholderId);
-      if (filtered.length === 0) {
-        placeholderCache.delete(conversationId);
-      } else {
-        placeholderCache.set(conversationId, filtered);
-      }
-    }
-  }, 30000);
-}
-
-/**
- * Gets and removes the oldest placeholder message ID for a conversation (FIFO).
- * This ensures concurrent messages are handled in order.
- */
-export function consumePlaceholderId(conversationId: string): string | undefined {
-  const placeholders = placeholderCache.get(conversationId);
-  if (!placeholders || placeholders.length === 0) {
-    return undefined;
-  }
-
-  // Remove and return the first (oldest) placeholder
-  const placeholderId = placeholders.shift();
-
-  if (placeholders.length === 0) {
-    placeholderCache.delete(conversationId);
-  }
-
-  return placeholderId;
-}
-
 // ============================================================================
 // Public API
 // ============================================================================