记忆设置技能

将你的智能体从“金鱼”升级为“大象”。该技能用于为 Moltbot/Clawdbot 配置持久化记忆功能。

快速配置

1. 在配置中启用记忆搜索

向 ~/.clawdbot/clawdbot.json（或 moltbot.json）中添加以下内容：

{
  "memorySearch": {
    "enabled": true,
    "provider": "voyage",
    "sources": ["memory", "sessions"],
    "indexMode": "hot",
    "minScore": 0.3,
    "maxResults": 20
  }
}

2. 创建记忆目录结构

在你的 workspace 中创建如下结构：

workspace/
├── MEMORY.md              # 长期维护的记忆主文件
└── memory/
    ├── logs/              # 每日日志（格式：YYYY-MM-DD.md）
    ├── projects/          # 项目专属上下文
    ├── groups/            # 群聊上下文
    └── system/            # 偏好设置、初始化说明等

3. 初始化 MEMORY.md

在 workspace 根目录下创建 MEMORY.md：

# MEMORY.md — 长期记忆

## 关于 [用户姓名]
- 关键事实、偏好、背景信息

## 当前项目
- 项目摘要与进展状态

## 决策与经验
- 已做出的重要决策
- 总结的经验教训

## 偏好设置
- 沟通风格
- 使用的工具与工作流

配置项说明

Provider 可选项

• voyage — Voyage AI 嵌入模型（推荐）
• openai — OpenAI 嵌入模型
• local — 本地嵌入模型（无需 API）

Source 可选项

• memory — MEMORY.md 及 memory/*.md 下所有文件
• sessions — 历史对话记录
• both — 完整上下文（推荐）

每日日志格式

每天创建一个 memory/logs/YYYY-MM-DD.md 文件：

# YYYY-MM-DD — 每日日志

## [时间] — [事件/任务]
- 发生了什么
- 做出的决策
- 待跟进事项

## [时间] — [另一事件]
- 详细信息

智能体指令（AGENTS.md）

在你的 AGENTS.md 中添加以下行为规范：

## 记忆召回
在回答涉及过往工作、决策、日期、人员、偏好或待办事项的问题前：
1. 运行 memory_search 并传入相关查询
2. 如需提取特定行内容，可调用 memory_get
3. 若搜索后置信度仍较低，应明确告知已检查记忆

故障排查

记忆搜索未生效？

1. 确认配置中 memorySearch.enabled 设为 true
2. 确认 workspace 根目录下存在 MEMORY.md
3. 重启网关：clawdbot gateway restart

搜索结果不相关？

• 将 minScore 调低至 0.2 以获取更多结果
• 将 maxResults 提高至 30
• 检查记忆文件是否包含有意义的内容

Provider 报错？

• Voyage：在环境变量中设置 VOYAGE_API_KEY
• OpenAI：在环境变量中设置 OPENAI_API_KEY
• 若无可用 API 密钥，可改用 local provider

验证方法

测试记忆功能是否正常工作：

User: "你对 [过往主题] 有什么记忆？"
Agent: [应执行记忆搜索并返回相关上下文]

若智能体表示无相关记忆，则说明配置未生效，请重启网关。

完整配置示例

{
  "memorySearch": {
    "enabled": true,
    "provider": "voyage",
    "sources": ["memory", "sessions"],
    "indexMode": "hot",
    "minScore": 0.3,
    "maxResults": 20
  },
  "workspace": "/path/to/your/workspace"
}

为何这很重要

没有记忆功能时：

• 智能体在每次会话间遗忘全部内容
• 重复提问，丢失上下文
• 项目进展无法延续

启用记忆功能后：

• 可回忆历史对话
• 了解你的偏好设置
• 追踪项目演进过程
• 随时间推移建立更深入的协作关系

金鱼 → 大象。 🐘