openclaw/plugin-sdk/channel-ingress-runtime。
运行时解析器
结果
内置插件应直接使用现代投影:
事件授权仍可通过有序的
ingress.graph 和起决定作用的 ingress.reasonCode 获取;不会生成单独的事件投影。
已弃用的第三方 SDK 辅助函数可以在内部重新构建旧结构。新的内置接收路径不应将现代结果转换回本地 DTO。
访问组
accessGroup:<name> 条目保持脱敏。核心会自行解析静态 message.senders 组,并且仅对需要平台查询的动态组调用 resolveAccessGroupMembership。缺失、不受支持和解析失败的组均采用故障关闭策略。
事件模式
表情回应、按钮、回调和原生命令使用
mayPair: false。
路由和激活
对房间、主题、公会、线程或嵌套路由策略使用路由描述符:channelIngressRoutes(...);它会过滤已禁用的分支,同时保持路由事实的通用性,并按照每个描述符的 precedence 排序。
提及门控是一种激活门控。提及未命中时返回 admission: "skip",因此轮次内核不会处理仅观察的轮次。大多数渠道应将激活门控置于发送者门控和命令门控之后。对于必须在发送者允许列表产生干扰之前抑制未提及流量的公共聊天界面,可以在禁用文本命令绕过时选择启用 activation.order: "before-sender"。对于具有隐式激活的渠道(例如 Bot 线程中的回复),应使用 resolveChannelImplicitMentions(...) 解析 channels.defaults.implicitMentions 以及渠道和账户覆盖,然后将结果作为 activation.implicitMentions 传递。投影的 activationAccess.shouldBypassMention 会报告命令或隐式激活何时绕过了显式提及。