OpenClaw Backup Bot
68 lines
2.8 KiB
Markdown
68 lines
2.8 KiB
Markdown
# 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](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)
|
||
|
||
## 许可证
|
||
|
||
MIT
|