Memoclaw Skill

核心功能

MemoClaw 是为 AI 智能体设计的 Memory-as-a-Service 服务，提供跨会话的持久化记忆存储与语义检索能力。核心特性包括：

• 钱包即身份：无需注册，以太坊钱包地址直接作为用户 ID，通过私钥签名完成认证
• 语义向量搜索：基于嵌入向量的相似度检索，支持自然语言查询而非仅关键词匹配
• 分级定价：100次免费调用/钱包，后续通过 x402 协议以 USDC 在 Base 链上微支付
• 智能记忆管理：支持重要性评分（0-1）、类型标记（correction/preference/decision 等）、命名空间隔离、自动衰减与合并

显著优点

1. 零摩擦接入：无 API 密钥、无账户系统，30 秒完成 memoclaw init 即可使用
2. 成本可控：免费 tier 覆盖基础测试，付费操作最低 $0.005/次，批量操作 $0.04/100条
3. 智能检索策略：core（免费高优先级记忆）→ search（免费关键词）→ recall（语义搜索 $0.005）→ context（LLM 组装块 $0.01），按需升级
4. 丰富的记忆生命周期管理：pin（防衰减）、lock（防篡改）、relations（关联记忆）、consolidate（去重合并）、snapshot（本地备份）
5. 多智能体支持：通过 --agent-id 和 --session-id 实现隔离或共享

局限与风险

• 私钥依赖：需 MEMOCLAW_PRIVATE_KEY 环境变量，存在密钥泄露风险，建议使用专用钱包
• 内容限制：单条记忆 8192 字符上限，超长内容需拆分
• 网络依赖：API 故障时需降级到本地文件，存在服务可用性风险
• 不可逆操作：purge、consolidate 等操作破坏性较强，需配合 snapshot 使用
• 语义搜索黑箱：向量相似度阈值需调优，可能出现召回不足或无关结果

适合人群

• 构建长期对话型 AI 应用的开发者
• 需要跨会话记忆的多智能体系统
• 希望快速原型验证、不愿自建向量数据库的团队
• 熟悉 Web3 钱包操作、能接受链上支付模式的用户

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 密钥泄露 | 私钥明文存储于环境变量或配置文件 | 使用专用钱包、限制文件权限、考虑硬件钱包签名 |

| 意外扣费 | 免费额度耗尽后自动进入付费模式 | 运行 `memoclaw status` 监控余额，设置消费上限 |

| 数据丢失 | 误执行 `purge --force` 或 `consolidate` | 操作前 `snapshot create`，关键记忆 `pin` + `lock` |

| 隐私泄露 | 敏感信息（偏好、决策）存储于第三方 | 绝不存储密码/密钥，敏感内容本地加密 |

| 供应商锁定 | 深度依赖后迁移成本高 | 定期 `export` 备份，保持本地文件双写 |

成本优化建议

优先使用免费命令（core, search, list）筛选，仅在语义理解必需时调用 recall；利用 --since 7d 限制时间范围减少无效召回；批量操作使用 store --batch 降低单位成本。

核心功能

MemoClaw 是一种 Memory-as-a-Service 解决方案，专为 AI 代理设计，解决上下文窗口有限、会话间记忆丢失的痛点。核心能力包括：

存储与检索：支持文本存储、语义向量搜索（recall）、关键词搜索（search）、以及 LLM 就绪的上下文组装（context）。采用向量嵌入技术实现"用户之前说过什么关于 X"这类模糊查询。

记忆管理：提供丰富的元数据系统——importance 评分（0.1-1.0）、memory_type 分类（correction/preference/decision/project/observation/general）、标签系统、namespace 隔离、pin/lock 状态控制、以及记忆间关系（supersedes/contradicts/supports）。

经济模型：零注册门槛，钱包地址即身份。100 次免费 API 调用后，通过 x402 协议进行 USDC 微支付（Base 网络），存储/召回 $0.005，高级功能 $0.01。

显著优点

1. 协议级创新：x402 支付标准实现无账户、无预付费的即用即付，大幅降低采用门槛
2. 检索灵活性：免费关键词搜索 + 付费语义搜索 + LLM 上下文组装的阶梯式检索，兼顾成本与效果
3. 记忆衰减设计：按类型自动半衰期（correction 180天 → observation 14天），避免记忆膨胀
4. 多代理就绪：agent_id 和 session_id 作用域支持，namespace 逻辑隔离
5. 抗审查性：Web3 身份意味着无平台封禁风险，数据所有权归用户

局限与风险

技术依赖：完全依赖外部 API（api.memoclaw.com），无本地降级方案。API 故障时记忆系统瘫痪，文档建议"回退到本地文件"但增加实现复杂度。

成本不可预测：语义搜索的 $0.005/次在高频场景下累积迅速。文档提供的"free-first"优化模式（先 core/search 再 recall）需要开发者严格遵守。

隐私悖论：虽然声称"不存储密钥"，但 memory_content 本身可能包含敏感信息（用户偏好、项目细节），传输至第三方服务存在合规风险。GDPR/CCPA 合规状态标记为 pass，但实际依赖 MemoClaw 服务端的数据处理。

T3 来源风险：个人开发者维护（anajuliabit），无基金会背书。CLI 工具闭源（npm 分发），无法进行代码审计。文档存在多处"CLI 不支持但 API 支持"的功能缺口。

生态锁定：记忆数据导出为 JSON 虽可行，但向量嵌入依赖 MemoClaw 的嵌入模型，迁移至其他服务需重新生成嵌入。

适用人群

• 需要跨会话 persistent memory 的 AI 代理开发者
• 愿意承担 Web3 钱包管理复杂性的技术团队
• 对"无账户即服务"模式接受度高的实验性项目
• 有成本监控能力的生产环境（需跟踪 $0.005-$0.01 的微支付累积）

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| API 服务中断 | 中 | 记忆系统完全依赖外部服务，需设计降级策略 |

| 私钥泄露 | 高 | MEMOCLAW_PRIVATE_KEY 泄露导致钱包资金风险 |

| 成本失控 | 中 | 高频 recall/context 调用累积费用 |

| 数据残留 | 低 | 服务端删除确认机制未明确文档化 |

| 版本兼容性 | 低 | CLI 与 API 功能不同步（如 search 端点变更）|