代理运行时架构

OpenClaw 拥有内置代理运行时。运行时代码位于 src/agents/ 下，模型/提供方传输位于 src/llm/ 下，面向插件的契约通过 openclaw/plugin-sdk/* 的入口文件导出。

运行时布局

路径	负责内容
`src/agents/embedded-agent-runner/`	内置尝试循环（`run.ts`、`run/`）、模型选择与提供方规范化（`model.ts`）、按提供方的请求参数（`extra-params.`）、压缩、转写以及会话连接。
`src/agents/sessions/`	会话持久化（`session-manager.ts`）、资源发现（`package-manager.ts`、`resource-loader.ts`）、会话内 `extensions` 加载、提示模板、技能、主题，以及由 TUI 支持的工具渲染器（`tools/`）。
`packages/agent-core/`	可复用的 agent 核心（`@openclaw/agent-core`）：agent 循环、harness 类型、消息、压缩辅助、提示模板、技能，以及会话存储契约。
`src/agents/runtime/`	OpenClaw 外观层，将 `@openclaw/agent-core` 连接到插件 SDK LLM 运行时，并重新导出它及本地代理工具。
`src/agents/agent-tools*.ts`	由 OpenClaw 管理的工具定义、参数 schema、工具策略、工具调用前/后适配器，以及主机/沙箱编辑工具。
`src/agents/agent-hooks/`	内置运行时钩子：压缩保护措施、压缩说明、上下文修剪。
`src/agents/harness/`	内置和由插件注册的 harness 的注册表、选择策略与生命周期。
`src/llm/`	模型/提供方注册表、传输辅助工具，以及提供方特定的流式实现（`src/llm/providers/`）。

边界

Core 通过 OpenClaw 模块和 SDK barrel 调用内置运行时；不再保留任何外部代理框架包。插件使用已文档化的 openclaw/plugin-sdk/* 入口点，不会导入 src/** 内部实现。 @earendil-works/pi-tui 仍然是一个第三方依赖：它是本地 TUI 和会话工具渲染器使用的终端组件工具包。将其内化将是单独的 vendor 化工作。

清单

资源包在 package.json 元数据中声明 OpenClaw 资源。条目是相对于包根目录的文件路径或 glob：

{
  "openclaw": {
    "extensions": ["extensions/index.ts"],
    "skills": ["skills/*.md"],
    "prompts": ["prompts/*.md"],
    "themes": ["themes/*.json"]
  }
}

清单中未列出的资源类型会回退到发现约定的 extensions/、skills/、prompts/ 和 themes/ 目录。

运行时选择

内置运行时 ID 是 openclaw。旧别名 pi 会规范化为 openclaw；codex-app-server 会规范化为 codex。
插件宿主会注册额外的运行时 ID（例如 codex）。
运行时策略是按模型/提供商作用域的 agentRuntime.id 配置（模型条目优先于提供商条目）。未设置或 default 会解析为 auto。
auto 会选择一个支持有效提供商路由的已注册插件宿主，否则使用内置 OpenClaw 运行时。仅提供商或模型前缀本身绝不会选择宿主。
OpenAI 仅在精确的官方 HTTPS Platform Responses 或 ChatGPT Responses 路由且没有自定义请求覆盖时，才可能隐式选择 codex。Completions 适配器、自定义端点，以及带有自定义请求行为的路由都会保持在 openclaw；纯文本官方 HTTP 端点会被拒绝。参见 OpenAI 隐式代理运行时。

模型运行时代

Gateway 的启动以及配置、插件或认证发布，会为每个已配置的 agent 构建一个预备的模型运行时代。每个运行时代都拥有已发现的认证模板、模型注册表以及投影后的模型目录，作为一个原子快照。Agent 运行会从该快照分叉出可变的认证和注册表存储；browse、status、cron、doctor、TUI、PDF 和 image 路径读取已发布的目录，而不是重复进行文件系统发现。独立的嵌入式运行时在其激活边界发布相同形状的快照。失败或过期的运行时代绝不会与更新的部分运行时代同时提供；生命周期所有者必须先发布一个完整的替代版本。

CLI 命令

RPC 与 API

Codex 运行框架

插件参考

插件 SDK 参考

插件维护者参考

模板

技术参考

概念内部机制

项目

贡献

运行时布局

边界

清单

运行时选择

模型运行时代

相关

​运行时布局

​边界

​清单

​运行时选择

​模型运行时代

​相关

运行时布局

边界

清单

运行时选择

模型运行时代

相关