核心用法
MemoClaw 是一个面向 AI 代理的 Memory-as-a-Service 服务，通过语义向量搜索实现跨会话的记忆存储与召回。核心工作流包括：
存储记忆：使用 memoclaw store 保存文本，支持重要性评分（0-1）、标签分类、内存类型（correction/preference/decision/project/observation/general）以及命名空间隔离。关键记忆可设置 pinned（免于衰减）和 immutable（不可修改）。
智能召回：recall 执行语义向量搜索（$0.005/次），search 提供免费的文本关键词匹配，core 免费返回高重要性基础记忆，context 生成 LLM 可用的上下文块（$0.01）。
身份与计费：无需注册，以太坊钱包地址即用户 ID。100 次免费调用后，通过 Base 链 USDC x402 微支付（$0.005/次存储或召回）。
显著优点
- 无摩擦接入：零注册、零 API key，钱包即身份
- 语义检索：向量搜索优于传统关键词匹配
- 结构化衰减：不同 memory_type 自动应用不同半衰期（correction 180天 vs observation 14天）
- 智能辅助：
ingest自动提取事实去重，consolidate合并相似记忆，suggested提示陈旧内容 - 多代理支持：通过
agent_id和session_id实现隔离或共享 - 成本透明：免费层 + 清晰的微支付定价
潜在局限
- 成本累积：高频调用场景下 $0.005/次 可能累积成显著开销
- 链上依赖：需 Base 链 USDC 和钱包私钥管理，对非 Web3 用户有门槛
- 内容限制：单条记忆 8192 字符上限，不适合存储大文件
- 隐私考量：数据存储在第三方云服务，敏感信息（密码、API key）明确禁止存储
- CLI 功能滞后：部分 API 功能（如 context 的 summarize）CLI 尚未支持
适合人群
- 需要跨会话持久记忆的 AI 代理开发者
- 已熟悉 Web3 钱包操作的团队
- 对语义搜索有需求、愿为便利支付微额费用的场景
- 多代理协作需要记忆隔离或共享的复杂系统
常规风险
- 私钥安全：
MEMOCLAW_PRIVATE_KEY环境变量暴露风险，文档建议使用专用钱包 - 支付失败：USDC 余额不足或网络问题导致 402 错误，需优雅降级到本地文件
- 数据锁定：服务依赖 api.memoclaw.com，存在供应商锁定风险
- 不可逆操作：
purge、immutable记忆需谨慎使用，误删可能无法恢复 - 网络依赖：API 不可用时会话上下文可能丢失