OpenClaw-hot-skills-zh memory-setup

启用并配置 Moltbot/Clawdbot 的持久化记忆搜索功能。当用户需要设置记忆功能、修复"金鱼记忆"问题，或配置 memorySearch 时使用。涵盖 MEMORY.md、每日日志和向量搜索的设置。

install

source · Clone the upstream repo

git clone https://github.com/L-LesterYu/OpenClaw-hot-skills-zh

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/L-LesterYu/OpenClaw-hot-skills-zh "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/memory-setup-zh" ~/.claude/skills/l-lesteryu-openclaw-hot-skills-zh-memory-setup && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/L-LesterYu/OpenClaw-hot-skills-zh "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/memory-setup-zh" ~/.openclaw/skills/l-lesteryu-openclaw-hot-skills-zh-memory-setup && rm -rf "$T"

manifest: skills/memory-setup-zh/SKILL.md

source content

记忆设置技能

让你的 Agent 从金鱼变成大象。本技能帮助配置 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/
├── MEMORY.md              # 长期精炼记忆
└── memory/
    ├── logs/              # 每日日志 (YYYY-MM-DD.md)
    ├── projects/          # 项目特定上下文
    ├── groups/            # 群聊上下文
    └── system/            # 偏好设置、安装笔记

3. 初始化 MEMORY.md

在工作区根目录创建

MEMORY.md

：

# MEMORY.md — 长期记忆

## 关于 [用户名]
- 关键信息、偏好、上下文

## 活跃项目
- 项目摘要和状态

## 决策与经验教训
- 做出的重要选择
- 吸取的教训

## 偏好
- 沟通风格
- 工具和工作流

配置选项说明

设置项	用途	推荐值
`enabled`	启用记忆搜索	`true`
`provider`	嵌入向量提供商	`"voyage"`
`sources`	索引范围	`["memory", "sessions"]`
`indexMode`	索引时机	`"hot"` （实时）
`minScore`	相关性阈值	`0.3` （值越低结果越多）
`maxResults`	最大返回片段数	`20`

提供商选项

```
voyage
```
— Voyage AI 嵌入向量（推荐）
```
openai
```
— OpenAI 嵌入向量
```
local
```
— 本地嵌入向量（无需 API 密钥）

数据源选项

```
memory
```
— MEMORY.md + memory/*.md 文件
```
sessions
```
— 历史会话记录
```
both
```
— 全部上下文（推荐）

每日日志格式

每天创建

memory/logs/YYYY-MM-DD.md

：

# YYYY-MM-DD — 每日日志

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

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

Agent 指令（AGENTS.md）

将以下内容添加到 AGENTS.md 中以控制 Agent 行为：

## 记忆回忆
在回答关于过往工作、决策、日期、人物、偏好或待办事项的问题前：
1. 使用 memory_search 进行相关查询
2. 需要时使用 memory_get 提取具体行
3. 如果搜索后信心不足，说明已检查过记忆

故障排除

记忆搜索不工作？

检查配置中
```
memorySearch.enabled: true
```
是否已设置
确认工作区根目录存在 MEMORY.md
重启网关：
```
clawdbot gateway restart
```

搜索结果不相关？

将
```
minScore
```
降低到
```
0.2
```
以获取更多结果
将
```
maxResults
```
增加到
```
30
```
检查记忆文件中是否有有意义的内容

提供商报错？

Voyage：在环境变量中设置
```
VOYAGE_API_KEY
```
OpenAI：在环境变量中设置
```
OPENAI_API_KEY
```
如无 API 密钥，使用
```
local
```
提供商

验证

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

用户："你还记得关于 [过去的话题] 的什么事吗？"
Agent：[应该搜索记忆并返回相关上下文]

如果 Agent 没有记忆，说明配置未生效。请重启网关。

完整配置示例

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

为什么这很重要

没有记忆：

Agent 每次会话都会忘记一切
重复提问，丢失上下文
项目缺乏连续性

有记忆后：

能回忆过去的对话
了解你的偏好
追踪项目历史
随时间建立关系

金鱼 → 大象。🐘