> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memoclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install → init → store → recall in under 2 minutes.

<Tip>
  **Using OpenClaw?** Skip the manual setup — install the [memoclaw-hooks](/openclaw-hooks) package and your agent gets persistent memory automatically. Three commands, zero code.
</Tip>

## Get started in 4 steps

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    npm install -g memoclaw
    ```
  </Step>

  <Step title="Initialize your wallet">
    ```bash theme={null}
    memoclaw init
    ```

    This generates a new wallet, saves your config to `~/.memoclaw/config.json`, and gives you **100 free API calls**. No accounts, no API keys.

    ```
    ✔ Generated new wallet: 0x1a2B...9cDe
    ✔ Saved config to ~/.memoclaw/config.json
    ✔ Free tier: 100 calls remaining

    You're ready to go! Try: memoclaw store "Hello, MemoClaw"
    ```

    <Tip>
      Already have a wallet? Pass it directly:

      ```bash theme={null}
      memoclaw init --private-key 0xYourExistingKey
      ```
    </Tip>
  </Step>

  <Step title="Store a memory">
    ```bash theme={null}
    memoclaw store "User prefers dark mode and vim keybindings"
    ```

    ```json theme={null}
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "stored": true,
      "tokens_used": 8
    }
    ```
  </Step>

  <Step title="Recall it">
    ```bash theme={null}
    memoclaw recall "What are the user's editor preferences?"
    ```

    ```
    [0.847] User prefers dark mode and vim keybindings
      tags: preferences, editor
    ```
  </Step>
</Steps>

**That's it.** Your agent now has persistent memory.

***

## Using namespaces

Namespaces isolate memories per project:

```bash theme={null}
memoclaw store "Uses PostgreSQL 15 with pgvector" --namespace acme-api
memoclaw recall "database setup" --namespace acme-api
```

## CLI reference

```bash theme={null}
memoclaw store "content" --importance 0.9 --tags tag1,tag2 --namespace project-x
memoclaw recall "query" --limit 10 --min-similarity 0.7 --namespace project-x
memoclaw list --limit 20 --namespace project-x
memoclaw delete <memory-id>
memoclaw migrate ~/path/to/memory/files   # Import OpenClaw files
```

## Pricing

Endpoints using OpenAI are charged per request (USDC on Base). Every wallet gets **100 free API calls** — no payment required. After that, you pay per request. List, get, delete, search, and stats endpoints are always free.

| Operation               | Cost    |
| ----------------------- | ------- |
| Store                   | \$0.005 |
| Store Batch (up to 100) | \$0.04  |
| Recall                  | \$0.005 |
| List                    | FREE    |
| Migrate                 | \$0.01  |

See [full pricing](/reference/pricing) for all endpoints.

## Next steps

<CardGroup cols={2}>
  <Card title="OpenClaw Hooks" icon="plug" href="/openclaw-hooks">
    Automatic memory for OpenClaw agents. Install, restart, done.
  </Card>

  <Card title="Migration Guide" icon="truck" href="/guides/migrate-from-openclaw">
    Moving from OpenClaw? Import your memory files in one command.
  </Card>

  <Card title="MCP Integration" icon="server" href="/mcp-integration">
    Use MemoClaw as an MCP server for any compatible client.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore all available endpoints.
  </Card>
</CardGroup>