运行时依赖
安装命令
点击复制技能文档
Ditto Ditto 是一个个人记忆助手。这些工具可以保存、搜索和遍历用户的长期记忆和主题图谱,位于 https://heyditto.ai。该技能提供一个单一的二进制文件(ditto,来自 @heyditto/cli)。认证是通过 API 密钥 —— 存储在 ~/.config/heyditto/cli/config.json(首选)或 DITTO_API_KEY 环境变量(覆盖)。
何时使用 Ditto 当用户说“记住…”,“保存这个”,“注意…”,“稍后”时。 当用户说“什么是…”,“回忆…”,“我有没有告诉你关于…”,“从我的笔记中”时。 当用户问一个最好从他们之前的上下文中回答的问题,而不是一般知识。 当用户引用一个主题、人、项目或线程,它不在这次对话中,但可能在他们的记忆中。
认证 —— 两个路径 始终先检查 ditto 状态。它打印 api 密钥:设置(来源:环境变量|配置)或 MISSING(来源:无)。 如果密钥丢失,告诉用户:在 https://app.heyditto.ai/connect/openclaw 获取一个密钥(一頁登录 + 复制),然后将其粘贴回给我。 当用户粘贴一个密钥(看起来像 ditto_mcp_…)时,运行一个命令:ditto login <密钥>。这将密钥写入 ~/.config/heyditto/cli/config.json(模式 0600)并在 shell 中持续存在。无需编辑环境变量。 使用 ditto 状态确认 —— 应该现在显示来源:配置。如果用户更喜欢环境变量(高级),则导出 DITTO_API_KEY=ditto_mcp_…。环境变量始终覆盖保存的密钥。要停止使用环境变量覆盖:unset DITTO_API_KEY。登出 ditto logout # 删除 ~/.config/heyditto/cli/config.json
工具 记忆是成对的(一个用户回合 + 一个 Ditto 回合),由 pair_id 标识。主题是图节点,用于表示主题,通过 subject_id 标识。 ditto save <内容> [--source ] [--source-context ] 持久化一个记忆对,从外部源。 使用 ditto search <查询>... 在记忆中进行语义搜索,具有学习的检索权重。 ditto fetch ... 获取由 ditto search 返回的记忆对 id 的完整对话文本(用户 + Ditto 回合)。 ditto subjects <查询> [--top-k ] 搜索主题图谱。返回可以输入到 ditto memories 的主题 id。 ditto memories ... 获取特定主题的记忆预览。 ditto network [--limit ] 遍历一个记忆的网络 —— 通过共享主题连接的相关记忆。
输出 所有命令默认发出 JSON —— 通过管道传输到 jq 进行塑形。 ditto config 打印一个 Claude/Cursor 兼容的 MCP 配置片段。 权威参考 ditto status 打印直接从 MCP 的实时工具列表 —— 如果任何内容漂移,请相信它而不是这个文件。
来源 + 支持 CLI 在 npm 上:https://www.npmjs.com/package/@heyditto/cli(npm i -g @heyditto/cli) 技能仓库:https://github.com/ditto-assistant/ditto-clawhub CLI 仓库:https://github.com/ditto-assistant/ditto-cli 获取密钥:https://app.heyditto.ai/connect/openclaw 账户 / 后端支持:support@heyditto.ai