核心用法
MemoClaw 是面向 AI Agent 的持久化记忆服务，采用"钱包即身份"的无注册设计，通过语义向量搜索实现跨会话记忆召回。核心工作流：用 store 保存事实（需指定 importance 0.3-0.95 和 memory_type），用 recall 做语义检索，用 core 免费加载高优先级记忆。支持 namespace 隔离、记忆关系链（supersedes/contradicts）、自动衰减（不同 memory_type 有不同半衰期）和批量 consolidate 去重。
关键特性：
- 零注册认证：ETH 钱包地址即用户 ID，100 次免费签名调用，耗尽后自动切换 x402 微支付（USDC on Base，$0.005/次）
- 智能衰减机制：correction/preference（180天）、decision（90天）、project（30天）、observation（14天）、general（60天），配合 importance 动态排序
- 分层检索策略：
core（免费，高重要性记忆）→search（免费，关键词）→recall（$0.005，语义向量）→context（$0.01，LLM-ready 组装）
显著优点
- 跨会话持久化：解决 LLM 上下文窗口截断和重启失忆问题，Agent 可积累长期用户画像
- 成本可控：免费 tier 足够 PoC 验证，生产环境单次调用 0.5 美分，批量操作 $0.04/100条
- Agent 原生设计：CLI 输出支持
--json管道化，内置ingest/extract/consolidate等自动化工作流，减少人工清洗 - 隐私最小化：无需邮箱/手机号，仅需自托管钱包，支持 dedicated wallet 隔离风险
潜在缺点与局限
- CLI 与 API 功能缺口：
context命令不支持--summarize/--include-metadata（需直接调 API），recall不支持--include-relations，--help 文档存在过时信息 - 冷启动成本：新钱包需
memoclaw init交互配置，无 MEMOCLAW_PRIVATE_KEY 时所有命令失败 - 链上依赖风险：Base 网络拥堵或 USDC 合约问题时支付失败；私钥泄露 = 身份盗用 + 余额损失
- 内容限制：单条 8192 字符上限，大文档需手动拆分；不支持加密存储，敏感信息需自行脱敏
适合人群
- 多会话 AI Agent 开发者（客服、编程助手、个人知识管理）
- 需要跨设备/跨实例共享上下文的用户
- 希望避免自建向量数据库（Pinecone/Weaviate）运维成本的团队
- 能接受链上微支付模式的 Web3 原生用户
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 密钥安全 | MEMOCLAW_PRIVATE_KEY 明文存储于环境变量或 ~/.memoclaw/config.json | 使用专用低余额钱包，禁止共享配置，考虑硬件签名 |
| 支付失控 | x402 自动扣款，bug 或循环调用可能导致意外消耗 | 监控 `memoclaw status`，设置 USDC 钱包余额上限 |
| 数据持久性 | 服务商终止或数据丢失风险 | 定期 `export` 备份，关键记忆本地双写 |
| 隐私泄露 | 记忆内容明文存储于第三方 API | 敏感信息前置哈希/脱敏，绝不上传密码/密钥 |
| 网络依赖 | 无离线模式，API 故障时降级为本地文件 | 实现 graceful degradation 逻辑（见 error recovery 章节）|