用途:本技能用于 MemClaw 的安装、配置、故障排查与维护。日常的记忆搜索、浏览与存储等操作应使用 memclaw 技能,涉及 cortex_search、cortex_ls、cortex_add_memory 等工具时 likewise 参考该技能文档。
安装步骤:第一步安装插件,执行 openclaw plugins install @memclaw/memclaw。第二步启用插件,在 openclaw.json 中启用 memclaw 并关闭 memorySearch。第三步配置 API 密钥,需填写 LLM 与 Embedding 相关字段,如 llmApiKey、llmApiBaseUrl、llmModel、embeddingApiKey、embeddingApiBaseUrl、embeddingModel;密钥以 sensitive 标记存储,请勿公开分享 openclaw.json。第四步重启 OpenClaw 使配置生效。
安装校验:重启后插件自动启动所需服务。Qdrant 使用 6333(HTTP)与 6334(gRPC)端口,访问 http://localhost:6333 应返回版本信息;cortex-mem-service 使用 8085 端口,访问 http://localhost:8085/health 应返回 {"status":"ok"}。MemClaw 不要求用户安装 Docker,依赖在插件安装时准备。
记忆迁移:若已有 OpenClaw 原生记忆,可调用 cortex_migrate 迁移,它会查找 memory/*.md 与 MEMORY.md,转换为 MemClaw 的 L2 格式并生成 L0/L1 层与向量索引,初始设置时仅运行一次。
维护:可调用 cortex_maintenance 做周期性维护,参数示例为 dryRun 为 false、commands 为 prune、reindex、ensure-all。prune 删除源文件已不存在的向量;reindex 重建向量索引并清理失效条目;ensure-all 生成缺失的 L0/L1 层文件。该工具通常由 Cron 任务自动调用,手动调用用于排查或按需维护。
数据管理:数据按平台存储于 macOS 的 ~/Library/Application Support/memclaw、Windows 的 %LOCALAPPDATA%\memclaw、Linux 的 ~/.local/share/memclaw。迁移前会保留原有 OpenClaw 记忆文件,所有记忆数据均存储在本地,不做云同步。
安全与信任:插件将记忆数据存储在本地用户数据目录,迁移时仅读取现有 OpenClaw 记忆文件;不会将 API 密钥传输到已配置的 LLM/Embedding 提供商以外的任何位置。
限制:MemClaw 使用需要配置 API 密钥;本资料未提供收费、价格与效果数据,暂未提供。