← Back to Skills Marketplace

Swap Memory

Name: Swap Memory
Author: mikefaierberg-byte

by mikefaierberg-byte · GitHub ↗ · v3.3.0 · MIT-0

cross-platform ⚠ suspicious

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install swap-memory

Description

Automatically stores and retrieves conversation chunks for OpenClaw agents using a three-layer memory system without external dependencies.

README (SKILL.md)

Swap Memory Plugin

Auto-store conversations and retrieve context for OpenClaw agents.

Three-layer memory: hot (6h chunks) → warm (wiki session logs) → cold (wiki lessons).
No cron jobs, no external dependencies. Nothing is ever lost.

Installation

Add to openclaw.json:

{
  "plugins": {
    "entries": {
      "swap-memory": {
        "source": "workspace/plugins/swap-memory/src/index.js",
        "enabled": true,
        "config": {
          "enabled": true,
          "defaultAgent": "main",
          "crossSearchEnabled": false
        }
      }
    }
  }
}

Restart: openclaw gateway restart

Usage

The plugin works automatically — it hooks into agent_end and before_prompt_build to store and retrieve conversation chunks.

Commands

Slash	Description
`/swap-status`	Show statistics: chunks, pins, retrievals
`/swap-dashboard`	Visual progress bars per agent
`/swap-promote \x3Ckeyword>`	Pin matching chunks
`/swap-cross on\|off`	Toggle cross-agent search (OFF by default)

Adding tools to custom agents

If your agent has a tools.profile (e.g. coding, messaging), add to alsoAllow:

"alsoAllow": ["swap_status","swap_dashboard","swap_promote","swap_cross"]

Requirements

OpenClaw ≥ 2026.5
Memory core enabled (memory.enabled: true)
Wiki enabled (wiki.enabled: true)

Links

Usage Guidance

Review this skill carefully before installing. It is a coherent memory plugin, but only use it if you are comfortable with persistent local conversation memory, system-context reuse of prior chats, and possible OpenRouter provider calls using your API key. Keep cross-agent search off unless needed, avoid storing secrets, and look for or add deletion, retention, redaction, and no-network controls.

Capability Tags

cryptorequires-oauth-tokenrequires-sensitive-credentials

Capability Assessment

⚠ Purpose & Capability

The memory behavior is coherent with the stated purpose, but the artifacts also show automatic external LLM calls and high-priority system-context injection of remembered content, which are higher-impact than a simple local memory plugin.

⚠ Instruction Scope

Retrieved conversation chunks are intentionally injected via prependSystemContext and described as authoritative, which can make prior untrusted conversation text influence future agent behavior at system-prompt priority.

ℹ Install Mechanism

There is no install script or package install step; installation is by editing openclaw.json to load the local plugin file. The registry source is listed as unknown, but runnable code is provided in the artifacts.

⚠ Credentials

The plugin reads and writes under ~/.openclaw, auto-discovers agents, writes wiki/session archives, and uses provider API access; much of this is purpose-aligned, but the external and cross-agent data boundaries are not clearly bounded.

⚠ Persistence & Privilege

The plugin runs automatically on agent_end and before_prompt_build, keeps permanent session logs/wiki lessons, and exposes no clear delete or exclusion controls in the documented commands.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install swap-memory
After installation, invoke the skill by name or use /swap-memory
Provide required inputs per the skill's parameter spec and get structured output

Version History

v3.3.0

v3.3.0: Smart TTL, manual promotion, dashboard, cross-agent search toggle, multi-agent hook fix, public release

Metadata

Slug swap-memory

Version 3.3.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Swap Memory?

Automatically stores and retrieves conversation chunks for OpenClaw agents using a three-layer memory system without external dependencies. It is an AI Agent Skill for Claude Code / OpenClaw, with 19 downloads so far.

How do I install Swap Memory?

Run "/install swap-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Swap Memory free?

Yes, Swap Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Swap Memory support?

Swap Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Swap Memory?

It is built and maintained by mikefaierberg-byte (@mikefaierberg-byte); the current version is v3.3.0.

More Skills