OOpenclawnet
  • Introduction
  • Docs
      • 20260425 concept review
      • 20260503 repo split decision
      • Agent runtime
      • Components
      • Glossary
      • Jobs
      • Memory service proposal
      • Nemoclaw mapping
      • Openclaw mapping
      • Overview
      • Provider model
      • Runtime flow
      • Scenarios s4 s5 plan
      • Secrets vault admin ui
      • Secrets vault azure readiness
      • Secrets vault evolution
      • Secrets vault lifecycle phase4
      • Secrets vault lifecycle phase5
      • Secrets vault phase5
      • Secrets vault phase6
      • Secrets vault threat model
      • Source of truth rules
      • Storage
  • Scripts
  • Sessions
    • RELEASE CHECKLIST
    • Session 2 guide es
    • Session 2 guide
    • Session 3 guide es
    • Session 3 guide
    • Session 4 guide es
    • Session 4 guide
    • Session 5 guide es
    • Session 5 guide
    • Speakers
  • Src
  • Tests
Powered by Docsbook
Docs/Architecture/Memory service proposal
JobsPreviousNemoclaw mappingNext

On this page

  • 1. Summary
  • 2. Goals & Non-Goals
  • Goals
  • Non-Goals
  • 3. Current State
  • 3.1 The contract project
  • 3.2 The embeddings interface
  • 3.3 The service host
  • 3.4 The Gateway proxy / facade
  • 3.5 The embeddings tool
  • 3.6 AppHost wiring
  • 3.7 Honest gaps (today)
  • 4. What "Agent Memory" Means in OpenClawNet
  • Write events (what causes a memory to be created)
  • Read events (what causes a memory to be retrieved)
  • Per-agent identity
  • 5. Architecture Overview
  • 6. Vector DB Choice
  • APPROVED: MempalaceNet (replaces original Qdrant recommendation)
  • Original Recommendation: Qdrant (superseded)
  • 7. Embeddings Strategy
  • Recommendation: default to local ONNX via Elbruno.LocalEmbeddings, swap-able through IEmbeddingGenerator<string, Embedding<float>>.
  • Why local first
  • Model recommendation
  • Abstraction
  • Operational details
  • 8. Per-Agent Isolation Model
  • Recommendation: single shared collection + payload filter on agent_id, with an explicit "isolation guard" enforced at the IAgentMemoryStore boundary.
  • The isolation guard
  • "Forget me"
  • 9. Data Model
  • Memory record (logical schema, stored as Qdrant point)
  • JSON example
  • Relational sidecar (SQLite)
  • 10. Write Path / Ingestion Pipeline
  • Sources
  • Pipeline
  • Sync vs async
  • Deduplication
  • Importance scoring (v1)
  • 11. Read Path / Retrieval Pipeline
  • Pre-turn retrieval (the common case)
  • Explicit recall(query, topK?) tool
  • Post-filter scoring (v1)
  • Reranking (Phase 2)
  • Context budget
  • Closed by E2E demo
  • 12. Retention, Forgetting, and Lifecycle
  • 13. API Surface (HTTP)
  • Streaming
  • Auth / loopback
  • 14. Aspire Topology Changes
  • 15. Migration from Existing Memory Code
  • Step-by-step (descriptive only — no code in this PR)
  • Files that change (forecast — for review only)
  • 16. Testing Strategy
  • 17. Observability
  • Traces (ActivitySource: OpenClawNet.Memory)
  • Metrics (Meter: OpenClawNet.Memory)
  • Logs
  • 18. Security & Privacy
  • 19. Open Questions / Decisions Bruno Needs to Make
  • 20. Phased Rollout Plan
  • Phase 1 — MVP
  • Phase 2 — Quality
  • Phase 3 — Multi-agent
  • 21. Risks & Mitigations
  • 22. Follow-up issues spotted (not fixed here)
  • 23. References

Was this page helpful?