📦 bagua-memory

v1.0.0

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

0· 0·0 当前·0 累计

by @xuanyizhi (良鼠)

生产力工具办公协作 AI模型访问

下载技能包

安全扫描

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 代理。

详细架构见 references/architecture.md（权威来源：memory/bagua/README.md）。

⚡ 自激活（首次触发必做）

检测条件：如果代理S.md 或 SOUL.md 中不存在 ## 记忆规则章节，说明尚未激活。

激活步骤：

运行 bash scripts/init_bagua.sh .（在 workspace 根目录，自动创建 memory/ 和 MEMORY.md）读取 references/soul-inject.md，将其内容追加到代理S.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 天 → 摘要化恢复：归档记忆再次被引用 → 升回原卦位八卦速查卦目录存什么边界 ☰ 乾 qian/ 系统规则、行为准则 - ☷ 坤 kun/ 知识库、事实相对稳定的信息 ☲ 离 li/ 近期新发现只放"新东西"，不放对话总结 ☵ 坎 kan/ 决策推理只记"为什么"（reason） ☳ 震 zhen/ 事件时间线只记"发生了什么"（fact） ☴ 巽 xun/ 关联网络人/项目/概念关系 ☶ 艮 gen/ 归档记忆冷却中的旧记忆 ☱ 兑 dui/ 用户偏好风格、习惯、情感与 MEMORY.md 的关系

MEMORY.md 是入口（L0），记忆本体在 memory/bagua/ 各卦位下。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库