← 返回 Skills 市场
ramsbaby

MemoryBox

作者 Ramsbaby · GitHub ↗ · v2.0.0
cross-platform ⚠ suspicious
1900
总下载
1
收藏
11
当前安装
1
版本数
在 OpenClaw 中安装
/install openclaw-memorybox
功能描述
Zero-dependency memory maintenance CLI for OpenClaw. Keeps MEMORY.md lean with 3-tier hierarchical organization. Works alongside Mem0, Supermemory, QMD — or standalone. Install once, forget about memory management.
使用说明 (SKILL.md)

MemoryBox

Zero-dependency memory maintenance tool for OpenClaw agents.

What It Does

Prevents MEMORY.md bloat by organizing memory into 3 tiers:

  • Tier 1: MEMORY.md (≤10KB, loaded every session)
  • Tier 2: memory/domains/*.md (searched on-demand)
  • Tier 3: memory/archive/ (old daily logs)

Works alongside Mem0, Supermemory, QMD, or standalone. Only touches file structure — never configs or plugins.

Install

git clone https://github.com/Ramsbaby/openclaw-memorybox.git
cd openclaw-memorybox && chmod +x bin/memorybox
sudo ln -sf "$(pwd)/bin/memorybox" /usr/local/bin/memorybox

Usage

memorybox doctor ~/openclaw    # Full diagnostic (start here)
memorybox split ~/openclaw     # Interactive: move bloated sections to domain files
memorybox health ~/openclaw    # Quick health score (0-100)
memorybox archive ~/openclaw   # Archive old daily logs (14+ days)
memorybox dedupe ~/openclaw    # Find duplicate content
memorybox stale ~/openclaw     # Detect outdated content
memorybox analyze ~/openclaw   # Section-by-section size breakdown
memorybox suggest ~/openclaw   # Improvement recommendations
memorybox report ~/openclaw    # Before/after token savings
memorybox init ~/openclaw      # Set up 3-tier directory structure

Teach Your Agent

Add to AGENTS.md:

## Memory Protocol
- **MEMORY.md** (≤10KB): Core facts only. Loaded everywhere — keep it lean.
- **memory/domains/*.md**: Detailed reference. Use `memory_search` to find.
- **memory/archive/**: Old logs. Rarely needed.

Results

Tested on production (7 Discord channels, 48 crons):

  • MEMORY.md: 20KB → 3.5KB (-83%)
  • Context pressure: 98% → 7%
  • Setup time: 5 minutes

Links

安全使用建议
This skill is 'suspicious' because the documentation asks you to clone and install an unpinned GitHub repo as a system binary and edit AGENTS.md — actions that require sudo and change agent config despite the claim it won't touch configs. Before installing: (1) Inspect the GitHub repository contents (preferably the source of bin/memorybox); ask for a specific commit hash or a signed release rather than cloning the repo head. (2) Avoid running the sudo ln -sf step until you trust the binary; consider installing locally (~/bin) or running the script in a sandbox/container. (3) Verify the maintainer identity and license, and search for issues or community feedback. (4) If you want to use the skill without installation, you can implement the file-organization steps yourself or request the maintainer provide a non-executable, auditable script. If you cannot review the code or don't trust the upstream, do not run the install commands with sudo.
功能分析
Type: OpenClaw Skill Name: openclaw-memorybox Version: 2.0.0 The skill bundle describes a memory management utility for OpenClaw agents. The `SKILL.md` outlines standard installation steps involving `git clone` and creating a symbolic link with `sudo ln -sf` for global access, which is common for CLI tools. The instructions provided for the agent in the 'Teach Your Agent' section are directly related to memory organization and do not contain any prompt injection attempts to subvert the agent's behavior or perform malicious actions. There is no evidence of data exfiltration, malicious execution beyond standard installation, persistence mechanisms, or obfuscation.
能力评估
Purpose & Capability
The description promises a zero-dependency, file-only memory organizer. However, the SKILL.md provides an installation flow that clones a remote repository and installs a binary into /usr/local/bin (requires sudo). The registry metadata lists no homepage/source while SKILL.md points to a GitHub repo — an inconsistency. Needing system-wide install privileges is not obviously necessary for a purely file-organizing helper.
Instruction Scope
Instructions tell the agent/user to run shell commands that fetch code (git clone) and create a system symlink with sudo. The doc also tells users to add entries to AGENTS.md (agent config)—contradicting the claim 'never configs or plugins.' The runtime instructions therefore expand scope to network download, code execution, and config modification.
Install Mechanism
There is no formal install spec in the registry, but SKILL.md instructs cloning a GitHub repo and making a binary executable and a system symlink. This is effectively a download-and-install from an unpinned repository (no commit hash or release tag). Downloading and installing an executable from an arbitrary GitHub repo without verification is a moderate-to-high supply-chain risk.
Credentials
The skill declares no environment variables or credentials, which is proportionate. However, the install instructions require sudo to write to /usr/local/bin and ask to edit AGENTS.md — elevated privileges and modification of agent config are not declared and are disproportionate for a tool that claims only to rearrange files.
Persistence & Privilege
Although always:false and agent invocation defaults are normal, the instructions install a persistent system binary (writes to /usr/local/bin) and recommend modifying AGENTS.md. That grants lasting system presence and the ability to run code later; persistence is achieved by the user-install step rather than by metadata, so it should be considered a privilege escalation compared to an instruction-only skill.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openclaw-memorybox
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openclaw-memorybox 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
v2.0.0: Repositioned as lightweight maintenance tool. 10 CLI commands, 5-step doctor, dedupe false positive reduction.
元数据
Slug openclaw-memorybox
版本 2.0.0
许可证
累计安装 11
当前安装数 11
历史版本数 1
常见问题

MemoryBox 是什么?

Zero-dependency memory maintenance CLI for OpenClaw. Keeps MEMORY.md lean with 3-tier hierarchical organization. Works alongside Mem0, Supermemory, QMD — or standalone. Install once, forget about memory management. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1900 次。

如何安装 MemoryBox?

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

MemoryBox 是免费的吗?

是的,MemoryBox 完全免费(开源免费),可自由下载、安装和使用。

MemoryBox 支持哪些平台?

MemoryBox 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 MemoryBox?

由 Ramsbaby(@ramsbaby)开发并维护,当前版本 v2.0.0。

💬 留言讨论