Messaging agents that remember every conversation

// ~/.openclaw/openclaw.json
{
  "agents": {
    "family-assistant": {
      "model": "claude-sonnet-4-20250514",
      "system_prompt": "You are a helpful family group assistant...",
      "mcpServers": {
        "stompy": {
          "type": "sse",
          "url": "https://mcp.stompy.ai/sse",
          "headers": {
            "Authorization": "Bearer {STOMPY_API_KEY}"
          }
        }
      },
      "bindings": [
        { "platform": "whatsapp", "target": "Family Group" },
        { "platform": "telegram", "target": "@family_bot" }
      ]
    }
  }
}

// Agent saves context after a meaningful exchange
await stompy.lock_context({
  topic: "user_mum_whatsapp_context",
  content: `User Profile: Mum (Margaret)
  - Prefers vegetarian restaurants
  - Birthday: March 15th
  - Currently planning Easter gathering
  - Ongoing: looking for a venue that fits 12 people
  - Mentioned nephew Jake is now gluten-free
  - Preferred communication: short direct messages`,
  priority: "important",
  tags: "family,whatsapp,preferences"
});

// Save group-level context separately
await stompy.lock_context({
  topic: "group_family_whatsapp_context",
  content: `Family Group Context (updated)
  - Easter planning: shortlist down to 3 venues
  - Jake's birthday party: April 2nd, theme TBD
  - Recurring: Sunday dinner coordination
  - Dietary needs: Margaret (vegetarian), Jake (gluten-free),
    Dad (no shellfish)`,
  priority: "important",
  tags: "family,group,ongoing"
});

// On session start (after daily reset or idle timeout)
const userContext = await stompy.recall_context(
  "user_mum_whatsapp_context"
);
const groupContext = await stompy.recall_context(
  "group_family_whatsapp_context"
);

// Search for recent conversation threads
const recentTopics = await stompy.context_search(
  "Easter venue planning family"
);

// Agent's first message after reset:
// "Morning! Just picking up where we left off—have you
//  had a chance to check if The Garden Room can do
//  gluten-free options for Jake?"

// NOT: "Hello! I'm your family assistant. How can I help?"

// Specialist "travel-planner" agent receives handoff
// from generalist "family-assistant" agent

// Search for what the generalist already knows
const familyContext = await stompy.context_search(
  "Easter venue planning dietary requirements"
);
// → Finds: venue shortlist, 12 guests, dietary needs,
//   budget discussed last week

const userPrefs = await stompy.recall_context(
  "user_mum_whatsapp_context"
);
// → Finds: Margaret prefers vegetarian, short messages

// Specialist continues seamlessly:
// "I've looked into The Garden Room—they confirmed they
//  can handle vegetarian mains and gluten-free options.
//  Shall I check availability for the 19th?"

// NOT: "Hi! I'm the travel planning assistant.
//  What are you looking for?"

// After 6 weeks of daily conversations, Stompy holds:

// Week 1: Basic preferences and names
// Week 2: Dietary requirements, communication styles
// Week 3: Easter planning begins, venue research
// Week 4: Jake's birthday planning overlaps
// Week 6: Agent handles both events seamlessly

// The agent naturally knows:
await stompy.context_search("Margaret preferences");
// → vegetarian, prefers The Garden Room, likes window seats,
//   always orders dessert, birthday March 15th

await stompy.context_search("family events upcoming");
// → Easter: April 20th, The Garden Room confirmed (12 ppl)
//   Jake's birthday: April 2nd, bowling + pizza
//   Dad's golf tournament: April 12th

// Delta evaluation: when saving updated context,
// Stompy compares against existing and only stores
// what's actually new—no redundant entries
await stompy.lock_context({
  topic: "user_mum_whatsapp_context",
  content: "Updated: Margaret mentioned she's trying vegan options now",
  tags: "family,whatsapp,preferences"
});
// → Stompy merges with existing context, doesn't duplicate