快速开始
Agent runtime architecture
OpenClaw 拥有内置的智能体运行时。运行时代码位于 src/agents/ 下，模型/提供商传输代码位于 src/llm/ 下，面向插件的契约通过 openclaw/plugin-sdk/* barrel 导出。
运行时布局
| 路径 | 负责范围 |
|---|---|
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 加载、提示词模板、Skills、主题以及由 TUI 支持的工具渲染器（tools/）。 |
packages/agent-core/ |
可复用的智能体核心（@openclaw/agent-core）：Agent loop、harness 类型、消息、压缩辅助函数、提示词模板、Skills 和会话存储契约。 |
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/）。 |
边界
核心通过 OpenClaw 模块和 SDK barrel 调用内置运行时；不再保留任何外部智能体框架包。插件使用有文档说明的 openclaw/plugin-sdk/* 入口点，不导入 src/** 内部实现。
@earendil-works/pi-tui 仍是第三方依赖项：它是本地 TUI 和会话工具渲染器使用的终端组件工具包。将其内部化需要另行开展依赖内置工作。
清单
资源包在 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。 - 插件 harness 会注册其他运行时 ID（例如
codex）。 - 运行时策略是模型/提供商作用域的
agentRuntime.id配置（模型条目优先于提供商条目）。未设置或设为default时解析为auto。 auto会选择支持有效提供商路由的已注册插件 harness，否则选择内置 OpenClaw 运行时。仅凭提供商或模型前缀绝不会选择 harness。- 仅当路由恰好为官方 HTTPS Platform Responses 或 ChatGPT Responses 路由，并且没有主动设置的请求覆盖时，OpenAI 才能隐式选择
codex。Completions 适配器、自定义端点以及包含主动设置请求行为的路由仍使用openclaw；官方明文 HTTP 端点会被拒绝。请参阅 OpenAI 隐式智能体运行时。
相关内容
Was this useful?
