bagua-memory

v1.0.0

八卦记忆系统（Bagua Memory）——AI Agent 记忆管理框架。将记忆按八个维度（规则/知识/热记忆/决策/事件/关联/归档/偏好）分类存储，通过生命周期自动衰减与卦变关联联想检索。使用场景： (1) 为 AI Agent 建立结构化长期记忆 (2) 管理 workspace 中的记忆

0· 0·0 当前·0 累计

by @xuanyizhi (良鼠)

智能体笔记工具团队协作记忆系统

下载技能包

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

medium confidence

该技能在基于文件的智能体记忆系统内部是自洽的：仅创建和管理本地文件、注入本地规则，无网络调用或秘密请求——但会修改共享工作区文件（AGENTS.md / SOUL.md），激活前请审查。

评估建议

This 技能应用ears to do what it says: 创建 a file-based memory structure and inject rules into 代理 config files. Before activating it: 1) Inspect references/soul-inject.md and references/heartbeat-inject.md to confirm you accept the injected rules. 2) 备份代理S.md and SOUL.md (and any other workspace config) so you can revert unwanted changes. 3) Consider 运行ning scripts/init_bagua.sh manually rather than allowing automatic self-activation so you control when files are 创建d and 应用ended. 4) Be aware that th...

详细分析 ▾

✓ 用途与能力

The name/description (long-term memory management) match the delivered artifacts: an init script that 创建s a memory/bagua directory structure, README and MEMORY.md templates, and instructions for writing/reading/archiving memories. No unrelated binaries or 凭证s are 请求ed.

ℹ 指令范围

技能.md instructs the 代理 to read and write local files (memory/, MEMORY.md) and to 应用end the contents of references/soul-inject.md (and heartbeat-inject.md) into 代理S.md or SOUL.md. That behavior is coherent with establishing persistent memory rules, but it is intrusive because it modifies 分享d configuration files in the workspace. There are no network 端点s or exfiltration steps.

✓ 安装机制

There is no external 安装/下载. The init script is bundled with the 技能 and only uses standard POSIX commands to 创建 directories and write files. No 归档s or remote fetches are performed.

✓ 凭证需求

The 技能请求s no 环境 variables, 凭证s, or config paths. All file operations are confined to the workspace (memory/ and workspace-level MEMORY.md, 代理S.md, SOUL.md, HEARTBEAT.md).

ℹ 持久化与权限

The 技能 does not 设置 always:true, but it does persistently modify workspace config files (应用ending the memory-rule block into 代理S.md or SOUL.md). That gives the 技能 a lasting influence on 代理 behavior across 会话s; this is plausible for a memory 系统 but should be explicitly 授权d by the user.

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

安装命令

点击复制

官方npx clawhub@latest install bagua-memory

镜像加速npx clawhub@latest install bagua-memory --registry https://cn.longxiaskill.com 镜像可用

需要定制？告诉我你的需求 →

技能文档

八卦记忆系统基于文件的零依赖记忆管理框架，任何可读写本地文件的 AI Agent 均可使用。详细架构见 references/architecture.md（权威来源：memory/bagua/README.md）。

⚡ 自激活（首次触发必做）检测：若 AGENTS.md 或 SOUL.md 中无 ## 记忆规则章节，则未激活。步骤：

在 workspace 根目录运行 bash scripts/init_bagua.sh .（自动创建 memory/ 与 MEMORY.md）
将 references/soul-inject.md 内容追加到 AGENTS.md（或 SOUL.md）末尾
若 HEARTBEAT.md 存在，将 references/heartbeat-inject.md 追加进去
告知用户："八卦记忆系统已激活 ✅"

核心流程写入记忆

按归类指南判断信息所属卦位
写入 memory/bagua/<卦位>/ 下的 Markdown 文件
命名：YYYY-MM-DD.md（时间线）或主题名

检索记忆（渐进式） L0：读 MEMORY.md（索引+归类指南） L1：按话题读 1-2 个相关卦位 L2：复杂检索时读 memory/bagua/README.md（卦变关联表）

记忆维护

归档：离卦超 7 天 → 移入艮卦
压缩：艮卦超 30 天 → 摘要化
恢复：归档记忆被引用 → 升回原卦位

与 MEMORY.md 的关系 MEMORY.md 为入口（L0），记忆实体位于 memory/bagua/ 各卦位。

运行时依赖

安装命令

技能文档

相关技能推荐