← 返回 Skills 市场

Swap Memory

Name: Swap Memory
Author: mikefaierberg-byte

作者 mikefaierberg-byte · GitHub ↗ · v3.3.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install swap-memory

功能描述

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

使用说明 (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

安全使用建议

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.

能力标签

cryptorequires-oauth-tokenrequires-sensitive-credentials

能力评估

⚠ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install swap-memory
安装完成后，直接呼叫该 Skill 的名称或使用 /swap-memory 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v3.3.0

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

元数据

Slug swap-memory

版本 3.3.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Swap Memory 是什么？

Automatically stores and retrieves conversation chunks for OpenClaw agents using a three-layer memory system without external dependencies. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 19 次。

如何安装 Swap Memory？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install swap-memory」即可一键安装，无需额外配置。

Swap Memory 是免费的吗？

是的，Swap Memory 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Swap Memory 支持哪些平台？

Swap Memory 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Swap Memory？

由 mikefaierberg-byte（@mikefaierberg-byte）开发并维护，当前版本 v3.3.0。