> For the complete documentation index, see [llms.txt](https://docs.noelclaw.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.noelclaw.fun/memory-and-knowledge/memory.md). # Semantic Memory Noelclaw remembers things you tell it - across sessions, across chats, across days. This isn't just chat history. It's a vector knowledge base: your preferences, research, decisions, and strategies are indexed by **meaning**, not keywords. Ask "what's my risk tolerance?" and it finds "user avoids leverage and prefers Base-only DeFi" - even if you never used those exact words. *** ## How It Works Every time you save something to the vault or tell Noelclaw to remember something, it gets stored in two places: 1. **Vault** - structured, versioned, searchable by keyword 2. **Semantic memory (vector index)** - indexed by meaning, searchable by intent When you ask a question, Noelclaw searches semantic memory first. If it finds relevant entries, it uses those to answer. If not, it falls back to keyword search. You don't need to do anything special. It just works. *** ## Basic Usage ### Save a preference > "Remember that I prefer low-risk DeFi. Lido for staking, Aerodrome for LP on Base. No leverage, no meme coins." ### Save research > "Remember: ETH/USDC LP on Aerodrome targets 12-18% APY. Rebalance weekly. Exit if IL exceeds 5%." ### Save your portfolio > "Remember my allocation: 60% ETH, 25% USDC, 15% other. DCA on 15%+ dips monthly." *** ## Test Recall (Do This in a New Chat) Close your current chat. Open a fresh one. Then ask: > "What do you know about my DeFi strategy?" > "Should I look at Ethereum mainnet for yields?" > "What's my portfolio allocation?" Noelclaw will answer correctly - pulling from memory it saved in a completely different session. *** ## Memory Tools These tools are available directly if you want more control: | Tool | What It Does | | -------------------- | ------------------------------------------------------------------------- | | `memory_add` | Add content to semantic memory - text, notes, or auto-fetch a URL. | | `memory_search` | Search by meaning - finds relevant entries even without exact keywords. | | `memory_context` | Load the most relevant memories for a topic as ready-to-use AI context. | | `memory_profile` | See your memory stats - total entries, recent activity, patterns. | | `memory_list` | List recent memory entries, optionally filtered by tag. | | `memory_delete` | Remove a specific memory entry by ID. | | `memory_insight` | AI-generated insights derived from patterns across your saved memories. | | `memory_extract` | Extract discrete facts from any block of text and save each individually. | | `memory_consolidate` | Merge overlapping memories on a topic into one clean summary. | | `vault_search` | Full-text keyword search across your structured vault. | *** ## Connecting External Sources ### Index a URL or GitHub repo > "Index this into my memory: " Or directly: > "Connect this URL to my memory: " Noelclaw fetches the page, indexes the full content, and makes it searchable in \~30 seconds. ### Full workspace sync For Google Drive, Gmail, and full Notion workspace sync - connect via your dashboard at [noelclaw.com](https://noelclaw.com). *** ## Cross-Session Memory: The Demo This is the best way to see it in action. **Session 1 (save):** > "Remember these about me: I only trade on Base mainnet. I prefer low-risk DeFi - Lido for ETH staking, Aerodrome for LP. I never touch leverage or meme coins. Portfolio is 60% ETH, 25% USDC, 15% other. I DCA monthly on 15%+ dips." Close the chat. Open a completely new one. **Session 2 (recall):** > "I'm thinking of bridging to Ethereum mainnet for some yield plays. Is that smart for me?" Expected response: Noelclaw immediately says no - referencing your Base-only preference, your low-risk profile, and the gas cost argument. All from memory. Zero context given in this session. *** ## Tips * **Be specific when saving** - "I prefer low-risk DeFi on Base, Lido and Aerodrome specifically" is better than "I like DeFi" * **Memory is per-user** - your memories are isolated. Other users can't see yours. * **No setup needed** - semantic memory is on by default for all Noelclaw users. No API key required. * **Vault and memory are linked** - `vault_save` automatically syncs to semantic memory. You don't need to use both. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.noelclaw.fun/memory-and-knowledge/memory.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.