本地记忆
在原来的客户端里记住偏好和项目约定，新开对话也能继续使用。
告诉助手「记住，这个项目使用 pnpm」，下一次打开新对话时，就能从本地记忆找回这条约定。
你可以继续使用 GLM、DeepSeek 等 OptiWaves 模型，无需为了下面的记忆接入额外购买 ChatGPT 或 Claude 订阅。模型调用仍使用你的 OptiWaves API Key 和可用额度。
一次配置
先完成 CLI 安装引导。已有 CLI 时先更新到 0.1.16 或更新版本：
optiwaves update
optiwaves选择客户端、模型和思考深度后，在「记忆」中选择「本地记忆」。配置完成后，重新启动客户端。
首次调用时，如果客户端询问是否允许本地记忆工具，请审阅后允许。配置器保留客户端现有的工具审批策略。
已经接通 API，只需要添加记忆时，可以直接运行：
optiwaves memory --client codex将 codex 换成你使用的客户端：
| 客户端 | 参数 | 使用的记忆 |
|---|---|---|
| Claude Code | claude-code | 客户端原生 Auto Memory |
| Hermes Agent | hermes | 客户端原生记忆 |
| Codex CLI | codex | 本地 Memorix 工具 |
| OpenCode | opencode | 本地 Memorix 工具 |
| Pi | pi | 本地记忆工具扩展 |
| DeepSeek Harness | deepseek-harness | 本地 Memorix 工具 |
| ZCode | zcode | 本地 Memorix 工具 |
首次配置外部记忆工具需要下载组件，并需要 npm 和 Node.js 22.18 或更新版本。无需自己安装数据库，也不需要单独的记忆服务 API Key。配置器沿用已有的备份和恢复方式。
这条接入路径使用本地记忆工具，不等于开启 Codex 或 ZCode 的每一种原生后台记忆功能。Hermes 已有外部记忆提供方时，配置器会保留它并提示你。
验证真的记住了
在客户端里依次完成以下操作。测试期间保持同一个项目目录。
- 发送：「记住，这个项目的测试发布代号是 pine-meteor-6829。请保存到本地记忆。」
- 检查是否出现成功的记忆工具调用或写入记忆文件的操作。
- 新建对话，不要继续上一个会话。
- 发送：「从本地记忆查一下这个项目的测试发布代号。」
预期结果是找回 pine-meteor-6829。只收到「我记住了」，但没有保存操作，不能说明记忆已经生效。
确认生效后，可以说：「忘掉刚才的测试发布代号。」
日常怎么用
保存约定：告诉助手「记住，我希望修改后先运行相关测试」。
找回决定：告诉助手「查一下我们之前为什么选择这个方案」。
纠正旧内容：告诉助手「更新记忆，这个项目现在使用 Node 24，替换之前的版本」。
你不必为每句话都添加记忆指令；客户端可能主动记录有用信息。不过，自动保存取决于客户端和模型的判断。重要约定请明确要求记住，并检查实际保存结果。
记忆在哪里
Claude Code 和 Hermes 使用各自的本地记忆目录。外部工具使用当前用户 OptiWaves 私有配置目录下的 memory 目录，由 Memorix 管理。
记忆保存在运行客户端的电脑上。使用云端模型回答时，召回的相关内容仍会随请求发送给模型。这里的「本地」指存储位置，不代表整个回答过程离线。
不同客户端的原生记忆不会自动互相同步。使用本地工具的客户端应从同一个项目启动；换电脑也不会自动带走这台电脑上的记忆。
关闭或排查
查看配置：
optiwaves doctor --client codex关闭 CLI 配置的记忆连接：
optiwaves memory --client codex --memory off关闭连接不会删除已经保存的记忆。需要恢复配置时，使用 CLI 使用与维护中的恢复点。
如果助手没有找到记忆，请依次检查：
- 配置后是否重新启动了客户端
- 是否在保存记忆时使用的项目目录中
- 本地记忆工具是否加载成功
- 模型是否实际调用了保存或检索工具
- 当前工具是否被客户端权限设置禁用
Codex 的无交互任务如果返回 MCP tool call requires approval，表示本次保存没有执行。先在交互会话中允许所需记忆工具，再运行自动任务；不要把这条报错当作保存成功。
Memorix 的归档会让记录退出默认检索，但不等于从磁盘彻底擦除。对话历史和其他工具的记录也不会随长期记忆归档自动删除。需要清理全部数据时，应按所用记忆工具的管理说明操作。