AgentMM — 记忆与日志管理

---

name: agentmm

version: 1.0.1

description: "AgentMM memory & log management skill — gives AI agents persistent memory storage and structured logging. Use when the user asks to remember information, recall memories, or record/query logs. Requires env var AGENTMM_API_KEY (format: amm_sk_xxx)."

homepage: https://github.com/cers-ai/agentmm-skills

metadata:

clawdbot:

emoji: "🧠"

requires:

env:

- AGENTMM_API_KEY

binaries:

- curl

- jq

primaryEnv: AGENTMM_API_KEY

files:

- "scripts/*"

---

# AgentMM — 记忆与日志管理

认证配置

本技能通过环境变量读取凭证，**不在任何文件中存储密钥**：

# 必须设置（格式：amm_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
export AGENTMM_API_KEY="amm_sk_your_key_here"

# 可选，默认为 https://api.agentmm.site
export AGENTMM_API_BASE="https://api.agentmm.site"

所有脚本启动时会自动读取这两个变量，若 `AGENTMM_API_KEY` 未设置则报错退出。

功能概览

🧠 记忆系统

📋 日志系统

支持的操作

记忆操作

日志操作（使用 `agentmm` CLI）

使用说明

所有脚本位于 `scripts/` 目录，可通过 `exec` 工具调用或直接在命令行运行。

记忆脚本

#### write_memory.sh

写入或更新一条记忆。

export AGENTMM_API_KEY="amm_sk_your_key"
./scripts/write_memory.sh \
  --key "project_x_meeting_20260315" \
  --content "讨论了 Q2 路线，决定优先做 feature A" \
  --tags "project,meeting,roadmap" \
  --context "Q2 planning session"

参数：

#### read_memory.sh

查询记忆。

参数：

#### search_memory.sh

关键词搜索记忆。

参数：

#### update_memory.sh

更新已有记忆。

参数：

#### forget_memory.sh

遗忘（软删除）一条记忆。

参数：

#### get_memory_stats.sh

查看记忆库统计概览（总条数、活跃条数、嵌入覆盖率等）。

日志操作（统一 CLI）

使用 `scripts/agentmm` 统一命令操作日志：

export AGENTMM_API_KEY="amm_sk_your_key"

# 写入日志
./scripts/agentmm log write --level info --title "任务完成" --content "详细过程" --task-id task_abc

# 查询日志
./scripts/agentmm log list --level error --limit 20

# 查看统计
./scripts/agentmm log stats

安装

clawhub install agentmm

或手动克隆后复制到 skills 目录：

git clone https://github.com/fangwei/agentmm-skills
cp -r agentmm-skills ~/.openclaw/skills/agentmm

注意事项

---

External Endpoints

本技能调用以下外部端点。所有请求均通过 HTTPS 加密传输，并携带 `Authorization: Bearer` 头进行认证。

| 端点 | 方法 | 发送数据 | 说明 |

|---|---|---|---|

| `https://api.agentmm.site/memory` | GET / POST / DELETE | key, content, tags, context | 读写/删除记忆 |

| `https://api.agentmm.site/memory/search` | POST | query, limit, threshold | 关键词搜索记忆 |

| `https://api.agentmm.site/memory/changes` | GET | since, limit, offset | 增量同步记忆变更 |

| `https://api.agentmm.site/memory/stats` | GET | — | 记忆库统计 |

| `https://api.agentmm.site/log` | POST | level, title, content, metadata | 写入日志 |

| `https://api.agentmm.site/log/list` | GET | level, category, task_id, since, limit | 查询日志 |

| `https://api.agentmm.site/log/stats` | GET | since | 日志统计 |

| `https://api.agentmm.site/me` | GET | — | 查询 Agent 信息 |

| `https://api.agentmm.site/server/time` | GET | — | 健康检查（无需认证）|

**不调用任何其他外部 URL。** 如果你的 `AGENTMM_API_BASE` 指向自部署实例，则请求会发往该地址而非上述默认地址。

---

Security & Privacy

---

Trust Statement

使用本技能即表示你同意将记忆和日志数据发送至 AgentMM 服务（`api.agentmm.site`）。请仅在你信任 AgentMM 服务提供方的情况下安装使用。如需自托管，将 `AGENTMM_API_BASE` 指向你自己的实例即可完全掌控数据去向。