实践openclaw-concepts
Agent runtimes · OpenClaw — 一文讲清OpenClaw中agent runtime与provider、mode
一文讲清OpenClaw中agent runtime与provider、model的分层关系
2026-06-29原文
本文为要点摘要，完整细节以原文为准。
- Runtime与provider是不同层：provider负责认证与模型发现，runtime负责执行模型循环。配置时用
agentRuntime.id在provider或model条目中指定，旧的全agent runtime键已被忽略。- 设计含义：将执行层与模型选择层解耦，允许同一模型通过不同runtime（如openclaw、codex、claude-cli）运行，灵活切换后端。
- 两种runtime家族：Embedded harness（如openclaw、codex插件）在OpenClaw的agent循环内运行；CLI backend（如claude-cli）启动本地CLI进程，但保持模型引用规范。
- 设计含义：支持轻量内嵌与重量级外部进程两种执行模式，适应不同场景（内嵌低延迟、CLI复用现有工具链）。
- Runtime选择优先级：model级runtime策略 > provider级 > auto模式（注册插件可声明支持的provider/model对），无匹配时回退到openclaw。
- 设计含义：提供细粒度控制，同时保留自动回退，避免配置遗漏导致执行失败。