实践openclaw-concepts

Agent runtimes · OpenClaw — 一文讲清OpenClaw中agent runtime与provider、mode

一文讲清OpenClaw中agent runtime与provider、model的分层关系

2026-06-29原文

本文为要点摘要，完整细节以原文为准。

🧭 一图看懂

由原文自动提炼 · 以原文为准

点击任一分支，查看这一点的一句话解读

OpenClaw 的 Agent Runtime 分层

Provider 管认证与模型发现，Model 是选中的模型，Runtime 是执行循环，Channel 是消息出入口
- Provider 例：anthropic、openai…
- Runtime 例：claude-cli、codex、copilot…
- Channel 例：Discord、Slack、Telegram

STEP 1接收 prompt

STEP 2驱动模型输出

STEP 3处理原生工具调用

STEP 4返回完成回合给 OpenClaw

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。
- 设计含义：提供细粒度控制，同时保留自动回退，避免配置遗漏导致执行失败。

原文：Agent runtimes · OpenClaw

还没吃透？把这篇丢给 AI 助手，让它结合你的场景讲清楚。