核心功能
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 降低单位成本。