MemClawz Connect

一个技能。任意智能体。共享记忆。

设置

bash
export MEMCLAWZURL=http://localhost:3500 # 或远程地址：http://YOURSERVER:3500
export MEMCLAWZAGENTID=my-agent # 每个智能体唯一

默认安装无需 API 密钥。如果启用了身份验证，还需设置 MEMCLAWZAPIKEY。

健康检查

bash
curl -s $MEMCLAWZ_URL/health

{status:ok,version:...,qdrant:connected}

智能体协议

执行任何任务前 — 先搜索

bash
curl -s $MEMCLAWZ_URL/api/v1/search?q=主题&limit=5

响应：

json
{results: [{content: ..., agentid: quant-dev, memorytype: decision, score: 0.92}]}

在开始工作前将结果作为上下文使用。避免重复发现已知信息。

完成任务后 — 写回

bash
curl -s -X POST $MEMCLAWZ_URL/api/v1/add \
-H Content-Type: application/json \
-d {
content: 已部署 v2.0 — 修复了刷新时互斥锁导致的认证竞态条件,
agentid: $MEMCLAWZAGENT_ID,
memory_type: event
}

记忆类型

类型	使用场景
fact	发现的信息（端点、版本、配置）
decision

做出的选择（架构、方法、工具选择） | | procedure | 完成某事的方式（部署步骤、构建过程） | | event | 发生的事件（部署了 X，修复了 Y，发布了 Z） | | insight | 经验教训（哪些有效，哪些无效） | | intention | 计划中的行动 | | commitment | 做出的承诺 | | action | 已采取的行动 | | outcome | 行动的结果 |

统计信息

bash
curl -s $MEMCLAWZ_URL/api/v1/stats

列出智能体

bash
curl -s $MEMCLAWZ_URL/api/v1/agents

获取记忆

bash
curl -s $MEMCLAWZURL/api/v1/memories?agentid=$MEMCLAWZAGENTID&limit=50

AGENTS.md 集成

追加到智能体的 AGENTS.md 文件中：

markdown

MemClawz 共享记忆

集群记忆 API：$MEMCLAWZ_URL/api/v1

执行任何任务前：

搜索共享记忆以获取相关上下文： curl -s $MEMCLAWZ_URL/api/v1/search?q=<任务关键词>&limit=5

完成任何重要工作后：

将结果写入共享记忆： curl -s -X POST $MEMCLAWZ_URL/api/v1/add \ -H Content-Type: application/json \ -d {content: <已完成的工作>, agentid: $MEMCLAWZAGENTID, memorytype: <类型>}

远程智能体

对于位于不同服务器上的智能体，只需将 MEMCLAWZ_URL 从 localhost:3500 改为主服务器的 IP/主机名：

bash
export MEMCLAWZ_URL=http://76.13.154.71:3500

其他所有内容保持不变。