核心用法
MemoClaw 提供"Memory-as-a-Service"服务,让 AI agent 获得跨会话的持久记忆能力。用户无需注册账号或管理 API key,以太坊钱包地址即身份标识。基础操作包括:
- 存储记忆:
memoclaw store "内容"($0.005),支持 importance 评分(0.3-0.95)、标签、命名空间、6种记忆类型(correction/preference/decision/project/observation/general) - 语义检索:
memoclaw recall "查询"($0.005)基于向量相似度;memoclaw search "关键词"(免费)基于文本匹配 - LLM上下文:
memoclaw context "需求"($0.01)自动组装适合注入 prompt 的记忆块 - 免费命令:list、core、search、whoami、status、pin/unpin、lock/unlock、diff 等管理操作
显著优点
1. 零摩擦接入:无需注册、API key 或信用卡,钱包签名即可开始,100次免费额度降低试用门槛
2. 语义理解:基于向量嵌入的 recall 支持自然语言查询(如"用户上次提到的数据库选择"),超越关键词匹配
3. 经济模型透明:x402 微支付每调用 $0.005,成本可预测;免费命令与付费命令界限清晰
4. 记忆生命周期管理:6种 memory_type 自带衰减半衰期(correction 180天→observation 14天),配合 importance 评分实现智能优先级
5. 多维度组织:namespace(项目隔离)、tags(分类)、relations(记忆关联如 supersedes/contradicts)、pinned/lock 状态
6. 批量与自动化:ingest(自动提取事实)、consolidate(合并相似记忆)、migrate(导入 markdown)、watch(实时监控流)
潜在缺点与局限性
1. 成本累积风险:高频场景(如每轮对话都 recall)100次免费额度快速耗尽,后续 $0.005/次在密集使用时月度成本可能达数十美元
2. 网络依赖:完全云端服务,API 故障时无本地缓存机制,文档建议"fall back to local files"但实际增加了复杂度
3. 隐私顾虑:所有记忆存储于第三方服务器,虽有 wallet 身份隔离但无端到端加密说明,敏感信息需自托管替代方案
4. 内容长度限制:单条记忆 8192 字符,大文档需手动分割
5. USDC on Base 门槛:付费阶段要求用户持有特定链上稳定币,对非加密用户构成摩擦
6. CLI 与 API 功能差距:部分 API 参数(如 context 的 summarize、include_metadata)CLI 尚未支持
适合人群
- AI agent 开发者:需要为 LLM 应用添加长期记忆,但不愿自建向量数据库(Pinecone/Weaviate)和 embedding 管道
- 多会话对话系统:客服机器人、个人助理等需要记住用户偏好跨会话持续的场景
- 加密原生用户:已熟悉钱包签名和 L2 支付的开发者,x402 支付模型契合其技术栈
- 快速原型验证:100次免费额度适合 MVP 阶段测试记忆功能有效性
常规风险
- 私钥安全:MEMOCLAW_PRIVATE_KEY 环境变量泄露导致钱包资金被盗(文档强调"use a dedicated wallet")
- 402 支付中断:余额不足时所有付费调用失败,可能中断用户体验
- 数据锁定:无标准导出格式说明,迁移至其他系统可能存在摩擦
- 供应商锁定:语义嵌入模型、衰减算法、评分机制均为黑盒,难以迁移至自托管方案