原生提供者
原生提供商的工厂形式注册,以及节点本地 Computer Use 提供商接口。属于 插件入口点 参考的一部分。
原生提供商工厂¶
registerSpeechProvider、registerRealtimeTranscriptionProvider 和
registerRealtimeVoiceProvider 接受完整的提供商描述符,或接收
PluginCapabilityCatalogContext 的同步工厂:
register(api) {
api.registerRealtimeTranscriptionProvider((context) =>
buildRealtimeTranscriptionProvider(context),
);
}
对完整注册和可选的能力目录使用同一个由插件拥有的工厂。宿主提供原生认证、请求和传输操作;构造描述符时不应加载执行 SDK 桶文件、读取凭据或启动会话。将这些工作保留在描述符的方法中。工厂必须同步返回;抛出错误或返回 Promise 都会导致注册失败。
完整注册可以在工厂闭包中绑定自己的 broker 或 logger。不要用仅目录的描述符替换需要这些绑定的描述符。完整插件注册仍然拥有 harnesses、hooks、services 和生命周期回调;仅目录条目不会建立运行时就绪状态。
对象注册仍然受支持。在发布使用工厂参数的插件之前,将其 compat.pluginApi 下限设置为支持这些参数的宿主版本;较低的 minHostVersion 不会覆盖该 API 要求。
Computer Use 提供商¶
导入: openclaw/plugin-sdk/computer-use
节点本地 Computer Use 插件通过
registerComputerUseProvider(api, provider) 注册一个提供商。该辅助函数负责
screen.snapshot 和危险的 computer.act 命令注册以及匹配的 Gateway 调用策略;提供商负责可用性、执行、序列化、帧状态、驱动生命周期和清理。
capabilities() 是同步声明式读取。请避免在其中进行驱动获取和原生可用性探测:Gateway 工具发现会在准备桌面之前读取它。在已注册提供商的生命周期内保持其提供商代际稳定;与执行相关的帧代际仍由驱动拥有。使用 prepare、isAvailable 和 openExecution 处理运行时就绪和资源所有权。
同一入口点导出这两个命令负载和快照结果的规范 TypeBox 模式、静态类型和已编译验证器。节点宿主仅接受命令对的一个提供商;注册另一个提供商会与现有命令注册冲突,而不是创建回退栈。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw