llms.txt@docs git:20260805.9fb1c92A

Immutable. This exact content is served forever at /api/v1/blob/d391a51e83be298b.

# MemWal

> MemWal is a privacy-first AI memory layer. It stores encrypted memories on Walrus (decentralized storage) and retrieves them with semantic search. Ownership is enforced onchain via Sui smart contracts. The TypeScript SDK (`@mysten-incubation/memwal`) gives any app persistent, encrypted memory in a few lines of code.

Important notes:

- The SDK talks to a relayer service that handles embedding, SEAL encryption, Walrus upload/download, and vector search
- All content is end-to-end encrypted — only the owner and authorized delegates can decrypt
- Delegate keys provide scoped access — agents can read/write memory without holding the owner's private key
- Memory is scoped by `owner + namespace` — each namespace is an isolated memory space

## Docs

- [What is MemWal?](https://docs.wal.app/walrus-memory/getting-started/what-is-memwal): Overview of features, architecture, and use cases
- [Quick Start](https://docs.wal.app/walrus-memory/getting-started/quick-start): Install the SDK, generate credentials, store and recall your first memory
- [Choose Your Path](https://docs.wal.app/walrus-memory/getting-started/choose-your-path): Pick the right integration path (MemWal, MemWalManual, or withMemWal AI middleware)

## SDK

- [SDK Quick Start](https://docs.wal.app/walrus-memory/sdk/quick-start): Install, configure, and store your first memory
- [MemWal Usage](https://docs.wal.app/walrus-memory/sdk/usage/memwal): Default relayer-handled client — remember, recall, analyze, restore
- [MemWalManual Usage](https://docs.wal.app/walrus-memory/sdk/usage/memwal-manual): Manual client — client-side embedding and SEAL encryption
- [withMemWal AI Middleware](https://docs.wal.app/walrus-memory/sdk/usage/with-memwal): Vercel AI SDK integration — automatic memory recall and save
- [SDK API Reference](https://docs.wal.app/walrus-memory/sdk/api-reference): Full method signatures, return types, and config fields

## Relayer

- [Relayer Overview](https://docs.wal.app/walrus-memory/relayer/overview): Architecture, trust boundary, key pool, single-instance design
- [Public Relayer](https://docs.wal.app/walrus-memory/relayer/public-relayer): Managed relayer endpoints provided by Walrus Foundation
- [Self-Hosting](https://docs.wal.app/walrus-memory/relayer/self-hosting): Run your own relayer with full control over encryption and embedding
- [Relayer API Reference](https://docs.wal.app/walrus-memory/relayer/api-reference): HTTP routes, authentication headers, request/response shapes

## Smart Contract

- [Contract Overview](https://docs.wal.app/walrus-memory/contract/overview): Onchain ownership model and package IDs
- [Delegate Key Management](https://docs.wal.app/walrus-memory/contract/delegate-key-management): Add, remove, and rotate delegate keys
- [Ownership & Permissions](https://docs.wal.app/walrus-memory/contract/ownership-and-permissions): Access control model

## OpenClaw Plugin

- [OpenClaw Overview](https://docs.wal.app/walrus-memory/openclaw/overview): NemoClaw/OpenClaw memory plugin overview
- [OpenClaw Quick Start](https://docs.wal.app/walrus-memory/openclaw/quick-start): Install and configure the plugin
- [How It Works](https://docs.wal.app/walrus-memory/openclaw/how-it-works): Architecture, hooks, and message flow
- [OpenClaw Reference](https://docs.wal.app/walrus-memory/openclaw/reference): Hooks, tools, CLI, and configuration

## Reference

- [Configuration](https://docs.wal.app/walrus-memory/reference/configuration): MemWalConfig, MemWalManualConfig, WithMemWalOptions
- [Environment Variables](https://docs.wal.app/walrus-memory/reference/environment-variables): Relayer env vars for self-hosting

## Optional

- [Concepts: Memory Space](https://docs.wal.app/walrus-memory/fundamentals/concepts/memory-space): Namespace isolation and memory boundaries
- [Architecture: Core Components](https://docs.wal.app/walrus-memory/fundamentals/architecture/core-components): System overview and component responsibilities
- [Data Flow & Security Model](https://docs.wal.app/walrus-memory/fundamentals/architecture/data-flow-security-model): Trust boundaries and encryption flows
- [Contributing: Run Repo Locally](https://docs.wal.app/walrus-memory/contributing/run-repo-locally): Monorepo setup for contributors
- [Example Apps](https://docs.wal.app/walrus-memory/examples/example-apps): Playground, Chatbot, Noter, Researcher