Skip to main content
Nowledge MemNowledge Mem
连接

Alma

Alma 专属 Nowledge Mem 插件。13 个工具、自动回忆、实时对话同步、Access Anywhere,以及可选的原生 Alma Skill。

给你的智能体

把这行交给你的智能体。它应该先使用统一安装指南;这一页保留为行为说明和排障参考:

读取 https://mem.nowledge.co/SKILL.md,按其中说明为 Alma 安装或更新 Nowledge Mem。如果你使用 Alma Skills,请启用随插件附带的 nowledge-mem Skill,或复制到 ~/.config/alma/skills/nowledge-mem。用 nmem status 和 Context Bundle 或 Working Memory 检查验证结果,并总结你改了什么。

记忆随 Alma 对话流动。从插件市场一键安装;如果你使用 Alma Skills,再启用随插件附带的 Alma Skill,让 Alma 更清楚什么时候该使用记忆工具。通过 Access Anywhere 连接远程 Mem 实例,跨设备使用。

来源:community/nowledge-mem-alma-plugin

第一次成功应该是什么样

安装插件后,打开一个新的 Alma 线程,直接问:"请使用 Nowledge Mem status 工具,告诉我服务器是否已连接。" nowledge_mem_status 的结果应显示 ok: true 和 serverConnected: true。如果你的 Mem 里已经有记忆,再问一个依赖过往工作的追问;如果是全新的空库,状态检查加对话捕获成功就足够。

开始之前

  • Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
  • 已安装 Alma,并且能打开它的插件市场

安装步骤

从 Alma 插件市场安装

在 Alma 中打开设置 → 插件 → 市场,搜索 Nowledge Mem,点击安装。

Alma 市场 - Nowledge Mem

可选:启用 Alma Skill

不做这一步插件也能工作:工具、自动回忆和对话同步都由插件负责。如果你使用 Alma 的 设置 → Skills 页面,先看看是否出现随插件附带的 nowledge-mem Skill;如果出现,建议启用。它会提醒 Alma 什么时候读取 Context Bundle、搜索过往工作、查看来源对话,以及保存值得长期保留的决策。

如果安装插件后没有看到这个 Skill,可以复制到 Alma 的个人 Skills 目录,然后刷新 Skills:

mkdir -p ~/.config/alma/skills/nowledge-mem
cp ~/.config/alma/plugins/nowledge-mem/skills/nowledge-mem/SKILL.md \
  ~/.config/alma/skills/nowledge-mem/SKILL.md

在新线程里验证

请 Alma 调用状态工具:

请使用 Nowledge Mem status 工具,告诉我服务器是否已连接。

然后发送一条普通短消息,等待几秒、切换线程,或正常退出 Alma。该对话应出现在 Nowledge Mem 的对话页面,来源为 alma。

更新

在 Alma 中打开 设置 → 插件 → 市场,找到 Nowledge Mem,如有新版本点击 更新 即可。

禁用或卸载

  • 如果只想暂停自动对话捕获,在 Nowledge Mem 插件设置里关闭 autoCapture。
  • 如果只想暂停预加载回忆,把 recallPolicy 设为 off;如果只希望显式工具调用,使用 strict_tools。
  • 如需移除连接,在 Alma 的设置 → 插件页面禁用或卸载 Nowledge Mem。如果你是手动复制本地插件目录安装的,先退出 Alma,再删除 ~/.config/alma/plugins/nowledge-mem。

安全地自定义

Alma 这条连接没有单独的插件级 override 文件。

  • 想做稳定的行为调整,优先使用 Alma 的插件设置,比如远程模式、回忆策略、对话捕获和 space
  • 如果你想让智能体的表达方式或保存偏好不同,优先走 Alma 自己的 Skills、prompt 或 instruction 入口,而不是改插件代码

不要为了一个小偏好去修改安装后的插件文件。完整对照表见 安全地自定义连接行为。

插件功能

功能说明
自动回忆每个线程的第一条外发消息发送前,自动注入工作记忆简报与相关记忆
13 个工具记忆:query、search、store、show、update、delete。线程:search、show、create、delete。另有 Context Bundle、工作记忆简报和状态诊断
随处访问在插件设置中配置 API URL + API Key,连接远程 Mem 实例
设置即时生效修改 API URL、API Key、回忆策略或自动捕获后立即生效,无需重启
状态诊断nowledge_mem_status 显示连接模式、服务器状态、CLI 可用性和当前配置
实时对话同步空闲几秒后、切换线程、退出应用时自动保存对话(默认开启)
原生 Alma Skill可选的 nowledge-mem Skill,用于在 Alma 的 Skills 页面中增强工具选择引导
本地优先使用本机 Nowledge Mem API;不启用 Access Anywhere 则无需联网

对话保存

对话在日常使用中自动同步到 Nowledge Mem:空闲几秒后、切换线程时、退出应用时都会触发保存,无需任何操作。保存的对话会出现在桌面端的"对话"页面,之后可以提炼为结构化记忆。可在插件设置中通过 autoCapture 关闭。

对话过程中,AI 也可能主动使用 nowledge_mem_store 工具将有价值的决策、结论或偏好保存为记忆。这是 AI 根据对话内容自主判断的:只有真正值得长期保留的信息才会被保存,日常闲聊不会被记录。

如果你想让 AI 保存某条信息,直接说"把这个存到记忆里"就行。

全库备份(可选)

若你需要 全部 Alma 对话的可携带归档(迁入新资料库、留存备查或更换设备),在 Alma 中使用 设置 → 数据 → 导出全部对话,会生成包含 threads.json 的 alma-backup-*.zip。

在 Nowledge Mem 中打开 对话 → 导入 → 导入账号历史 并选择该 ZIP。导入的对话来源标记为 alma,与插件实时同步一致,筛选与来源展示保持一致。其他批量格式与命令行说明见 导入已有对话 与 对话:批量导入。

随处访问

连接远程 Nowledge Mem 实例:

  1. 在 Alma 中打开设置 → 插件 → Nowledge Mem
  2. 设置 API URL 为远程服务器地址(如 https://mem.example.com)
  3. 设置 API Key 为你的 nmem_... 密钥
  4. 修改立即生效。使用 nowledge_mem_status 验证连接

API Key 从 Alma 插件设置中读取,并通过 Authorization: Bearer ... 请求头发送,不会被记录到日志。

Spaces

Alma 适合按 profile 保持一个稳定的记忆 lane。

  • 如果一个 Alma profile 本来就对应一个固定上下文,可以直接设置 nowledgeMem.space
  • 如果你的启动器已经能提供可靠的 lane 变量,可以使用 nowledgeMem.spaceTemplate
  • 如果这个 Alma 实例始终只服务一个 space,也可以直接用 NMEM_SPACE="Research Agent" 启动

如果 Alma 本身并不知道真实的 Agent 身份,就不要硬做“每个 Agent 自动分 space”的路由。此时更稳妥的做法是:一个 Alma profile 对应一个 space,或者继续留在 Default。

相关

On this page