AgentMesh Runtime 是一层完全本地、开源的 agent 运行时脚手架：跨会话的持久情景记忆、有界 OODA 循环记录、崩溃后干净拾起的能力。装好之后，智能仍然来自你的 agent（Claude Code / OpenClaw / Codex / Hermes / 自定义）——这层脚手架只在底下做记忆、记录、恢复这些脏活。不需账户、不上云、免费、Apache 2.0 开源。
$ git clone https://github.com/jiyangnan/AgentMesh-Runtime.git && cd AgentMesh-Runtime $ uv sync $ uv run agentmesh-runtime doctor # 自检：Neo4j / SQLite / ledger / checkpoint # 让你的 agent 调用（看 AGENTS.md）： $ uv run agentmesh-runtime memory recall "your query" --top-k 5 $ uv run agentmesh-runtime memory ingest-file ./session.jsonl discord $ uv run agentmesh-runtime rehydrate --write-default --print-path # 重启后捡起
会话一结束、进程一重启、上下文一爆，昨天讨论过的决策、踩过的坑、失败过的尝试，全部归零。
AgentMesh Runtime 把记忆、循环记录、断点恢复这层底层脏活做掉，让你的 agent 跨天跨次依然延续——而具体怎么想、怎么决定，仍然在它自己的脑子里。
不夸大，不画饼。下面列的是代码里真的实现了、能跑的能力。决策智能继续来自你的 agent，这层只做底下的事。
Neo4j 图召回、SQLite FTS5（BM25 + snippet）、原始文件 grep、可选 Gemini 向量——四层 failover，任一后端挂了其余继续服务。会话事件、决策、教训都能跨次召回。
Observe / Orient / Decide / Act / Verify / Record 状态机，把每一步落到持久轨迹。真正的决策由 agent 给——脚手架只确保步骤被执行、过程被记录、不偏离纪律。
SQLite ↔ Neo4j 延迟同步账本、checkpoint 存储、rehydrate 一键命令——重启后立刻重建"我刚才到哪了"，注入新会话开干。
doctor 给出 JSON 健康报告；规则式 blind_retry / phantom_progress / pivot_exhaustion 反模式提醒——是计数器加阈值，不是魔法。
不绑死任何一家。任何能调用本地 CLI 或 Python 包的 agent / 自定义脚本，都能驱动这层脚手架。
把 agentmesh-runtime 当工具命令调；可写 skill 自动加载。
本产品的发源地，路径默认就指向 OpenClaw 的运行时目录。
通过 shell 调用 CLI 或包装成 MCP 工具；与 Codex CLI 完全兼容。
任何能跑 Python 子进程的脚本都能驱动；env 改路径就接好。
没有云端 worker、没有托管数据库、没有付费 API。装好这三样，脚手架就能在本机跑。uv sync 会处理 Python 这边；其余手动装。
包管理用 uv，对齐 AgentMesh 生态。uv sync 一行装好所有依赖。
图后端走 docker：docker compose -f docker/docker-compose.neo4j.yml up。挂了不影响——SQLite + 文件 grep 会接住。
语义召回需要 GEMINI_API_KEY，你自己注册。不配也能跑——只是没向量这一路。
整个仓库的设计是让 agent 调用，不是给你一行行手敲。你只负责装上 + 告诉 agent 怎么用，剩下的让它跑。
git clone 仓库后 uv sync，得到 agentmesh-runtime / amr 命令；先跑一次 doctor 看环境是绿的。
看 GitHub →
仓库根目录的 AGENTS.md 是写给 agent 看的——什么时候 recall、什么时候 ingest、什么时候 rehydrate，以及什么话不能对人类许诺。整段贴给你的 Claude Code / OpenClaw / Codex / Hermes 就行。
看 AGENTS.md →
新任务前 agent 自己 recall 历史决策、任务后 ingest 沉淀经验、重启后 rehydrate 捡回状态。你这边只看输出，不必接触底层。
GEMINI_API_KEY。decide 和 verify 步骤是有意做小的状态机存根——它们记录你做了什么，但不替你想下一步。真正的推理由你的 agent 出，这层只确保步骤被走完、记录被写下、不偏离纪律。~/.openclaw/* 是历史原因，把 ARS_SESSION_BASE 和 ARS_MEMORY_DB 改成你自己 agent 的路径即可。Claude Code / Codex / Hermes / 任何自定义 agent 都能驱动。chunks_fts MATCH ? 是正经的 FTS5 表查询，已经撤回（见 决策文档的 errata）。