agentmemory 的 REST 接口是其主要访问面（MCP 只是构建在其上的桥接层）。每个记忆操作都在 http://localhost:3111/agentmemory/* 下提供 HTTP 端点。
用途：通过 HTTP 直接与 agentmemory 记忆服务器交互，适用于 MCP 不可用或需要以 HTTP 方式调用的场景。
主要能力与用法：启动检查可调用 GET /agentmemory/livez（公开，无需鉴权）。保存记忆使用 POST /agentmemory/remember，请求体包含 content、concepts 等字段。检索使用 POST /agentmemory/smart-search，请求体包含 query、limit 等字段。示例：
curl -fsS http://localhost:3111/agentmemory/livez
curl -fsS -X POST http://localhost:3111/agentmemory/remember
-H "Authorization: Bearer $agentmemory_secret"
-H "Content-Type: application/json"
-d '{"content":"chose JWT refresh rotation","concepts":["jwt-refresh-rotation"]}'
curl -fsS -X POST http://localhost:3111/agentmemory/smart-search
-H "Authorization: Bearer $agentmemory_secret"
-H "Content-Type: application/json"
-d '{"query":"auth token strategy","limit":5}'
鉴权：除 liveness 公开外，其余受保护端点默认需要 Bearer 鉴权，包括本地 localhost 访问。可使用环境变量 AGENTMEMORY_SECRET，或读取本地生成的密钥文件（如 $HOME/.agentmemory/secret），注意不要打印密钥值或开启 shell 调试。远程守护进程须为该端点使用显式凭据并启用 HTTPS；不要转发本地文件密钥，也不要跟随已鉴权的重定向到其他主机。
约定：保存返回 201，读取返回 200，校验错误返回 400。仅使用文档化字段，成功响应不代表未支持的字段已被应用。端口可通过 --port 或 --instance 配置，流、查看器和引擎都据此派生。
限制与说明：完整的端点与方法列表见 REFERENCE.md（由 src/triggers/api.ts 生成），本文未提供完整清单；故障排查参见 TROUBLESHOOTING.md。MCP 等价能力见 agentmemory-mcp-tools，端口与密钥配置见 agentmemory-config。