Agent 集成

ReMe 把记忆能力放在独立服务和用户拥有的 workspace 中。Agent 可以通过标准接口调用同一套记忆，而不必把存储逻辑绑定到某一个模型或宿主。

选择接入方式

场景	推荐方式
本机脚本或 Hook	ReMe CLI
应用后端	HTTP Client
支持工具协议的 Agent	MCP
DeepSeek Harness	@agentscope-ai/reme-dsh-plugin profile bundle
OpenClaw	@agentscope-ai/reme-openclaw-plugin
Claude Code	启动 ReMe 后安装插件
Hermes Agent	Memory provider adapter
Codex	启动 ReMe 后安装插件
其他 coding agent	reme_memory Skill 或 MCP

通用接入循环

一个完整但可控的 Agent 记忆循环通常包含：

1. 会话开始或回答前，用 search 找到相关记忆；
2. 对高价值结果使用 read，必要时用 traverse 展开关系；
3. 在回答中保留 workspace-relative 来源路径；
4. 会话结束后，把原始消息交给 auto_memory；
5. 由后台或定时任务把 daily 内容整理到 digest。

搜索不到内容时应明确返回空结果，不应把模型推测当成历史记忆。

MCP

默认 HTTP 服务在 http://127.0.0.1:2333/mcp 提供 streamable HTTP MCP。常用工具包括：

• search
• read
• traverse
• list
• auto_memory
• proactive_read

根据宿主风险模型，可以用 service.jobs 只暴露只读工具，或将写入工具放在单独配置中。

CLI 和 Skill

仓库中的 skills/reme_memory/SKILL.md 描述了一个通用 Agent 工作流，包括安装检查、服务发现、检索、读取和写入边界。它适合能够执行本地命令的 Agent。

Skill 不应：

• 未经允许安装或升级 Python 环境；
• 发现端口冲突后停止未知进程；
• 把召回的工具结果再次写入对话来源；
• 将密钥或敏感信息写入记忆。

DeepSeek Harness

安装自包含的 DeepSeek Harness 插件：

dsh plugin --profile web add @agentscope-ai/reme-dsh-plugin

发布页：Awesome DSH Plugin 和 npm。

插件会在新的根 Agent 会话中注入长期记忆使用指引，并提供只读 reme_search 工具；它不会把所有历史记忆预先塞入上下文。 已完成的用户/助手对话可以分批在后台交给 auto_memory，并由带时区的计划任务调用 auto_dream 整理 daily note。

DSH 设置可配置服务地址、指引语言、搜索数量、捕获间隔、根 Agent 过滤和整理计划。ReMe Status 页面包含 Overview、 Auto Memory、Memory Consolidation、Components、Journal 和 Personal Knowledge Base 六个视图。运行时计数只用于诊断， workspace 中的 Markdown 仍是持久事实来源。

OpenClaw

安装独立发布的 OpenClaw 插件：

openclaw plugins install clawhub:@agentscope-ai/reme-openclaw-plugin

发布页：ClawHub 和 npm。该插件拥有自己的宿主适配 ReMe HTTP 边界和发布周期。

Claude Code

先启动 ReMe HTTP 服务，再安装 Claude Code 的 ReMe 插件。 插件统一提供自动召回、完成轮次记录和记忆查询，所需 Hook、MCP 工具与 Skill 随插件安装。 本宿主使用插件安装流程接入。

Codex

先启动 ReMe HTTP 服务，再安装 Codex 的 ReMe 插件，在 /hooks 中信任插件 Hook。 新建会话后即可使用自动召回、记录和插件提供的记忆工具。本宿主同样使用插件安装流程接入。 两端各自保存插件配置与重试队列，记忆存储和整理由 ReMe 服务负责。

Hermes Agent

integrations/hermes_agent/ 提供 HTTP 和 Embedded 双模式 memory provider：模型调用前检索相关记忆，每轮结束后异步调用 auto_memory，并通过 Hermes 通用配置面板展示设置。完整配置见该目录 README。

生产接入建议

• 明确选择稳定、绝对的 workspace_dir；
• 启动前复用 reme find_reme 发现的服务；
• 以 reme help 为当前 Job 契约；
• 为写入动作设置超时和失败日志；
• 不因记忆服务暂时不可用而阻塞宿主的核心回答流程；
• 对远程访问使用认证、TLS 和最小 Job allowlist。