Skip to content

swarmclawai/swarmrecall

Repository files navigation

SwarmRecall

Hosted persistence layer for AI agents — memory, knowledge, learnings, and skills as a service.

swarmrecall.ai

Discord: https://discord.gg/sbEavS8cPV

What is SwarmRecall?

SwarmRecall gives your AI agents long-term memory. Store memories with semantic search, build knowledge graphs connecting entities and concepts, extract learnings from repeated interactions, and maintain a registry of agent skills.

Install the SwarmRecall skill into your agent from ClawHub, and your agent auto-registers and starts persisting everything it learns. Claim the dashboard to monitor and manage your agents' memory from a web UI.

Features

  • Memory — Semantic vector search across everything your agent has stored, with automatic deduplication
  • Knowledge — Build a knowledge graph that connects entities, concepts, and relationships
  • Learnings — Auto-distill patterns from agent interactions into reusable insights
  • Skills — Registry of agent capabilities with versioning and sharing across your swarm
  • Pools — Shared memory pools that multiple agents can read from and write to
  • Dashboard — Web UI for monitoring, searching, and managing agent memory

Packages

Package Description Published
@swarmrecall/api Hono REST API server
@swarmrecall/web Next.js dashboard
@swarmrecall/shared Types, Zod schemas, constants npm
@swarmrecall/sdk TypeScript SDK npm
@swarmrecall/cli CLI tool npm

Quick Start

# Start infrastructure (Postgres, Meilisearch)
docker compose up -d

# Install dependencies
pnpm install

# Push database schema
pnpm db:push

# Start all dev servers
pnpm dev

Tech Stack

  • API: Hono + Node.js 22
  • Database: PostgreSQL 16 + pgvector (1536-dim embeddings, Drizzle ORM)
  • Search: Meilisearch v1.12
  • Cache: Upstash Redis REST (in-memory fallback for local dev)
  • Auth: Firebase Auth (dashboard), API keys (agents)
  • Frontend: Next.js 15 + Tailwind CSS + Radix UI
  • Build: Turborepo + pnpm workspaces

ClawHub Skill

Install the SwarmRecall skill for your OpenClaw agents:

clawhub install swarmrecall

Browse on ClawHub

SDK Usage

import { SwarmRecallClient } from '@swarmrecall/sdk';

const client = new SwarmRecallClient({
  apiKey: process.env.SWARMRECALL_API_KEY,
});

// Store a memory
await client.memories.create({
  content: 'The user prefers concise responses',
  type: 'observation',
});

// Semantic search
const results = await client.memories.search({
  query: 'user preferences',
  limit: 5,
});

Ecosystem

SwarmRecall is part of the Swarm ecosystem:

Platform Purpose
SwarmClaw Agent runtime and control plane
SwarmDock Agent marketplace
SwarmRecall Agent memory and knowledge
SwarmRelay Encrypted agent messaging
SwarmFeed Social network for agents

License

MIT

About

Hosted persistence layer for AI agents — memory, knowledge, learnings, and skills as a service.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors