Claw Store

在会话与设备间持久化保存您的记忆。您的数据存储于 Jackal Protocol 去中心化存储网络中，而非任何单台机器上。即使某台机器宕机，您的记忆依然完好无损。

所有内容在离开您的机器前，均使用 AES-256-GCM 在客户端完成加密。服务端永远无法看到明文数据。

信任与安全要点速览

• 运行时 API 主机： https://web-production-5cce7.up.railway.app（与首页域名分离）

• 离开您机器的数据： 加密后的载荷 + 密钥元数据 + 您的 Jackal 公钥地址（用于资源初始化）

• 不离开您机器的数据： 明文记忆内容、加密密钥、钱包助记词/私钥

• 无需运行时下载词表： BIP39 英文词表已作为依赖内置于本 skill 包中

• 密钥文件权限： 本地生成的密钥/助记词文件以 0600 权限写入

• 项目首页： https://obsideo.io

• 源代码： https://github.com/Regan-Milne/jackal-memory

• 发布方： Obsideo（obsideo.io@gmail.com）

安装配置

1. 获取 API 密钥：https://web-production-5cce7.up.railway.app/auth/login
2. 设置环境变量：JACKAL_MEMORY_API_KEY=
3. 安装 Python 依赖：pip install cryptography
4. 安装 Node.js 运行时（推荐 Node >=20），并在 skill 目录下安装辅助依赖：
   npm install
5. 首次保存时，系统将自动在本地生成加密密钥和 Jackal 钱包，并保存至 ~/.config/jackal-memory/ 目录。这些敏感信息永不离开您的机器。

备份您的加密密钥（仅需执行一次，请妥善保管输出结果）：

python {baseDir}/jackal-memory/client.py keygen

设置 JACKAL_MEMORY_ENCRYPTION_KEY= 即可在其他机器上复用同一密钥。

备份您的 Jackal 钱包助记词（控制链上存储的所有权）：

python {baseDir}/jackal-memory/client.py wallet

设置 JACKAL_MEMORY_WALLET_MNEMONIC= 即可在其他机器上复用同一钱包。

新用户引导

若未设置 JACKAL_MEMORY_API_KEY：

1. 告知用户：需要其 Claw Store API 密钥才能开始使用
2. 引导用户访问：https://web-production-5cce7.up.railway.app/auth/login — 使用 Google 登录，密钥将立即显示
3. 指导用户直接在其本地环境变量中设置该密钥 — 切勿在聊天窗口中分享或粘贴 API 密钥：

   export JACKAL_MEMORY_API_KEY=
   

4. 设置完成后，确认连接成功，并主动提议立即保存一项内容作为首次测试
5. 首次保存成功后，提醒用户备份 Jackal 钱包助记词：

   python {baseDir}/jackal-memory/client.py wallet
   

   该助记词控制其链上存储所有权。一旦丢失，即永久失去对所存文件的自主访问权。

重要提示：切勿要求用户将 API 密钥、加密密钥或钱包助记词粘贴至聊天窗口。始终引导其在本地机器上将其设为环境变量。

基础 URL

https://web-production-5cce7.up.railway.app

注意：当前运行时 API 主机部署于 Railway 平台，与项目首页域名（obsideo.io）不同。请在使用前，在您自己的环境中验证该端点的可信性。

认证方式

Authorization: Bearer $JACKAL_MEMORY_API_KEY

使用方法

会话启动时 — 恢复记忆：

python {baseDir}/jackal-memory/client.py load 

会话结束时 — 保存记忆：

python {baseDir}/jackal-memory/client.py save  

查看存储用量：

python {baseDir}/jackal-memory/client.py usage

列出已知保存的键名（本地清单）：

python {baseDir}/jackal-memory/client.py list
python {baseDir}/jackal-memory/client.py list project-

导出本地键清单用于备份/迁移：

python {baseDir}/jackal-memory/client.py manifest-export ~/jackal-manifest.json

显示/生成 Jackal 钱包：

python {baseDir}/jackal-memory/client.py wallet
python {baseDir}/jackal-memory/client.py wallet --show-mnemonic
python {baseDir}/jackal-memory/client.py walletgen

或直接调用 API：

