目录简介一、系统架构四层模块化设计二、Webhook 触发器事件驱动的入口三、审批门人机协作的安全阀四、工具执行运行时引擎五、频道适配器统一接口架构六、可观测性与结语简介以 Webhook 触发器、审批门、工具执行、频道通知四大核心机制为线索剖析一个生产级.NET AI Agent 网关的设计哲学与实现细节。TL;DROpenClaw.NET 是一个基于 .NET 9 构建的自托管 AI Agent 网关与运行时采用模块化分层架构支持 NativeAOT 编译。核心设计围绕四个技术支柱Webhook端点体系、内存审批门、工具执行运行时、9 个频道适配器。截至 2026 年 5 月项目在 GitHub 上获得351 stars代码量超过 10 万行。一、系统架构四层模块化设计OpenClaw.NET 采用分层网关模式将事件接收、策略控制、智能执行和消息分发四个关注点清晰分离。四个核心模块GatewayHTTP 端点、Core消息管道、Agent运行时、Channels频道适配器。关键技术选型.NET 9.0 System.Threading.Channels Microsoft.Extensions.AI NativeAOT。二、Webhook 触发器事件驱动的入口Gateway 注册了覆盖全部 9 个频道的专用 Webhook 端点提供两个通用端点/hooks/wake轻量通知和 /hooks/agent完整 Agent 执行。安全验证层每个频道适配器实现了协议原生的签名验证机制包括 Ed25519 公钥验证Discord、HMAC-SHA1Twilio、Bot Token 哈希校验Telegram等。幂等性保证WebhookDeliveryStore基于哈希的幂等性缓存默认 6 小时时间窗口解决重复投递问题。三、审批门人机协作的安全阀审批模型遵循」默认拒绝、渐进授权「的安全原则。通过 ToolActionPolicyResolver 判断操作是否为 mutation写操作只读工具自动通过。ToolApprovalService基于 ConcurrentDictionary TaskCompletionSource 实现将异步等待原语与并发集合结合实现零阻塞的审批等待。状态转换Pending → Approved / Denied / TimedOut支持 requester 匹配验证防止恶意用户干预他人审批流程。四、工具执行运行时引擎OpenClawToolExecutor支持并行工具调用执行流程遵循 Hook → Approval → Execute → Audit 四阶段管道。AgentRuntime 实现完整的 Agent 主循环包含熔断器CircuitBreaker保护下游 LLM 提供商配额。内置 48 个原生工具覆盖文件操作、会话与记忆、Web 交互、消息通信、家居自动化、数据库六大类别。五、频道适配器统一接口架构IChannelAdapter统一接口将 9 个异构通信平台抽象为一致契约支持推送模式Webhook和拉取模式WebSocket/Polling。三层安全控制DM 策略仅响应直接消息、允许列表白名单用户/频道、签名验证。发送端实现各频道协议原生优化Slack 转换为 mrkdwn 格式、Telegram自动分片超长消息、Email 支持 HTML/纯文本双格式。六、可观测性与结语OpenClaw.NET 的设计体现了五个核心理念默认安全、渐进授权、零信任签名、策略与执行分离、运行时防御。对于需要在私有环境中构建AI Agent 网关的团队OpenClaw.NET 提供了一个经过生产验证的架构参考其模块化设计允许按需裁剪——从轻量的 /hooks/wake 通知代理到全功能的 Agent 运行时都可以平滑演进。相关链接GitHub (github.com/clawdotnet/openclaw.net)引入地址