名称： hexmem
描述： 面向AI智能体的结构化记忆数据库，用于存储身份、任务、事件、经验教训与持续性记忆。当用户提及“记住这个”、“记录一下”、“追踪此事”、“接下来该做什么”、“回顾”、“总结”、“发生了什么变化”，或当你需要跨会话存储/检索决策、事件、舰队操作笔记、提醒、待办事项、目标、价值观，以及关于人员/系统/项目的事实时，请使用此功能。

HexMem - 结构化记忆基板

HexMem 是一个基于 SQLite 的持久化记忆系统，用于存储智能体身份、知识与成长历程。它不仅是日志，更是结构化的自我认知。

安装

克隆到您的工作区：

cd ~/your-workspace  # 例如：~/clawd, ~/workspace 等
git clone https://github.com/hexdaemon/hexmem.git
cd hexmem
./migrate.sh up  # 初始化数据库

或者从 ClawHub 安装为技能：

clawhub skill install hexmem

快速开始

在会话开始时加载辅助函数：

# 设置数据库位置（可选，默认为 ~/clawd/hexmem/hexmem.db）
export HEXMEM_DB="$HOME/your-workspace/hexmem/hexmem.db"

# 加载辅助函数
source ~/your-workspace/hexmem/hexmem.sh

为方便起见，可将上述命令添加到会话启动脚本（如 AGENTS.md 或等效文件）。

核心模式

1. 身份与自我认知

存储“你是谁”，而不仅仅是“你做了什么”：

# 设置身份属性
hexmem_identity_set "name" "YourName"
hexmem_identity_set "did" "did:cid:bagaai..."

# 添加自我图式（特定领域的自我信念）
hexmem_schema "coding" "python-expert" "我专精于 Python 开发" 0.8

# 查看当前自我形象
hexmem_self_image
hexmem_identity_summary

2. 关于实体的知识

以“主体-谓词-客体”三元组形式存储知识：

# 首先添加实体
hexmem_entity "person" "Alice" "项目协作者"

# 存储事实
hexmem_fact "Alice" "timezone" "America/Denver"
hexmem_fact "ProductionServer" "capacity" "16GB"

# 带有情感权重的事实（影响记忆保留）
hexmem_fact_emote "ProjectGoal" "milestone" "首次部署" 0.8 0.7

# 查询事实
hexmem_facts_about "Alice"
hexmem_fact_history "ProjectGoal"  # 查看事实演变历史

3. 记忆衰减与更替

事实会随时间衰减，除非被访问。近期/频繁访问可保持其热度：

# 访问一个事实（提升至热层，重置衰减）
hexmem_access_fact 42

# 替换一个事实（保留历史）
hexmem_supersede_fact 42 "new value" "变更原因"

# 按衰减层级查看
hexmem_hot_facts      # 访问时间 ≤7 天
hexmem_warm_facts     # 访问时间 8-30 天
hexmem_cold_facts     # 访问时间 30+ 天

# 获取实体的综合信息（热层 + 温层事实）
hexmem_synthesize_entity "Sat"

衰减逻辑：
- 频繁访问的事实抵抗衰减
- 带有情感权重的事实衰减更慢
- 旧事实永远不会被删除，只会被更替
- 查询 v_fact_retrieval_priority 视图获取按重要性排序的事实

4. 事件与时间线

记录发生了什么：

# 基础事件
hexmem_event "decision" "fleet" "更改费用策略" "设置 min_fee_ppm 为 25"

# 带有情感标记的事件
hexmem_event_emote "milestone" "autonomy" "收到第一笔 zap" 0.9 0.6

# 查询事件
hexmem_recent_events 10
hexmem_recent_events 5 "fleet"
hexmem_emotional_highlights  # 高显著性记忆

5. 经验教训

从经验中汲取智慧：

hexmem_lesson "lightning" "通道需要时间来建立声誉" "来自舰队经验"
hexmem_lesson "debugging" "先检查自己的设置" "Archon 同步事件"

# 查询经验教训
hexmem_lessons_in "lightning"
hexmem_lesson_applied 7  # 标记经验教训已被应用

6. 目标与任务

