中子记忆

您的智能体进行的每一次对话、偏好设置和决策都能在多个会话中持续保存。保存重要的内容，当您需要时，语义搜索能根据含义（而非关键词）找到正确的上下文。每一次会话都建立在之前的基础上。

工作原理

手动模式— 使用简单命令进行保存和搜索：

1. ./scripts/neutron-memory.sh save "user prefers dark mode" "Preferences"— 保存上下文
2. ./scripts/neutron-memory.sh search "what theme does the user like"— 通过含义查找

自动模式（需手动启用）— 启用钩子功能以自动捕获和调用记忆：

1. 自动捕获在每次AI响应后自动保存对话内容
2. 自动调用在每次AI响应前自动查找相关记忆并注入为上下文

快速开始

请参阅SETUP.md查看完整安装指南。简而言之：

1. 获取免费API密钥请访问https://openclaw.vanarchain.com/（赠送20美元额度，无需信用卡）
2. export API_KEY=nk_your_key
3. ./scripts/neutron-memory.sh test

命令

保存

./scripts/neutron-memory.sh save "Content to remember" "Title"

搜索

./scripts/neutron-memory.sh search "what do I know about X" 10 0.5

参数：查询内容 数量限制 相似度阈值(0-1)

诊断

./scripts/neutron-memory.sh diagnose

检查所有先决条件：curl、jq、API密钥、网络连接及身份验证。

钩子（自动捕获与自动召回）

• hooks/pre-tool-use.sh—自动召回：在AI响应前查询记忆，注入相关上下文
• hooks/post-tool-use.sh—自动捕获：在AI响应后保存对话内容

两者都默认禁用（仅限选择启用）。启用方法：

export VANAR_AUTO_RECALL=true
export VANAR_AUTO_CAPTURE=true

API端点

• POST /memory/save— 保存文本（multipart/form-data）
• POST /memory/search— 语义搜索（JSON主体）

认证： Authorization: Bearer $API_KEY— 仅此而已。无需其他凭证。

安全与隐私

除非您执行命令或显式启用自动捕获/自动召回功能，否则不会发送任何数据。两个钩子默认都是禁用的。

此技能仅将您显式保存的数据（或选择启用的自动捕获的对话）发送到Neutron API。具体流程如下：

不发送的内容：

• 不读取或上传本地文件
• 不发送环境变量（用于身份验证的API密钥除外）
• 不发送系统信息、文件路径或目录内容
• 不发送来自其他工具或技能的数据

所有通信均通过HTTPS发送至api-neutron.vanarchain.com。源代码在脚本/和钩子/目录——三个简短的bash脚本，没有编译后的二进制文件。