Cross Platform Memory

Cross-Platform Memory

Reads recent user messages from Telegram and Discord session logs and injects them into the agent's memory context on every gateway request.

What It Does

When the agent receives a message (via any channel), this bridge reads:

1. Telegram messages from the active session's JSONL log
2. Discord messages from the same session log (filtered to user-only, excluding bot output)
3. Local memory files (MEMORY.md, daily notes)

And prepends them as a system context block so the agent has full cross-platform awareness.

How It Works

User message → Gateway → Memory Bridge (reads JSONL) → System context → Agent

• Telegram detection: Messages starting with "Conversation info (untrusted metadata):"
• Discord detection: Entries with channel: "discord" and message.role: "user"
• Bot filtering: Discord bot messages (where the message author is a bot) are excluded
• Platform tagging: Each message prefixed with [telegram] or [discord] for clarity
• Time sorting: Most recent messages prioritised, limited to last 8 per platform

Setup

1. Configure the session log path

The bridge reads from OpenClaw's session logs. Default path:

C:\Users\<user>\.openclaw\agents\main\sessions\

The bridge auto-detects the most recent JSONL file in that directory.

2. Install the skill

clawhub install cross-platform-memory

3. Configure the bridge in your mission-control

Copy references/memory-bridge.ts to your mission-control's src/lib/ directory:

cp references/memory-bridge.ts /path/to/mission-control/src/lib/

4. Wire into your chat API

In your src/app/api/mc/chat/route.ts:

import { getMemoryContext } from '@/lib/memory-bridge';

// In your POST handler, before calling the gateway:
const memoryContext = await getMemoryContext();
const messages = memoryContext
  ? [{ role: 'system' as const, content: memoryContext }, { role: 'user' as const, content: message }]
  : [{ role: 'user' as const, content: message }];

Configuration

The skill uses environment variables for machine-specific paths (set these in your .env or system environment):

In memory-bridge.ts:

Output Format

MEMORY CONTEXT:

## MEMORY.md
[Curated long-term memories]

## Today's Notes
[Daily notes]

## Recent Telegram Conversation
[telegram] Dan: message 1
[telegram] Dan: message 2

## Recent Discord Conversation
[discord] Dan: message 1
[discord] Dan: message 2

IMPORTANT: You are Sancho — use the context above to inform your responses.

Known Limitations

• Only reads from the most recent session log file
• Discord bot messages are filtered out (only user messages included)
• Messages older than 20 hours by default are excluded
• If no session logs exist, falls back to MEMORY.md and daily notes only