# es-memory

Part of **ES**

# Elasticsearch Memory Management Console Guide

## Operations Overview

| Operation | Console Entry | Prerequisites | Description |
|----------|---------------|---------------|-------------|
| Retrieve Agentic Memory API Credentials | AI Search Open Platform Console > Intelligent Q&A > API Key Management | AI Search Open Platform console access, Workspace ID and API key from console, OpenClaw installed with Node.js 18 or later, Basic understanding of OpenClaw Gateway and plugins | Obtain the base URL and API key required to connect OpenClaw to the Agentic Memory service |

## Operation Steps

### Retrieve Agentic Memory API Credentials

**Navigation**: AI Search Open Platform Console > Intelligent Q&A > API Key Management

**Prerequisites**:
- AI Search Open Platform console access
- Workspace ID and API key from console
- OpenClaw installed with Node.js 18 or later
- Basic understanding of OpenClaw Gateway and plugins

1. Log in to the AI Search Open Platform console  
   - Element: **Log in** (link) — top-right corner  
   - Notes: Ensure you are using an account with permissions to access API Key Management.

2. Navigate to the API Key Management section  
   - Element: **Intelligent Q&A > API Key Management** (menu) — left navigation pane  
   - Notes: The page may take a few seconds to load after selection.

3. Locate and copy the API service address (baseUrl)  
   - Element: **API service address (baseUrl)** (text_input) — API Key Management page  
   - Notes: The workspace ID is embedded in the base URL format: `http://<workspace-id>.platform-cn-shanghai.opensearch.aliyuncs.com`. This value is required for OpenClaw configuration.

| Parameter | Type | Required | Options/Values | Description |
|-----------|------|----------|----------------|-------------|
| baseUrl | text | Yes | — | The base URL for the Agentic Memory API, obtained from the AI Search Open Platform console. |
| workspaceName | text | Yes | — | The name of the workspace. |
| apiKey | text | Yes | — | The API key used for API authentication. |
| serviceId | text | No | — | The service ID of the memory service. Default: `agentic-memory`. |
| userId | text | No | — | The user ID, used to distinguish memories between different users. Default: UUID generated automatically if not set. |
| agentId | text | No | — | The agent ID, used to associate memories and skills with a specific agent. |
| autoRecallMemory | checkbox | No | true, false | Specifies whether to automatically recall relevant memories before agent execution. Default: `false`. |
| autoCaptureMemory | checkbox | No | true, false | Specifies whether to automatically capture conversations and store them as memories after agent execution. Default: `false`. |
| autoRecallSkill | checkbox | No | true, false | Specifies whether to also retrieve skills during Auto-Recall. Default: `false`. |
| autoCaptureSkill | checkbox | No | true, false | Specifies whether to automatically capture skills from conversations (coming soon). Default: `false`. |
| recallLimit | number_input | No | — | The maximum number of memories to retrieve per Auto-Recall. Default: `5`. |

## FAQ

Q: Where can I find the Agentic Memory API credentials in the console?  
A: After logging into the AI Search Open Platform console, go to **Intelligent Q&A > API Key Management** in the left navigation pane. The **API service address (baseUrl)** and **apiKey** are displayed on this page.

Q: What happens if I leave `userId` blank in the configuration?  
A: If `userId` is not provided, a UUID will be generated automatically to uniquely identify the user’s memory context.

Q: Can I modify memory settings like `autoRecallMemory` after initial setup?  
A: Yes, these settings are part of the OpenClaw plugin configuration and can be updated at any time by modifying the initialization parameters in your code.

Q: Do I need special permissions to access the API Key Management page?  
A: Yes, your account must have appropriate permissions in the AI Search Open Platform to view and manage API keys and service endpoints.

Q: Is the `serviceId` field mandatory?  
A: No, it is optional. If omitted, it defaults to `agentic-memory`, which is the standard service ID for the Agentic Memory API.

## Pricing & Billing

### Billing Model
Billing is based on **per request**, with asynchronous tasks billed upon completion. The minimum billing unit for asynchronous tasks is 1 hour.

### Price Reference

| Tier | Input Price | Output Price | Other Price |
|------|-------------|--------------|-------------|
| Agentic Memory API | 0.002 / | 0.002 / | — |

### Free Tier

### Billing Notes
- Asynchronous storage tasks are billed when completed.
- Minimum billing duration for asynchronous tasks is 1 hour.
- Each request is counted toward usage, regardless of success or failure.