本页内容
本页内容
插件 SDK 参考
Agent 执行器插件
agent 执行器 是一个已准备好的 OpenClaw agent 回合的底层执行器。它不是模型提供方,不是通道,也不是工具注册表。关于面向用户的心智模型,请参见 Agent 运行时。
仅将此表面用于捆绑或受信任的本机插件。该合约仍处于实验阶段,因为参数类型有意反映当前嵌入式运行器。排除仅核心辅助运行控件:侧聊天的直接工具和选定会话读取限制是内部行为,不支持插件harness输入。
何时使用 harness
当某个模型家族拥有自己的原生会话运行时,而常规的 OpenClaw provider 传输不是合适的抽象时,请注册一个 agent harness:
- 一个拥有线程和压缩能力的原生编程代理服务器
- a 本地 CLI 或必须流式传输本机 plan/reasoning/tool 事件的守护程序
- a 模型运行时除了 OpenClaw 会话记录之外还需要自己的简历 ID
not 是否注册harness只是为了添加新的 LLM API。对于普通的 HTTP 或 WebSocket 模型 API,构建一个 provider 插件 。
各部分移动的地方
单页版本的每个部分现在都位于此页面或下面的八个子页面之一上。单页版本中的锚点仍然在这里解析。
核心所有权合约
Agent harness核心所有权 — 在 runAttempt 之前核心准备什么,以及harness可以声明的工具策略、身份验证引导、会话所有权和请求传输合同。
harness注册
注册代理工具 — AgentHarnessV2 注册示例,以及可选的隔离完成和委托执行功能。
harness选择和提供商配对
代理harness选择策略 — OpenClaw 在提供程序和模型解析后如何选择harness,以及为什么harness通常附带提供程序插件。
尝试运行时助手
代理利用尝试运行时 — 受保护的输入注入、工具结果中间件、终端结果分类、实时令牌使用和代理端副作用。
用户输入及执行权限
Agent 利用用户输入和执行权限 — 阻止用户输入界面、主机工具功能、执行审核者结果和配对设备命令权限。
原生库存
Agent harness本机库存 — 从harness自身的运行时报告的只读本机模型行和 MCP 工具目录。
运行时配置
Agent 利用运行时配置 — 本机 Codex 利用模式和严格的提供程序、模型或每个代理运行时策略。
会话和结果
Agent 利用会话和结果 — 本机会话绑定和转录镜像,以及工具、媒体、终端结果和固定回合结果。
当前限制
- 公共导入路径是通用的,但某些 attempt/result 类型别名仍保留旧名称以兼容。
- 第三方 harness 安装处于实验阶段。除非你需要原生会话运行时, 否则优先使用提供方插件。
- 支持在不同轮次之间切换 harness。不要在一轮中途,在原生工具、审批、助手文本或消息发送已经开始后切换 harness。