Skip to main content
本页介绍使用共享服务的 Agent 接入。请先部署 ReMe 服务，再选择 Agent 如何连接，以及何时召回或记录记忆。AgentScope 的进程内 ReMeMiddleware 应使用 Python 接入。

​
选择接入模式

以下模式的区别在于如何封装服务调用与记忆行为： 三种模式最终连接同一个服务边界：
Agent 侧的接入不负责管理 ReMe 进程。它负责选择服务接口、提供会话上下文，并决定返回的记忆是否以及如何影响回答。

​
Skill

Skill 是服务接口之上的行为层，不是服务或传输方式。仓库内置的 skills/reme_memory/ 使用 ReMe CLI；其他宿主也可以通过 MCP 工具或 HTTP 应用相同的行为。 使用 Skill 时，将完整的 skills/reme_memory/ 目录安装到宿主的 skill 位置，确保 SKILL.md 和配套规则一起保留。之后宿主应遵循以下约定：
  1. 回答过往对话、偏好、决定或项目历史前，先搜索，再读取命中的相关文件；
  2. 只记录具有长期价值的事实、偏好、决定和经验，不默认保存密钥或敏感信息；
  3. 会话结束或出现稳定信息时调用 auto_memory，并使用宿主会话生命周期提供的稳定 session_id；
  4. 将 auto_dream 交给 ReMe 定时任务，或由宿主按自身生命周期触发；
  5. 将 ReMe 视为记忆输入，最终是否以及如何使用结果仍由 Agent 决定。
Skill 不负责启动 ReMe，也不会自行补全缺失的对话历史。

​
Plugin

Plugin 将特定宿主所需的服务连接配置、工具、Skill 和会话 hook 等能力打包在一起。它应连接已经部署的 ReMe 服务，并利用宿主生命周期实现自动召回或记录。安装 plugin 并不意味着它会启动或管理 ReMe。

​
维护中的集成

ReMe 目前为以下宿主提供了现成的整合方案： 下面分别介绍这些方案的宿主专用配置与验证步骤。

​
Claude Code

Claude Code plugin 组合了 MCP 召回、召回 skill 和异步会话记录。它只连接共享的 ReMe MCP 服务，不会自行启动 ReMe。

​
1. 启动 ReMe

先按快速开始安装 ReMe，再保持 MCP 服务运行：
默认端点为 http://127.0.0.1:2333/mcp。自动记录还需要配置 LLM 环境。

​
2. 安装 Plugin

克隆 ReMe 仓库，在仓库根目录通过 Claude Code 添加内置 marketplace 并安装 plugin：
重启 Claude Code，运行 /mcp，确认名为 reme 的 server 和工具已经连接。 Package 位于 plugins/claude_code/：.mcp.json 定义服务地址，reme-memory skill 控制召回，hooks/auto_memory.py 在会话结束后调用 auto_memory_cc。

​
3. 验证召回与记录

先在终端写入一条容易识别的记忆：
随后让 Claude Code 回答“这个项目提交前要做什么？”。它应先搜索并读取 ReMe，再根据记忆回答。 接着结束一段包含长期信息的对话，稍后搜索其中的关键词：
Stop hook 异步运行，并采用 best-effort 策略：ReMe 服务不可用时不会阻塞 Claude Code。修改服务端口时，还需同步更新 plugins/claude_code/reme/.mcp.json。Hook 覆盖项和日志位置见 plugin README。

​
QwenPaw

QwenPaw 通过上文介绍的 ReMe Skill 接入。Skill 定义 Agent 何时召回或记录，ReMe 服务负责持久化、索引和整理。

​
1. 启动 ReMe

保持默认 HTTP 服务运行：
对话提炼和长期整合需要配置快速开始中的 LLM 环境。

​
2. 安装 ReMe Skill

将仓库中的完整 skills/reme_memory/ 目录安装到 QwenPaw 的 skill 位置，确保 SKILL.md 和行为规则一起保留。 加载后，QwenPaw 应遵循以下规则：
  • 回答过去对话、偏好、决定或项目历史前，先搜索并读取；
  • 只用 auto_memory 记录具有长期价值的信息，不保存每轮对话；
  • 写入敏感信息前取得用户明确同意；
  • 由自身的会话生命周期提供稳定的 session_id。
skills/qwenpaw_memory 会直接维护 MEMORY.md 和 memory/*.md，不会调用 ReMe。接入 ReMe 时应使用 skills/reme_memory。

​
3. 验证召回与记录

先在终端写入验证记忆：
然后让 QwenPaw 回答“我偏好怎样的技术解释？”。确认它先搜索 ReMe，并读取刚写入的文件。 再提供一条具有长期价值的信息，结束会话后搜索相关关键词。如果当前 QwenPaw 版本没有会话结束 hook，可以由应用层显式调用 auto_memory，或先仅启用召回；不要自行补全缺失的消息历史。