代理利用本地库存

只读目录harness向 OpenClaw 控制面公开：本机模型行及其准备情况，以及进程内 MCP 运行时之外拥有的 MCP 工具清单。 Agent harness插件 参考的一部分。

原生模型库存

loadModelCatalog(params) 列出了所提供的代理、工作区和配置快照的模型。本机模型选择拥有的行将 nativeRuntime 设置为harness ID，并省略主机 api 和 baseUrl 声明。 Core 不会通过主机路由的传输或功能来丰富这些行。

返回 { entries, outcomes } 以报告行旁边的无秘密发现结果。结果使用提供者目录状态 ready、auth-rejected 和 unavailable；仅目录授权拒绝设置 rejectionScope: "catalog"。请勿包含原始本机错误或凭据数据。失败的提供者保留其先前的行，而成功的兄弟更新。空的成功结果（包括禁用或丢失的应用程序）会清除该运行时的早期结果。核心通过本机运行时保留这些事实，独立于 API-provider 身份验证。针对 2026.9.5 SDK 构建的插件仍然支持普通行数组。

意外抛出的发现错误会保留主机的通用部分故障行为。主机不会从运行时名称或任意异常文本推断提供者或身份验证拒绝；harness必须提供其自己已知的提供者结果。

可选的同步 readModelCatalogReadiness(params) 仅返回 { accountType: string } 用于覆盖该确切范围和模型的当前本机帐户观察。保留原生账户类型；它并不意味着主机凭据或 OAuth 刷新生命周期。对于缺失、失败、被取代或处置的观察结果，请返回 undefined。准备状态必须由实际的本地所有者保留，并在使用时重新验证；永远不要在目录行上序列化它，在此回调中执行 I/O，或者从之前成功的回合中推断它。网关将此元数据用于本机拥有的选择器行；编写的主机路由、凭据和配置文件锁仍使用主机就绪状态。这不是执行授权，所有运行时兼容性和权限检查仍然适用。

服务层选择器策略

可选的同步 filterModelServiceTiers 挂钩缩小了harness运行时显示的层：

filterModelServiceTiers(params: {  config: OpenClawConfig;  agentId?: string;  provider: string;  modelId: string;  serviceTiers: readonly string[];}): readonly string[];

对于选定的模型行和替代运行时选择，网关在解析帐户和路由服务层证据后调用此挂钩。提供的配置是准备好的目录的快照。解释harness中特定于插件的策略；核心不读取私有插件配置。

返回子集，而不改变输入或执行 I/O 或发现。核心将结果与已解析的层相交，保留它们的顺序并忽略添加的层。如果没有钩子，等级不会改变。未知层可用性仍然未知，并且不会调用挂钩。这仅影响选择器元数据；执行转弯时，harness仍必须执行其策略。

原生 MCP 库存

在 OpenClaw 的进程内 MCP 运行时之外拥有 MCP 连接的harness可以实现 loadMcpToolCatalog(params)。回调由只读控制界面（例如 Composer 工具访问视图）使用。它接收权威会话标识、运行时配置、工作区和稀疏会话 MCP 覆盖。 mcpServerNames 是 OpenClaw- 配置的服务器的有界集合，该harness可以代表其会话策略。仅返回该集合的 OpenClaw 的 McpToolCatalog 形状。

仅使用已绑定的本机进程和线程。返回undefined表示没有可用的实时目录；不要仅仅为了解决库存问题而启动新的harness流程。保留原始 server/tool 名称，使用 assignMcpCatalogSafeServerNames(...) 分配防冲突服务器名称，并保留仅因 sessionDeniedTools 中的会话拒绝而隐藏的工具。在公开行之前，Core 仍然应用最终的 OpenClaw 工具策略和架构兼容性检查。

物化工具视图使用的 SessionMcpRuntime 实现应提供 joinCleanup()。它等待该确切运行时已请求的清理，包括未发布或退役的服务器，并且如果任何拥有的清理失败或无法确认，则拒绝。它必须为后来的调用者保留该失败，而不关闭仍由另一次运行租用的传输。仅已完成的尽力而为 dispose() 并不是清理证据。

该方法对于现有的 SDK 实现是可选的；自动一次性恢复将丢失的方法视为不确定的清理。当其封闭的运行时单独拥有并验证进程生命周期时，不拥有传输的本机外观可能会立即解析。