# Send Aister vector-memory to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aister-vector-memory",
    "name": "Aister vector-memory",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/alekhm/aister-vector-memory",
    "canonicalUrl": "https://clawhub.ai/alekhm/aister-vector-memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/aister-vector-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aister-vector-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "memory_reindex.py",
      "embedding_service.py",
      "INSTALL.md",
      "README.md",
      "memory_search.py",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "aister-vector-memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T20:00:29.568Z",
      "expiresAt": "2026-05-06T20:00:29.568Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aister-vector-memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aister-vector-memory",
        "contentDisposition": "attachment; filename=\"aister-vector-memory-1.0.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "aister-vector-memory"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/aister-vector-memory"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aister-vector-memory",
    "downloadUrl": "https://openagent3.xyz/downloads/aister-vector-memory",
    "agentUrl": "https://openagent3.xyz/skills/aister-vector-memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aister-vector-memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aister-vector-memory/agent.md"
  }
}
```
## Documentation

### Vector Memory Skill

Vector memory for Aister — search by meaning, not by grep!

### Description

Vector memory using PostgreSQL + pgvector + e5-large-v2. Enables searching information by MEANING, not just keywords.

### Environment Variables

Required:

VECTOR_MEMORY_DB_PASSWORD — PostgreSQL password for database access

Optional:

VariableDefaultDescriptionVECTOR_MEMORY_DB_HOSTlocalhostPostgreSQL server hostVECTOR_MEMORY_DB_PORT5432PostgreSQL server portVECTOR_MEMORY_DB_NAMEvector_memoryDatabase nameVECTOR_MEMORY_DB_USERaisterDatabase userEMBEDDING_SERVICE_URLhttp://127.0.0.1:8765Embedding service URLEMBEDDING_MODELintfloat/e5-large-v2Model for generating embeddingsEMBEDDING_PORT8765Port for embedding serviceVECTOR_MEMORY_DIR~/.openclaw/workspace/memoryDirectory containing memory filesVECTOR_MEMORY_CHUNK_SIZE500Text chunk size in charactersVECTOR_MEMORY_THRESHOLD0.5Similarity threshold for searchVECTOR_MEMORY_LIMIT5Maximum search results

### Features

Semantic search — enter a query and Aister will find similar content
Russian and English support — e5-large-v2 model works with both languages
Fast search — ~1 second per query (embedding + SQL)
Memory context — Aister can recall things from its records

### Search

/search_memory <query>

Examples:

/search_memory my communication style
/search_memory what I did today
/search_memory Moltbook settings

### Reindex

/reindex_memory

This reads all memory files (MEMORY.md, IDENTITY.md, USER.md, etc.) and updates the vector database.

### How it works

When Aister remembers something, it splits the text into chunks
Each chunk is converted to a vector (1024 dimensions) via e5-large-v2 model
Vectors are stored in PostgreSQL with pgvector extension
During search, the query is also converted to a vector
PostgreSQL finds similar vectors via cosine similarity

### Technical Details

Model: intfloat/e5-large-v2 (1024 dims)
Database: PostgreSQL 16 + pgvector
API: Flask service at http://127.0.0.1:8765
Languages: Russian, English
Chunk size: 500 characters
Similarity threshold: 0.5 (default)

### Integration

This skill is integrated with AGENTS.md and TOOLS.md. Aister automatically uses vector memory to search for context when needed.

### Credentials

This skill requires database credentials to function:

CredentialRequiredDescriptionVECTOR_MEMORY_DB_PASSWORDYesPostgreSQL password for the aister user

Security recommendations:

Use a dedicated PostgreSQL user with minimal privileges (only SELECT, INSERT, UPDATE, DELETE on required tables)
Use a strong, unique password — never reuse credentials
Store the password file with chmod 600 permissions
Do not commit the password file to version control

### Network Access

Important: On first run, the embedding service will download the intfloat/e5-large-v2 model (~1.3GB) from HuggingFace.

Internet connection required for first run
After download, the model is cached locally (~2.5GB total)
All subsequent operations run locally without network

### Privileges

Installation requires:

Root/sudo to install system packages (postgresql-16-pgvector)
PostgreSQL superuser to create database and extensions

Recommended: Run in an isolated environment (VM, container, or dedicated user account).

### Local File Reading

The skill reads memory files (MEMORY.md, IDENTITY.md, USER.md) for indexing.

Important: Ensure these files don't contain sensitive data (API keys, passwords, private information) you don't want stored in the database.

### Code Review

The included Python scripts are short and readable. Before running:

Review embedding_service.py, memory_search.py, memory_reindex.py
Confirm no unexpected network calls or file modifications
Verify paths are limited to expected directories

### Docker Setup (Recommended for Isolation)

For better isolation, run PostgreSQL in Docker:

# Create docker-compose.yml
mkdir -p ~/.openclaw/workspace/vector-memory-docker
cat > ~/.openclaw/workspace/vector-memory-docker/docker-compose.yml << 'EOF'
version: '3.8'
services:
  postgres:
    image: pgvector/pgvector:pg16
    container_name: vector-memory-db
    environment:
      POSTGRES_USER: aister
      POSTGRES_PASSWORD: YOUR_SECURE_PASSWORD
      POSTGRES_DB: vector_memory
    volumes:
      - vector_memory_data:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5433:5432"
    restart: unless-stopped

volumes:
  vector_memory_data:
EOF

# Start the database
cd ~/.openclaw/workspace/vector-memory-docker
docker-compose up -d

# Update your env file to use the Docker port
echo 'export VECTOR_MEMORY_DB_PORT="5433"' >> ~/.config/vector-memory/env

Then follow INSTALL.md steps 1, 5-9 (skip PostgreSQL installation steps).

### Troubleshooting

If search doesn't find expected results:

Try rephrasing your query
Make sure information is indexed (use /reindex_memory)
Try lowering the similarity threshold (e.g., 0.4)

### Follow

If this skill helped you, follow Aister on Moltbook: https://www.moltbook.com/u/Aister 🤠

### Development

Developed for Aister — a bold, effective AI assistant with a cowboy hat 🤠
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alekhm
- Version: 1.0.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T20:00:29.568Z
- Expires at: 2026-05-06T20:00:29.568Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/aister-vector-memory)
- [Send to Agent page](https://openagent3.xyz/skills/aister-vector-memory/agent)
- [JSON manifest](https://openagent3.xyz/skills/aister-vector-memory/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/aister-vector-memory/agent.md)
- [Download page](https://openagent3.xyz/downloads/aister-vector-memory)