Chroma Memory

Stores and semantically retrieves per-turn customer conversation data with auto-tagging and customer isolation using ChromaDB.

iPythoning@ipythoning

Install

openclaw skills install @ipythoning/chroma-memory

chroma-memory — Per-Turn Conversation Memory with ChromaDB

Long-term vector memory for customer conversations. Stores every turn with customer isolation, auto-tags quotes and commitments, enables semantic retrieval across sessions.

Commands

Command	Description
`chroma:store`	Store a conversation turn (auto-called after each turn)
`chroma:search <query>`	Semantic search across conversation history
`chroma:recall <customer_id>`	Recall recent history for a returning customer
`chroma:snapshot`	Store daily CRM snapshot as fallback (L4)
`chroma:stats`	Show storage statistics

Usage

bash

# Store a turn (normally auto-triggered by hook)
chroma:store --customer "+971501234567" --turn 5 --user "What's the price for 500 units?" --agent "Let me prepare a detailed quote..." --stage qualifying --topic pricing

# Search history
chroma:search "Dubai customer pricing discussion" --customer "+971501234567" --limit 5

# Recall for returning customer (auto-triggered when gap > 7 days)
chroma:recall "+971501234567" --limit 10

# Daily CRM snapshot (triggered by HEARTBEAT #12)
chroma:snapshot

# Stats
chroma:stats

Architecture

This skill implements Layer 3 (L3) and Layer 4 (L4) of the 4-layer Anti-Amnesia system:

L3: Every conversation turn → ChromaDB with customer_id isolation + auto-tagging
L4: Daily CRM snapshot → ChromaDB as disaster recovery fallback

Auto-Tagging

Turns are automatically tagged based on content analysis:

Tag	Trigger
`has_quote`	Price/cost/quote discussed
`has_commitment`	Promise made by either party
`has_objection`	Customer objection detected
`has_order`	Order/purchase confirmed
`has_sample`	Sample request discussed

Customer Isolation

All data is partitioned by customer_id (phone number). Queries always include where={"customer_id": ...} to ensure strict tenant isolation.

Dependencies

chromadb skill (vector database, install via ClawHub)
OpenClaw Gateway with session-memory hook enabled