Runtime Contract——员工身份与执行引擎解耦

为什么需要 Runtime Contract

2.2.0 之前，一个 Agent 的行为完全由它的执行循环决定——ReAct 就一定是 Native 引擎跑的 Plan-and-Execute。如果有人想把某个 Agent 委托给外部推理引擎（比如 DeepSeek Harness），就得在 Agent 层做适配。

Runtime Contract 的核心想法是：把 Agent 拆成两层——上层是「员工身份」（名字、prompt、工具权限、记忆），下层是「执行引擎」（怎么跑推理循环）。两个层通过一份标准契约解耦。

谁在跑推理循环

当前支持两种 Runtime：

• Native：MateClaw 自己的 StateGraph 引擎，ReAct 或 Plan-and-Execute 循环
• DeepSeek Harness：外部推理引擎，Agent 委托过去跑

同一个 Agent 可以在不同 Runtime 上跑，会话、工作空间、工具治理、流式投影是共用的——外部循环仍在 MateClaw 的权限与审计边界内运行。

好处

• 你想用某个厂商特别擅长推理的引擎来跑特定 Agent？现在可以。
• 不同 Agent 可以用不同 Runtime，切换成本为零。
• 新 Runtime 的接入只需要实现契约接口，不用改 Agent 核心逻辑。

对用户来说意味着什么

你不太需要关心 Runtime 这个层——它是架构内部的解耦。但如果以后 MateClaw 推出更多 Runtime（比如某个开源推理框架），你不用改 Agent 配置就能切换过去。

当前版本的 Runtime 配置入口在 Agent 编辑器里，以官方最新版为准。