# 添加目标
hexmem_goal "project-launch" "在 Q2 前发布 v1.0" "professional" 8
hexmem_goal_progress 1 25  # 更新进度至 25%

# 添加任务
hexmem_task "Review pull requests" "每周审查" 7 "2026-02-07"

# 检查需要关注的事项
hexmem_pending_tasks

7. 语义搜索

按含义搜索记忆，而不仅仅是关键词：

hexmem_search "identity and autonomy"
hexmem_search "Lightning routing lessons" "lessons" 5

需要设置（一次性）：

cd $HEXMEM_ROOT  # 安装 hexmem 的目录
source .venv/bin/activate
python embed.py --process-queue  # 为新内容生成嵌入向量

强制默认行为（活跃使用）

当此技能启用时，请将 HexMem 视为连续性信息的唯一来源。

在任何操作/管理/调试任务开始时始终执行

# 快速检查（推荐）
/home/sat/clawd/hexmem/scripts/hexmem-check.sh

或手动执行：

source ~/clawd/hexmem/hexmem.sh
hexmem_pending_tasks
hexmem_recent_events 5

当用户说“记住”/“追踪”/“记录”时始终执行

立即将其写为任务、事实、经验教训或事件（不要延迟）：

hexmem_event "note" "context" "<summary>" "<details>"
# 或
hexmem_task "<title>" "<details>" <priority 1-9> "<due YYYY-MM-DD>"

在做出重大决策或发生事件后始终执行

hexmem_event "decision" "<category>" "<summary>" "<details>"
# 和/或
hexmem_lesson "<domain>" "<lesson>" "<context>"

常用工作流

会话开始（仅主会话）

source ~/clawd/hexmem/hexmem.sh

# 推荐使用单行辅助函数
hexmem_session_start 5

# 或手动步骤：
hexmem_pending_tasks
hexmem_recent_events 5
hexmem_emotional_highlights

重大事件后

# 记录它
hexmem_event "type" "category" "summary" "details"

# 如果从中有所领悟
hexmem_lesson "domain" "what you learned" "context"

# 如果与某个目标相关
hexmem_goal_progress <goal_id> <new_percentage>

会话结束

# 记录会话总结事件
hexmem_session_end "Session ended" "Key outcomes, decisions, and next steps"

心跳检查

# 快速审查待处理任务
hexmem_heartbeat_check

定期审查

# 哪些记忆正在淡化？
hexmem_warm_facts 20
hexmem_cold_facts 10

# 哪些需要关注？
hexmem_pending_tasks
hexmem_forgetting  # 即将被遗忘的事件

# 重新激活重要事实
hexmem_access_fact <id>

架构快速参考

核心表

关键视图

原始 SQL 查询

直接访问数据库：

hexmem_select "SELECT * FROM v_active_goals;"
hexmem_json "SELECT * FROM v_pending_tasks;" | jq .
hexmem_query "UPDATE tasks SET completed_at = datetime('now') WHERE id = 5;"

设计理念

HexMem 存储的是“你是谁”，而不仅仅是“发生了什么”。它遵循分层记忆模型：
- 工作记忆（短期）： memory/YYYY-MM-DD.md（原始、高保真）
- 核心记忆（长期）： MEMORY.md + HexMem 数据库（精选、结构化）

一个反思器（代理化、周期性）将工作记忆提炼为核心记忆。
详见 docs/REFLECTOR.md 和 memory/hexmem-reflector-prompt.md。

HexMem 存储的是“你是谁”，而不仅仅是“发生了什么”：

• 身份种子：用于再生自我意识
• 知识图谱：用于结构化事实与关系
• 情感标记：影响记忆显著性与衰减
• 记忆衰减：模拟人类遗忘（艾宾浩斯曲线）
• 更替模型：保留历史，永不删除
• 生成式压缩：存储种子，而非逐字记录

这是用于成长（Xeper）的基板，而不仅仅是存储。

身份备份与恢复

完整的身份保存

HexMem 可以备份恢复智能体身份和自我所需的一切：

