refactor: 对齐最新记忆与commitments文档

README.md

@@ -1,54 +1,66 @@
 # openclaw-memory-config
 
-OpenClaw 技能（Skill）：一键配置 OpenClaw 记忆系统。
+用于配置和诊断 OpenClaw 记忆系统的 Workspace Skill，按当前 OpenClaw Schema 和官方文档执行最小、可回滚的变更。
 
-## 简介
+## 覆盖能力
 
-本技能帮助用户在 OpenClaw 实例上配置完整的记忆系统，包含三大模块：
+1. **Memory Core / active memory plugin**：识别当前 memory slot，避免误覆盖 LanceDB、Honcho 等第三方插件。
+2. **Memory Search**：配置 builtin SQLite 混合检索、Embedding、索引和搜索质量。
+3. **Automatic memory flush**：检查 compaction 前自动落盘，减少上下文压缩造成的记忆丢失。
+4. **Dreaming**：启用 `memory-core` 的后台整理、Dream Diary 和长期记忆提升。
+5. **Inferred Commitments**：配置短期、会话和渠道绑定的自然跟进。
+6. **Memory Wiki**：按需配置 isolated、bridge 或 per-agent vault。
 
-1. **Memory Search** — 基于向量的语义记忆搜索
-2. **Dreaming** — 夜间自动记忆整理（短期 → 长期）
-3. **Memory Wiki** — 结构化知识库（isolated 模式）
+## 默认 Embedding
 
-## Embedding 服务
+- Provider：`openai-compatible`
+- Base URL：`https://lapi.transiglobal.com/v1`
+- Model：`bge-large-zh-v1.5`
+- Credential：`TRAPI_API_KEY` SecretRef
 
-默认使用传米科技 trapi 的 embedding 端点：
-
-| 项目 | 值 |
-|------|-----|
-| Provider | `openai`（OpenAI 兼容） |
-| Base URL | `https://lapi.transiglobal.com/v1` |
-| 模型 | `bge-large-zh-v1.5` |
-
-### API Key
-
-- **优先复用**：如本地已配置 trapi provider，自动提取 API Key，无需额外提供
-- **兜底**：如未配置 trapi，用户需提供 trapi Key 或自定义 embedding provider 信息
+不会要求用户在聊天中粘贴明文 API Key。已有可解析 SecretRef 会优先保留。
 
 ## 使用方式
 
-### 安装技能
-
-```bash
-openclaw skill install openclaw-memory-config.skill
-```
-
-### 配置
-
 在 OpenClaw 对话中说：
 
-> "配置记忆"
+> 配置记忆
 
-技能会引导完成：
-1. **Memory Search**：配置 embedding → 构建索引 → 测试搜索
-2. **Dreaming**：启用夜间记忆整理（每天 4:30 自动运行）
-3. **Memory Wiki**：确认内容目录 → 初始化 vault → 导入内容 → 创建每日维护定时任务
+技能会先读取当前版本、Schema、active memory plugin、Memory Search、Dreaming、Commitments、Heartbeat 和 Wiki 状态，再给出最小变更方案。
 
-### 安全说明
+所有配置写入遵循：
 
-- API Key 必须由用户提供，技能中不存储默认密钥
-- Memory Wiki 默认使用 isolated 模式，数据完全独立
-- 所有配置通过 `gateway config.patch` 标准方式写入
+1. 创建配置备份。
+2. 使用 `openclaw config set/patch --dry-run` 验证。
+3. 正式写入并运行 `openclaw config validate`。
+4. 仅在 CLI 明确提示时重启 Gateway。
+5. 使用真实但非敏感的记忆内容验证检索质量。
+
+## Commitments 边界
+
+Commitments 默认关闭。启用前会说明隐藏 LLM 提取的模型成本、近期对话读取范围和 Heartbeat 外发条件。
+
+- “我明天有面试”这类自然跟进可使用 Commitments。
+- “下午 3 点提醒我”或周期任务必须使用 scheduled tasks/cron。
+- Heartbeat `target: "none"` 时，到期 Commitment 只保留内部状态，不会外发。
+
+## 安全约束
+
+- 不在未确认时替换第三方 memory slot。
+- 不直接覆盖 `plugins.allow` 数组。
+- 不默认改写官方搜索参数或强制重建大索引。
+- Dreaming 使用 `memory-core` 自管的去重 cron，不额外创建重复任务。
+- Wiki 的 URL ingest、unsafe-local、Obsidian CLI、compiled digest prompt 和通知任务均需单独确认。
+- 不执行 `gateway stop`；需要时使用 `openclaw gateway restart`。
+
+## 官方文档
+
+- [Memory overview](https://docs.openclaw.ai/concepts/memory)
+- [Memory search](https://docs.openclaw.ai/concepts/memory-search)
+- [Inferred commitments](https://docs.openclaw.ai/concepts/commitments)
+- [Dreaming](https://docs.openclaw.ai/concepts/dreaming)
+- [Memory configuration reference](https://docs.openclaw.ai/reference/memory-config)
+- [Memory Wiki](https://docs.openclaw.ai/plugins/memory-wiki)
 
 ## 许可证