OpenClaw Alchemyst Integration

Perfect memory and context recall for OpenClaw agents.

Features

• Auto-Recall: Automatically inject relevant context before AI turns
• Auto-Capture: Store conversations automatically after AI responses
• AI Tools: 5 tools for manual memory management
• Slash Commands: /remember and /recall for users
• CLI Commands: Search and manage memories from terminal

Installation

Step 1: Add your API keys

Add your keys to ~/.openclaw/.env (OpenClaw loads this file automatically):

nano ~/.openclaw/.env

# Required - Alchemyst AI API key
ALCHEMYST_API_KEY=your_alchemyst_api_key_here

# Add whichever model provider you use with OpenClaw
OPENAI_API_KEY=your_openai_api_key_here
# GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key_here
# ANTHROPIC_API_KEY=your_anthropic_api_key_here

Get your Alchemyst API key at app.alchemyst.ai → API Keys. Only ALCHEMYST_API_KEY is required by the plugin. Add whichever model provider key matches your OpenClaw setup.

Step 2: Install the plugin

Copy the plugin into OpenClaw's extensions folder:

cp -r /path/to/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory

Replace /path/to/openclaw-alchemyst with where you downloaded the plugin. For example:

# Cloned to Desktop:
cp -r ~/Desktop/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory

# Downloaded to Downloads:
cp -r ~/Downloads/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory

The destination folder must be named alchemyst-memory for OpenClaw to detect it correctly.

Step 3: Enable the plugin in ~/.openclaw/openclaw.json

Add the following under the plugins section. Do not add a config block — OpenClaw's schema will reject it:

{
  "plugins": {
    "slots": {
      "memory": "alchemyst-memory"
    },
    "entries": {
      "alchemyst-memory": {
        "enabled": true
      }
    }
  }
}

Step 4: Verify

openclaw plugins list

You should see alchemyst-memory with status loaded and the following log output:

[Alchemyst] Client initialized
[Alchemyst] Registered 5 tools
[Alchemyst] Registered auto-recall hook (before_agent_start)
[Alchemyst] Registered auto-capture hook (agent_end)
[Alchemyst] Registered slash commands: /remember, /recall
[Alchemyst] Registered CLI commands: search, profile, wipe
[Alchemyst] Plugin registered successfully ✓

How It Works

• Before each AI turn: The recall hook searches Alchemyst for relevant past context and prepends it to the prompt automatically.
• After each AI turn: The capture hook stores the user and assistant messages in Alchemyst memory under the session openclaw-default.

Note: OpenClaw's agent_end event does not expose a session ID, so all captures are grouped under openclaw-default by default.

Configuration

All configuration is optional — the defaults work out of the box.

| Option | Type | Default | Description | |--------|------|---------|-------------| | ALCHEMYST_API_KEY | env var | required | Your Alchemyst AI API key | | Model provider key | env var | required | API key for your chosen model provider (OpenAI, Gemini, Anthropic, etc.) | | withMemory | boolean | true | Enable automatic memory recall | | similarityThreshold | number | 0.7 | Threshold for context retrieval | | minimumSimilarityThreshold | number | 0.5 | Fallback similarity threshold | | maxMemories | number | 10 | Max memories injected per turn | | contextType | string | conversation | Type of context: resource, conversation, or instruction | | scope | string | internal | Scope of storage: internal or external | | debug | boolean | false | Enable debug logging |

Commands

| Command | Description | |---------|-------------| | /remember <text> | Manually store something in memory | | /recall <query> | Search your stored memories | | openclaw alchemyst-search <query> | CLI memory search | | openclaw alchemyst-profile | View memory configuration | | openclaw alchemyst-wipe | Delete all stored memories |

Troubleshooting

Plugin shows error status

• Make sure ALCHEMYST_API_KEY is set in ~/.openclaw/.env
• Run openclaw gateway stop && openclaw gateway start to reload

Invalid config error in openclaw.json

• Remove any config block from the alchemyst-memory entry — OpenClaw does not allow additional properties in the plugin config schema

Capture skipping with "No sessionId"

• This is handled automatically — conversations are captured under openclaw-default

License

MIT © 2025 Alchemyst AI