记忆设置（OpenClaw）

为 OpenClaw 配置持久化记忆，使智能体能够回溯过往的决策、偏好和待办事项。

1) 准备工作区文件

在工作区根目录下保留以下文件：

• MEMORY.md（人工整理的长期记忆）
• memory/YYYY-MM-DD.md（每日笔记）

可选目录结构：

• memory/projects/
• memory/system/
• memory/groups/

2) 在 OpenClaw 配置中启用记忆搜索

在 agents.defaults.memorySearch 下配置（注意：不是顶层的 memorySearch）。

示例：

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "enabled": true,
        "provider": "local",
        "includeDefaultMemory": true,
        "maxResults": 20,
        "minScore": 0.3
      }
    }
  }
}

说明：

• includeDefaultMemory: true 表示索引 MEMORY.md 及所有 memory/**/*.md 文件。
• 支持的记忆提供方（providers）包括：local、openai、gemini、voyage、mistral。
• 若使用远程提供方，请设置对应的 API 密钥（通过环境变量或 memorySearch.remote.apiKey 配置）。

3) 重启并验证

• 配置变更后，请重启 gateway。
• 可通过以下命令验证：
  • openclaw status
  • openclaw memory status（如您的 CLI 构建版本支持该命令）

4) 测试记忆回溯行为

就过往上下文提出一个问题，并确认智能体是否：

1. 执行了 memory_search 操作
2. 在必要时调用 memory_get 获取精确行内容
3. 在合适时注明所引用内容的源路径与行号

5) 故障排查

memory_search 不可用

• 确认 agents.defaults.memorySearch.enabled = true 已启用。
• 确认当前策略允许使用记忆相关工具。
• 重启 gateway。

匹配质量偏低

• 降低 minScore 值（例如设为 0.2），以扩大匹配范围。
• 提高 maxResults 值（例如设为 30）。
• 在 MEMORY.md 和每日日志中撰写更具体、结构更清晰的记录。

本地提供方（local provider）异常

• 如已配置本地模型，请确认其路径与参数设置正确。
• 必要时可切换为远程提供方，并配置对应 API 密钥。

6) 推荐操作规范

在回答有关过往工作、决策、日期、人员、偏好或待办事项的问题前，请遵循以下步骤：

1. 首先执行 memory_search
2. 其次按需调用 memory_get（仅提取所需行）
3. 若仍缺乏足够信心，则明确声明“已查询记忆”

该流程有助于确保响应内容有据可依，且全程可审计。