{"_id":"@alchemystai/openclaw-plugin","name":"@alchemystai/openclaw-plugin","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@alchemystai/openclaw-plugin","version":"1.0.0","description":"Alchemyst AI context and memory integration for OpenClaw","main":"index.ts","type":"module","scripts":{"build":"rm -rf dist && bun build ./index.ts --outdir ./dist --target node"},"dependencies":{"@ai-sdk/anthropic":"^3.0.45","@ai-sdk/openai":"^3.0.29","@alchemystai/aisdk":"^0.0.4","@alchemystai/sdk":"^0.11.1","ai":"^6.0.90","dotenv":"^17.3.1","zod-to-json-schema":"^3.25.1"},"openclaw":{"extensions":[{"id":"openclaw-alchemyst","name":"OpenClaw Alchemyst","description":"AI-powered context and memory management with document storage and retrieval","version":"1.0.0","configSchema":{"type":"object","properties":{"apiKey":{"type":"string","description":"Alchemyst API key (or set ALCHEMYST_API_KEY env var)","default":""},"baseUrl":{"type":"string","description":"Alchemyst API base URL","default":"https://api.alchemyst.ai"}}}}]},"devDependencies":{"@types/bun":"^1.3.9","@types/node":"^25.2.3"},"gitHead":"09e90641950faad329fa78bee8eb4a3acffec417","_id":"@alchemystai/openclaw-plugin@1.0.0","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-E+i6c6mHvI6aN5g9B+WCFjjmttV0IhJ4cxCWGotsZff2w5Ye8NjY5yU26aKbJvF9klhb6Sl1MD4/3PTK9EVSFg==","shasum":"226804f61733e37a255f2d25a9329730a4c6b4df","tarball":"https://registry.npmjs.org/@alchemystai/openclaw-plugin/-/openclaw-plugin-1.0.0.tgz","fileCount":17,"unpackedSize":40724,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD7SeWgvgNYk+oZ6TOwlYSnftVbG7RGjf7TYVJf3IEnSwIhAIpRmlxz2aVVBbbyKNXDS5KdQZUJX3S7HLp+0Kjl0N9W"}]},"_npmUser":{"name":"anuran-roy","email":"anuranroy02@gmail.com"},"directories":{},"maintainers":[{"name":"anuran-roy","email":"anuranroy02@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/openclaw-plugin_1.0.0_1771508027811_0.6639030622196902"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-19T13:33:47.740Z","1.0.0":"2026-02-19T13:33:47.965Z","modified":"2026-02-19T13:33:48.141Z"},"maintainers":[{"name":"anuran-roy","email":"anuranroy02@gmail.com"}],"description":"Alchemyst AI context and memory integration for OpenClaw","readme":"# OpenClaw Alchemyst Integration\n\nPerfect memory and context recall for OpenClaw agents.\n\n## Features\n\n- **Auto-Recall**: Automatically inject relevant context before AI turns\n- **Auto-Capture**: Store conversations automatically after AI responses\n- **AI Tools**: 5 tools for manual memory management\n- **Slash Commands**: `/remember` and `/recall` for users\n- **CLI Commands**: Search and manage memories from terminal\n\n## Installation\n\n### Step 1: Add your API keys\n\nAdd your keys to `~/.openclaw/.env` (OpenClaw loads this file automatically):\n\n```bash\nnano ~/.openclaw/.env\n```\n\n```env\n# Required - Alchemyst AI API key\nALCHEMYST_API_KEY=your_alchemyst_api_key_here\n\n# Add whichever model provider you use with OpenClaw\nOPENAI_API_KEY=your_openai_api_key_here\n# GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key_here\n# ANTHROPIC_API_KEY=your_anthropic_api_key_here\n```\n\n> Get your Alchemyst API key at [app.alchemyst.ai](https://app.alchemyst.ai) → API Keys.\n> Only `ALCHEMYST_API_KEY` is required by the plugin. Add whichever model provider key matches your OpenClaw setup.\n\n### Step 2: Install the plugin\n\nCopy the plugin into OpenClaw's extensions folder:\n\n```bash\ncp -r /path/to/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory\n```\n\nReplace `/path/to/openclaw-alchemyst` with where you downloaded the plugin. For example:\n\n```bash\n# Cloned to Desktop:\ncp -r ~/Desktop/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory\n\n# Downloaded to Downloads:\ncp -r ~/Downloads/openclaw-alchemyst ~/.openclaw/extensions/alchemyst-memory\n```\n\n> The destination folder must be named `alchemyst-memory` for OpenClaw to detect it correctly.\n\n### Step 3: Enable the plugin in `~/.openclaw/openclaw.json`\n\nAdd the following under the `plugins` section. **Do not add a `config` block** — OpenClaw's schema will reject it:\n\n```json\n{\n  \"plugins\": {\n    \"slots\": {\n      \"memory\": \"alchemyst-memory\"\n    },\n    \"entries\": {\n      \"alchemyst-memory\": {\n        \"enabled\": true\n      }\n    }\n  }\n}\n```\n\n### Step 4: Verify\n\n```bash\nopenclaw plugins list\n```\n\nYou should see `alchemyst-memory` with status `loaded` and the following log output:\n\n```\n[Alchemyst] Client initialized\n[Alchemyst] Registered 5 tools\n[Alchemyst] Registered auto-recall hook (before_agent_start)\n[Alchemyst] Registered auto-capture hook (agent_end)\n[Alchemyst] Registered slash commands: /remember, /recall\n[Alchemyst] Registered CLI commands: search, profile, wipe\n[Alchemyst] Plugin registered successfully ✓\n```\n\n## How It Works\n\n- **Before each AI turn**: The recall hook searches Alchemyst for relevant past context and prepends it to the prompt automatically.\n- **After each AI turn**: The capture hook stores the user and assistant messages in Alchemyst memory under the session `openclaw-default`.\n\n> Note: OpenClaw's `agent_end` event does not expose a session ID, so all captures are grouped under `openclaw-default` by default.\n\n## Configuration\n\nAll configuration is optional — the defaults work out of the box.\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `ALCHEMYST_API_KEY` | env var | **required** | Your Alchemyst AI API key |\n| Model provider key | env var | **required** | API key for your chosen model provider (OpenAI, Gemini, Anthropic, etc.) |\n| `withMemory` | boolean | `true` | Enable automatic memory recall |\n| `similarityThreshold` | number | `0.7` | Threshold for context retrieval |\n| `minimumSimilarityThreshold` | number | `0.5` | Fallback similarity threshold |\n| `maxMemories` | number | `10` | Max memories injected per turn |\n| `contextType` | string | `conversation` | Type of context: `resource`, `conversation`, or `instruction` |\n| `scope` | string | `internal` | Scope of storage: `internal` or `external` |\n| `debug` | boolean | `false` | Enable debug logging |\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/remember <text>` | Manually store something in memory |\n| `/recall <query>` | Search your stored memories |\n| `openclaw alchemyst-search <query>` | CLI memory search |\n| `openclaw alchemyst-profile` | View memory configuration |\n| `openclaw alchemyst-wipe` | Delete all stored memories |\n\n## Troubleshooting\n\n**Plugin shows `error` status**\n- Make sure `ALCHEMYST_API_KEY` is set in `~/.openclaw/.env`\n- Run `openclaw gateway stop && openclaw gateway start` to reload\n\n**`Invalid config` error in openclaw.json**\n- Remove any `config` block from the `alchemyst-memory` entry — OpenClaw does not allow additional properties in the plugin config schema\n\n**Capture skipping with \"No sessionId\"**\n- This is handled automatically — conversations are captured under `openclaw-default`\n\n## License\n\nMIT © 2025 Alchemyst AI","readmeFilename":"README.md","_rev":"1-8e6e5a684934b953a0941fc8c7b5c0b5"}