mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-09-05 08:06:19 +00:00
efd6c133e6
Clawdbot docs Changes: - Added integrations/clawdbot.mdx — ClawdBot Supermemory Plugin documentation page with shrimp icon - Added "Plugins" group to the bottom of the Integrations sidebar in docs.json - Page covers: API key setup (zsh/bash/PowerShell), plugin install, how it works (auto-recall/auto-capture), features (AI tools, slash commands, CLI), manual configuration, and advanced options
122 lines
4 KiB
Text
122 lines
4 KiB
Text
---
|
|
title: "ClawdBot"
|
|
sidebarTitle: "ClawdBot"
|
|
description: "ClawdBot Supermemory Plugin — works across Telegram, WhatsApp, Discord, Slack, and more"
|
|
icon: "shrimp"
|
|
---
|
|
|
|
[ClawdBot](https://github.com/supermemoryai/clawdbot-supermemory) is a multi-platform AI messaging gateway that connects to WhatsApp, Telegram, Discord, Slack, iMessage, and other messaging channels. The Supermemory plugin gives ClawdBot memory across every channel.
|
|
|
|
## Get Your API Key
|
|
|
|
Create a Supermemory API key from the [API Keys](https://console.supermemory.ai/keys) page, then add it to your shell profile so it persists across sessions:
|
|
|
|
<Tabs>
|
|
<Tab title="macOS / Linux (zsh)">
|
|
```bash
|
|
echo 'export SUPERMEMORY_CLAWDBOT_API_KEY="sm_..."' >> ~/.zshrc
|
|
source ~/.zshrc
|
|
```
|
|
</Tab>
|
|
<Tab title="macOS / Linux (bash)">
|
|
```bash
|
|
echo 'export SUPERMEMORY_CLAWDBOT_API_KEY="sm_..."' >> ~/.bashrc
|
|
source ~/.bashrc
|
|
```
|
|
</Tab>
|
|
<Tab title="Windows (PowerShell)">
|
|
```powershell
|
|
[System.Environment]::SetEnvironmentVariable("SUPERMEMORY_CLAWDBOT_API_KEY", "sm_...", "User")
|
|
```
|
|
Restart your terminal after running this.
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## Install the Plugin
|
|
|
|
```bash
|
|
clawdbot plugins install @supermemory/clawdbot-supermemory
|
|
```
|
|
|
|
Restart ClawdBot after installing.
|
|
|
|
## How It Works
|
|
|
|
Once installed, the plugin runs automatically with zero interaction:
|
|
|
|
- **Auto-Recall** — Before every AI turn, Supermemory is queried for relevant memories and the user's profile. These are injected as context so the AI sees preferences, facts, and semantically similar past conversations.
|
|
- **Auto-Capture** — After every AI turn, the conversation exchange is sent to Supermemory for extraction and long-term storage. Supermemory handles deduplication and profile building.
|
|
|
|
## Features
|
|
|
|
### AI Tools
|
|
|
|
The AI can use these tools autonomously during conversations:
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `supermemory_store` | Save information to long-term memory. |
|
|
| `supermemory_search` | Search memories by query with similarity scores. |
|
|
| `supermemory_forget` | Delete a memory by query or ID. |
|
|
| `supermemory_profile` | View the user profile — persistent facts and recent context. |
|
|
|
|
### Slash Commands
|
|
|
|
Users can interact with memory directly in chat:
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `/remember [text]` | Manually save something to memory. |
|
|
| `/recall [query]` | Search memories and see results with similarity scores. |
|
|
|
|
### CLI Commands
|
|
|
|
```bash
|
|
clawdbot supermemory search <query> # Search memories from the terminal
|
|
clawdbot supermemory profile # View user profile
|
|
clawdbot supermemory wipe # Delete all memories (requires confirmation)
|
|
```
|
|
|
|
## Manual Configuration
|
|
|
|
Optional — only needed if you prefer to set the API key directly in the config file instead of the environment variable.
|
|
|
|
Add the plugin to your `clawdbot.json`:
|
|
|
|
```json5
|
|
{
|
|
"plugins": {
|
|
"entries": {
|
|
"clawdbot-supermemory": {
|
|
"enabled": true,
|
|
"config": {
|
|
"apiKey": "sm_..."
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Advanced Options
|
|
|
|
| Key | Type | Default | Description |
|
|
|-----|------|---------|-------------|
|
|
| `autoRecall` | `boolean` | `true` | Inject relevant memories before every AI turn. |
|
|
| `autoCapture` | `boolean` | `true` | Store conversation content after every turn. |
|
|
| `maxRecallResults` | `number` | `10` | Max memories injected into context per turn. |
|
|
| `profileFrequency` | `number` | `50` | Inject full user profile every N turns. |
|
|
| `captureMode` | `string` | `"all"` | `"all"` filters noise. `"everything"` captures all messages. |
|
|
| `debug` | `boolean` | `false` | Verbose debug logs. |
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="GitHub Repository" icon="github" href="https://github.com/supermemoryai/clawdbot-supermemory">
|
|
Source code, issues, and detailed README.
|
|
</Card>
|
|
|
|
<Card title="Claude Memory Tool" icon="brain" href="/integrations/claude-memory">
|
|
Use Claude's native memory tool with Supermemory as backend.
|
|
</Card>
|
|
</CardGroup>
|