← Back to Skills Marketplace
153
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install dream-memory
Description
完整的工作区记忆管理系统。四层架构：文件存储 + OpenViking 向量引擎 + Ollama bge-m3 + Agent 规则。 Use when: 用户询问记忆系统如何工作、如何安装记忆系统到新 Agent、记忆文件结构、向量检索原理、 Session Flush 机制、长期记忆晋升规则、OpenVik...
README (SKILL.md)
Dream Memory — Agent 记忆管理系统
架构总览四层
第 1 层: Agent 规则 (AGENTS.md) — 何时写、写哪、怎么写
第 2 层: 文件存储 (Markdown) — MEMORY.md + memory/ + WEEKLY-PROGRESS.md
第 3 层: 向量检索 (OpenViking) — memory/ 目录的向量化索引
第 4 层: 会话生命周期 — sessions.json 追踪 + Session Start Check
文件结构（工作区根目录）
workspace/
├── AGENTS.md # 操作规则（记忆写入逻辑在此）
├── MEMORY.md # 长期记忆索引（\x3C 200 行, \x3C 25KB）
├── SOUL.md # Agent 人格
├── USER.md # 用户画像
├── WEEKLY-PROGRESS.md # 本周进度表
├── memory/
│ ├── YYYY-MM-DD.md # 每日日志（Append only）
│ ├── topics/ # 专题详情
│ ├── archive/ # 压缩归档
│ └── .data/ # OpenViking 数据
└── .consolidate-lock # 蒸馏检查锁
实时记录规则
何时写： 用户纠正/偏好/目标/"记住"/报告完成/外部指针
格式： - HH:MM 类型：内容
规则： Append only，不修改历史行，跨日自动切换文件
Session End Flush 🔥
触发：用户说"下班/再见"、>30 min 未写、心跳 >8h 未写、跨日切换
检查清单：重要决定 / 新知识 / 错误 / 待办 / MEMORY.md 超 4KB
输出格式：## [日期] - 主题 (标签) 每条 1-2 行
Session Start Check 🔍
每次新会话启动时：
- 读取
~/.openclaw/agents/{agent-id}/sessions/sessions.json - 找上一个用户会话的
endedAt - 对比当天日志最后修改时间
- 日志时间 \x3C endedAt → ❌ 补写
补写格式：`## [日期 HH:MM 补写] — 标题\
- 修复了什么\
- 补写原因`
详细配置（OpenViking + bge-m3 参数）→ 见 references/ollama-setup.md
详细 Ollama 安装指南 → 见 references/ollama-setup.md
自检脚本 → scripts/memory-check.sh
Usage Guidance
This skill appears coherent with its stated purpose (managing workspace memories using a local vector DB and local LLM). Before installing or running: (1) review the Ollama install script at https://ollama.com/install.sh yourself instead of piping blindly to sh; (2) be aware the skill and its self-check read ~/.openclaw/openclaw.json and agent sessions files—inspect those files for sensitive info you don't want read; (3) running ollama pull bge-m3 may download large model data and start a local service; (4) if you enable autonomous invocation, expect the skill to read and update local memory files/sessions as described. If you want higher assurance, request a signed/reviewed installer or run steps manually under an isolated account or container.
Capability Analysis
Type: OpenClaw Skill
Name: dream-memory
Version: 1.0.0
The "dream-memory" skill bundle provides a comprehensive memory management system that utilizes shell scripts and accesses sensitive local files. Specifically, `scripts/memory-check.sh` reads the OpenClaw configuration file (`~/.openclaw/openclaw.json`), which often contains sensitive API keys, and `SKILL.md` instructs the agent to read session history files. While these actions are plausibly necessary for the stated purpose of system diagnostics and memory tracking, the combination of shell execution, local network interaction (via curl to 127.0.0.1), and access to sensitive configuration paths constitutes a high-risk capability set.
Capability Assessment
Purpose & Capability
The skill describes a memory stack (files + vector DB + local LLM + agent rules) and its instructions and scripts only touch local workspace files, an OpenViking vector service, and a local Ollama model—these map to the stated purpose.
Instruction Scope
SKILL.md and the self-check script explicitly read workspace files (MEMORY.md, AGENTS.md, etc.) and OpenClaw session/config files (~/.openclaw/...), which are relevant for session flush/check behavior. No instructions appear to collect or transmit data to external endpoints beyond local services.
Install Mechanism
There is no formal install spec, but references/ollama-setup.md recommends running `curl -fsSL https://ollama.com/install.sh | sh` and using `ollama pull bge-m3`. Download-and-execute via curl|sh is common for installers but is higher-risk than package installs; the URL is the official domain (ollama.com), which mitigates but does not eliminate risk.
Credentials
The skill declares no required env vars or secrets. The script optionally reads OPENCLAW_CONFIG or defaults to ~/.openclaw/openclaw.json—this is proportional to verifying memorySearch settings and session tracking.
Persistence & Privilege
The skill is not always-enabled and does not request special platform privileges. It can be invoked autonomously (normal default); combined with local-file access this is expected for a memory-management skill but users should be aware it may read agent session/config files when run.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dream-memory - After installation, invoke the skill by name or use
/dream-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
name: dream-memory
description: >
完整的工作区记忆管理系统。四层架构：文件存储 + OpenViking 向量引擎 + Ollama bge-m3 + Agent 规则。
Use when: 用户询问记忆系统如何工作、如何安装记忆系统到新 Agent、记忆文件结构、向量检索原理、
Session Flush 机制、长期记忆晋升规则、OpenViking 配置、bge-m3 参数调优、跨会话记忆丢失排查。
也适用于为新 OpenClaw 实例部署完整记忆管理方案。
Metadata
Frequently Asked Questions
What is dream-memory?
完整的工作区记忆管理系统。四层架构：文件存储 + OpenViking 向量引擎 + Ollama bge-m3 + Agent 规则。 Use when: 用户询问记忆系统如何工作、如何安装记忆系统到新 Agent、记忆文件结构、向量检索原理、 Session Flush 机制、长期记忆晋升规则、OpenVik... It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.
How do I install dream-memory?
Run "/install dream-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is dream-memory free?
Yes, dream-memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does dream-memory support?
dream-memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created dream-memory?
It is built and maintained by Shoukuan (@shoukuan); the current version is v1.0.0.
More Skills