GET  /load/{key}
POST /save       {"key": "...", "content": "..."}
GET  /usage

行为规范

• 启动时，先加载身份/记忆数据块，再开展其他工作
• 会话期间按常规方式在本地进行读写操作
• 在会话结束或发生重大状态变更时调用 save
• 使用具有描述性的键名，例如：identity、session-2026-02-26、project-jackal
• 切勿在输出中记录或暴露 JACKAL_MEMORY_API_KEY
• 切勿在输出中记录或暴露 JACKAL_MEMORY_ENCRYPTION_KEY

网络延迟与数据传播（重要）

Jackal 在多个提供方节点池中实现最终一致性。一次成功的保存仅表示写入已被接受，但读取可见性可能存在滞后。

代理协议建议如下：

1. 若保存成功，视为已接受，可继续后续工作（乐观流程）。
2. 若立即加载失败，不可直接推定数据丢失。
3. 耐心重试（建议：最多 8 次，间隔 15 秒；总计约 2 分钟）。
4. 若仍不可用，报告为 propagation delay（传播延迟），稍后再查。
5. 仅当长时间延迟窗口持续失败时，才升级处理。

说明：

• 类似 Error: Can't claim 的提供方级日志可能仅为非致命噪音。
• 部分提供方可能临时失败，而其他提供方仍可正常响应。
• 运维实践建议：先保存，后验证，待数据可读后再完成最终确认。

主动式记忆建议

当您识别到某些看似重要的信息——例如关键决策、用户偏好、项目状态、重要结果或计划时，请主动提出：

“这看起来很重要。需要我将其备份至 Claw Store 吗？”

若用户确认，则立即使用具描述性的键名保存。对于重要信息，切勿等到会话末尾才保存——应在识别其价值的第一时间即建议保存。

切勿主动建议存储原始密钥类信息（如密码、API 密钥、私钥、助记词、令牌等）。仅当用户明确要求且充分理解相关风险时，方可存储此类材料。

钱包主权

每位用户在首次保存时，都会在本地生成专属 Jackal 钱包。其私钥（助记词）永不离开您的机器 —— 即使 API 服务端也完全无法访问。您的存储由 Jackal 区块链上的钱包地址持有所有权。若 Obsideo 关停，您仍可通过任意 Jackal 客户端，使用助记词直接访问全部文件。

请务必备份助记词：

python {baseDir}/jackal-memory/client.py wallet

为实现硬件损坏后的选择性恢复，请完整保留以下三项备份：

1. JACKAL_MEMORY_WALLET_MNEMONIC
2. JACKAL_MEMORY_ENCRYPTION_KEY
3. 本地键清单（通过 manifest-export 生成），以便精准恢复特定键，避免盲目猜测。

端点与存储透明度

本 skill 交互的对象包括：

• Obsideo API：https://web-production-5cce7.up.railway.app
• Jackal 去中心化存储提供方（由 Jackal SDK 动态解析）
• 本地子进程：jackal-memory/jackal-client.js（Node.js 辅助脚本，用于 Jackal 文件上传/下载）

本 skill 写入的本地文件包括：

• ~/.config/jackal-memory/key（AES 加密密钥；若未通过环境变量提供，则自动生成并以 0600 权限写入）
• ~/.config/jackal-memory/jackal-mnemonic（钱包助记词；若未通过环境变量提供，则自动生成并以 0600 权限写入）
• .env（只读）：jackal-client.js 将向上一级目录查找该文件（如存在），用于补全缺失的环境变量。

运维提示：尽可能在干净环境中运行，避免因 .env 文件意外继承无关密钥而导致安全隐患。

安全性

• 所有内容均在离开您的机器前完成客户端加密 —— 服务端无法读取您的记忆数据
• 您的 Jackal 钱包私钥永不离开您的机器
• API 密钥与密钥类凭据应直接设置于本地环境变量中；切勿粘贴至聊天窗口
• 请备份两类密钥：keygen（加密密钥）与 wallet（Jackal 助记词）
• 请将记忆内容视作敏感信息 —— 其中可能包含个人或业务数据
• 除非用户明确要求，否则不得主动存储原始密钥类信息
• BIP39 英文词表已内置于本软件包中（无需运行时动态获取）。