Statewave — Memory Runtime for AI Agents (API + SDKs)

简介

把零散的 Agent 历史变成结构化可搜索的记忆：episodes → 编译 memories → 为 prompt 组装排序好的上下文包。

最适合： 需要“持久记忆”的 Agent 产品：不止聊天记录（客服/编码/多渠道助手等）

适配： 自托管 API（默认 localhost:8100）；Python/TypeScript SDK；模块化 connectors（见 README）

配置时间： 15–30 分钟

关键事实（已验证）

• README Quick start 把 API 跑在 8100 端口，并提供 /docs、/redoc（Swagger/ReDoc）。
• README API 表包含 POST /v1/episodes、POST /v1/memories/compile、GET /v1/memories/search 等接口。
• README 说明 connectors 是独立模块（npm 包），按需安装（GitHub/Slack/Markdown 等）。
• GitHub：214 stars · 1 forks；最近更新 2026-05-11（GitHub API 验证）。

正文

更实用的记忆工作流建议：

1. 以 append-only 的方式写入 episodes（事件/决策/提交/事故），保持单条小而清晰、带时间戳。
2. 按计划（或阈值）编译 memories，保证检索速度与确定性。
3. 语义搜索用于“相似问题复用”，但要让系统可审计：输出对应 episode ID。
4. 给 prompt 组装 token 有上限的 context bundle，而不是把原始历史全倒进去。

Statewave 的 API-first 形态更适合多渠道集成，不用每个工具重复造“记忆轮子”。

FAQ

需要 GPU 吗？ 答：不需要。README 写明 API 进程是 CPU-only；只有你自托管模型/编译器时才会涉及 GPU。

有鉴权吗？ 答：可选。README 提到可通过 X-API-Key 头启用 API key。

不装 connectors 也能用吗？ 答：能。README 写明 connectors 在独立仓库，按需安装，且都走同一套公共 HTTP API。