核心用法
MemoClaw 是面向 AI 代理的 Memory-as-a-Service 服务，通过 CLI 工具 memoclaw 实现跨会话的持久化记忆存储与语义召回。核心工作流遵循"先召回、后存储"原则：使用 recall 进行语义向量搜索（$0.005/次），使用 store 保存关键事实（$0.005/次），使用 core 加载高重要性基础记忆（免费）。支持按重要性评分（0.3-0.95）、记忆类型（correction/preference/decision/project/observation/general）和命名空间进行精细化组织。
显著优点
1. 无摩擦准入：无需 API Key 或注册，钱包地址即身份，100 次免费调用后自动切换至 x402 微支付（USDC on Base，$0.005/次）。
2. 语义原生：内置向量嵌入与语义搜索，超越传统关键词匹配，支持"用户说过关于 X 的什么"类模糊查询。
3. 智能生命周期管理：记忆类型自动关联衰减半衰期（correction 180 天至 observation 14 天），支持 pin/lock 机制保护关键信息。
4. 多代理隔离：通过 agent_id 和 session_id 实现同钱包下的代理级/会话级数据隔离。
5. 丰富的结构化操作：提供 ingest（自动提取去重）、consolidate（合并相似记忆）、relations（记忆关联图谱）等高级功能。
潜在局限与风险
1. 成本累积：高频场景下（如每轮对话都 recall）费用可观，需严格遵循"免费命令优先"策略（core/search/list 等免费）。
2. 网络依赖：服务中断时需降级至本地文件，存在短暂状态不一致风险。
3. 私钥管理：MEMOCLAW_PRIVATE_KEY 环境变量暴露即资产风险，要求使用专用钱包。
4. 内容限制：单条记忆 8192 字符上限，超大内容需手动分片。
5. CLI 与 API 功能差距：部分 API 参数（如 context 的 summarize、include_metadata）尚未暴露至 CLI。
适合人群
- 需要跨会话长期记忆的 AI 代理开发者
- 多项目并行、需命名空间隔离的场景
- 希望避免自建向量数据库运维负担的团队
- 已熟悉 Web3 钱包操作的技术用户
常规风险提示
- 严禁存储敏感凭证：密码、API Key、Token 等绝对禁止入库
- immutable 记忆不可撤销：lock 后的记忆永久不可修改删除
- purge 操作危险：无命名空间限定将清空全部记忆，建议先执行 snapshot
- 免费额度监控：定期运行
memoclaw status避免意外触发付费