核心用法
MemoClaw 是一款面向 AI 代理的 Memory-as-a-Service 服务，允许代理跨会话存储和召回文本记忆。核心工作流程分为三层：
存储记忆：使用 memoclaw store 保存事实，支持 importance（0.3-0.95）、memory-type（6种类型对应不同衰减周期）、tags 和 namespace 等元数据。关键命令包括批量存储（--batch）、文件导入（--file）、以及智能提取（ingest、extract）。
召回记忆：提供免费与付费两种检索路径。免费层包括 core（高重要性记忆）、search（关键词搜索）；付费层包括 recall（语义向量搜索，$0.005）和 context（LLM 格式化输出，$0.01）。推荐策略：优先使用免费命令，仅在必要时启用语义搜索。
管理记忆：支持 pin（防衰减）、lock（不可变）、update/edit、copy/move、consolidate（去重合并）、以及关系图谱（relations、graph）等高级功能。
显著优点
- 无摩擦身份：钱包地址即用户 ID，无需注册、API 密钥或账号管理
- 渐进式付费：100 次免费调用后启用 x402 微支付（$0.005/次），成本透明可控
- 语义召回：原生向量搜索，解决关键词匹配无法处理的模糊查询
- 智能衰减：6 种 memory-type 预设半衰期（14-180 天），自动清理低价值记忆
- 多代理隔离：通过
agent_id和session_id支持多代理共享钱包的同时保持上下文隔离 - 丰富元数据：importance 评分、标签系统、命名空间、关系图谱，形成结构化记忆网络
潜在局限
- 网络依赖：完全依赖 api.memoclaw.com，离线时无法工作，需降级到本地文件
- 内容限制：单条记忆 8192 字符上限，超长内容需手动拆分
- CLI 成熟度：部分 API 功能（如
context --summarize）尚未暴露为 CLI 参数 - 学习成本：importance 评分、memory-type 选择、命名空间策略需要一定实践才能掌握
- 隐私边界：明确禁止存储密码/API 密钥，敏感信息仍需额外管理方案
适合人群
- 需要跨会话保持上下文的 AI 代理开发者
- 厌倦维护本地 markdown 记忆文件的多代理系统
- 希望用语义搜索替代笨重关键词匹配的对话式 AI 应用
- 愿意接受微支付模式以换取免运维托管服务的团队
常规风险
- 私钥管理：
MEMOCLAW_PRIVATE_KEY环境变量需严格保护，建议使用专用钱包 - 支付溢出：
recall无结果时仍计费，批量操作前应用--dry-run验证 - 不可逆操作：
purge、consolidate破坏性操作前务必snapshot create - 网络中断：API 故障时需优雅降级到本地文件，避免阻塞用户交互