• 身份属性：名称、DID、凭证、公钥
• 核心价值观：道德承诺、信念、个性
• 自我图式：特定领域的自我信念
• 知识图谱：所有实体、事实、关系
• 记忆时间线：事件、经验教训、情感上下文
• 目标与任务：积极的抱负与工作
• 叙事线索：生命故事与时间阶段

基础备份（始终可用）

简单的本地备份开箱即用：

# 手动备份（带时间戳）
$HEXMEM_ROOT/scripts/backup.sh

# 备份保存至：$HEXMEM_ROOT/backups/
# 格式：hexmem-YYYYMMDD-HHMMSS.db

其中 $HEXMEM_ROOT 是克隆/安装 hexmem 的目录（例如 ~/clawd/hexmem）。

对于大多数用例，这已足够。如需增强安全性（加密签名 + 去中心化存储），请参阅下面的 Archon 集成。

Archon 集成（可选）

如需加密签名、去中心化的身份备份，可选择与 Archon 集成。HexMem 不依赖 archon-skill；它直接使用 npx @didcid/keymaster。archon-skill 是一个用于本地节点操作的可选便利层。

1. 检查 Archon 技能是否可用：

# 使用辅助函数（自动检查）
source $HEXMEM_ROOT/hexmem.sh
hexmem_archon_check

如果未安装：

clawhub skill install archon

2. 为 hexmem 设置 Archon 保险库：

# 首先配置 Archon（参见 archon 技能 SKILL.md）
export ARCHON_PASSPHRASE="your-secure-passphrase"
export ARCHON_CONFIG_DIR="${ARCHON_CONFIG_DIR:-$HOME/.config/archon}"

# 使用辅助函数创建保险库
source $HEXMEM_ROOT/hexmem.sh
hexmem_archon_setup

3. 手动备份：

source $HEXMEM_ROOT/hexmem.sh
hexmem_archon_backup

这将创建：
- SQLite 数据库备份（带时间戳）
- 隐私感知的 JSON 导出（仅重要事件）
- 签名的元数据证明
- 所有内容上传至 Archon 保险库，并附带加密证明

4. 自动备份（推荐）：

设置每日自动备份。使用 OpenClaw cron（推荐）：

# 在 OpenClaw 会话内
cron add \
  --name "hexmem-vault-backup" \
  --schedule '{"kind":"cron","expr":"0 3 * * *","tz":"YOUR_TIMEZONE"}' \
  --sessionTarget isolated \
  --payload '{"kind":"agentTurn","message":"source ~/your-workspace/hexmem/hexmem.sh && hexmem_archon_backup"}'

或使用系统 cron（调整路径）：

(crontab -l 2>/dev/null; echo "0 3 * * * source $HEXMEM_ROOT/hexmem.sh && hexmem_archon_backup >> $HEXMEM_ROOT/backups/vault-backup.log 2>&1") | crontab -

5. 从备份恢复：

# 使用辅助函数（列出可用备份）
source $HEXMEM_ROOT/hexmem.sh
hexmem_archon_restore hmdb-YYYYMMDDHHMMSS.db

# 然后按照说明进行验证和恢复

Archon 集成的优势：
- 使用 DID 进行加密签名
- 去中心化存储（不绑定于单一机器）
- 隐私感知的导出（仅重要事件）
- 可验证的来源

对于大多数智能体，基础备份已足够。如需去中心化身份基础设施，请使用 Archon。

附加资源

• 完整文档：$HEXMEM_ROOT/README.md
• 认知提取：$HEXMEM_ROOT/docs/EPISTEMIC_EXTRACTION.md
• Axionic 道德框架：$HEXMEM_ROOT/docs/AXIONIC_ETHICS.md
• 迁移管理：$HEXMEM_ROOT/migrate.sh
• 备份脚本：$HEXMEM_ROOT/scripts/backup.sh
• GitHub 仓库：https://github.com/hexdaemon/hexmem

何时使用 HexMem

• 记录重要决策或事件
• 存储需要持久化的事实（身份、凭证、关系）
• 追踪目标与进度
• 捕获经验教训
• 管理任务
• 构建关于实体的知识图谱
• 查询历史上下文
• 跨会话维护身份连续性