Auto Memory — 自动内存

Auto-Memory 技能 在 Autonomys 网络上实现永久去中心化内存，采用链表内存链来实现代理重生。支持由 Claude、GPT、Gemini 和任何支持 OpenClaw 技能的 LLM 提供支持的代理。

该技能的功能 上传文件到 Auto Drive 并获取 CID（内容标识符）——Autonomys 分布式存储网络上的永久、不可变地址。 使用 CID 从 Auto Drive 下载文件——如果设置了密钥，则使用认证的 API，否则回退到公共网关。 将记忆保存为链表——每个记忆条目都是一个 JSON 体验，包含一个 header.previousCid 指针，形成永久存储在链上的链表。 从链表中重生——给定最新的 CID，逆向遍历链表以重建完整的代理历史。

何时使用此技能 用户说“将此保存到 Auto-Memory”或“上传到 Autonomys”或“永久存储” 用户说“从 Auto-Memory 下载”或提供 CID 以检索 用户说“保存记忆”、“永久记住”或“检查点” 用户说“重生”、“回忆链”、“重建记忆”或“加载历史” 任何时候用户想要在去中心化网络上永久且不可变地存储数据

安装后 通过 ClawHub 安装后，执行以下命令使脚本可执行：chmod +x skills/auto-memory/scripts/*.sh ClawHub 目前不保留安装期间的文件权限。

配置 API 密钥 需要 AUTO_DRIVE_API_KEY。运行引导式设置脚本以获得最简单的路径：scripts/setup-auto-memory.sh 此脚本在浏览器中打开 explorer.ai3.storage，提示输入密钥，保存到 ~/.openclaw/.env，并验证连接。 手动设置： 导航到 https://explorer.ai3.storage（不是 ai3.storage ——那只是登录页面） 检查身份验证：如果侧边栏显示“登录”按钮或我的文件/个人资料/开发人员上的锁定图标，则表示您尚未登录 AI 代理注意事项：您无法自己完成 OAuth。为用户打开浏览器并要求他们通过 Google、GitHub 或 Discord 登录。 一旦用户确认他们已登录，请接管——或简单地要求用户直接粘贴 API 密钥 一旦身份验证，单击左侧边栏中的“开发人员” 单击“创建 API 密钥”并复制生成的密钥 然后通过以下方式设置密钥： 环境：export AUTO_DRIVE_API_KEY=your_key_here OpenClaw 配置：skills.entries.auto-memory.apiKey API 密钥对于上传、保存记忆和回忆记忆链是必需的。对于一般文件下载来说，它是可选的——如果没有它，将使用公共网关，文件将以存储形式返回（即压缩文件不会被解压缩）。

核心操作 上传文件 scripts/automemory-upload.sh [--json] [--compress] 使用 3 步上传协议（单个块）将文件上传到 Auto Drive 主网。 在标准输出上返回 CID。 需要 AUTO_DRIVE_API_KEY。 --json —— 强制 MIME 类型为 application/json --compress —— 启用 ZLIB 压缩 下载文件 scripts/automemory-download.sh [output_path] 通过 CID 下载文件。 如果设置了 AUTO_DRIVE_API_KEY，则使用认证的 API（解压缩服务器端），否则使用公共网关（文件以存储形式返回）。 如果省略 output_path，则输出到标准输出。 保存记忆条目 scripts/automemory-save-memory.sh [--agent-name NAME] [--state-file PATH] 创建具有 Autonomys 代理标头/数据结构的记忆体验： { “header”：{ “agentName”：”my-agent”， “agentVersion”：”1.0.0”， “timestamp”：”2026-02-14T00:00:00.000Z”， “previousCid”：”bafk... 或 null” }, “data”：{ “type”：”memory”， “content”：”...” } } 如果第一个参数是文件路径，则其 JSON 内容成为数据有效载荷。 如果第一个参数是普通字符串，则将其包装为 {“type”：”memory”，“content”：”...”}。 --agent-name —— 在标头中设置代理名称（默认：openclaw-agent 或 $AGENT_NAME） --state-file —— 覆盖状态文件位置 上传到 Auto Drive 并更新状态文件中的新头 CID。 还将最新的 CID 固定到工作空间中的 MEMORY.md 文件（如果存在）。 在标准输出上返回结构化 JSON：{“cid”：”bafk...”，“previousCid”：”bafk...”，“chainLength”：5} 回忆完整的链表 scripts/automemory-recall-chain.sh [cid] [--limit N] [--output-dir DIR] 如果没有提供 CID，则从状态文件中读取最新的 CID。 从最新到最旧遍历链表，输出每个体验作为 JSON。 --limit N —— 最大条目数（默认：50） --output-dir DIR —— 将每个条目保存为编号的 JSON 文件，而不是打印到标准输出 同时支持 header.previousCid（Autonomys 代理格式）和根级 previousCid 以实现向后兼容。 这是重生机制：新的代理实例只需要一个 CID 即可重建其整个记忆。

重生概念 每个保存的记忆都得到一个唯一的 CID，并指向前一个记忆，形成永久的链表，存储在永久且不可变的去中心化存储网络上： ┌