openclaw-memory-config

用于配置和诊断 OpenClaw 记忆系统的 Workspace Skill，按当前 OpenClaw Schema 和官方文档执行最小、可回滚的变更。

覆盖能力

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。

默认 Embedding

• Provider：openai-compatible
• Base URL：https://lapi.transiglobal.com/v1
• Model：bge-large-zh-v1.5
• Credential：TRAPI_API_KEY SecretRef

不会要求用户在聊天中粘贴明文 API Key。已有可解析 SecretRef 会优先保留。

使用方式

在 OpenClaw 对话中说：

配置记忆

技能会先读取当前版本、Schema、active memory plugin、Memory Search、Dreaming、Commitments、Heartbeat 和 Wiki 状态，再给出最小变更方案。

所有配置写入遵循：

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
• Memory search
• Inferred commitments
• Dreaming
• Memory configuration reference
• Memory Wiki

许可证

MIT