OpenClaw.NET 是一个 NativeAOT 友好的 AI Agent 运行时与网关项目，为 .NET 平台提供本地或自托管的 AI Agent 网关解决方案。项目支持 OpenAI 兼容的 HTTP 接口、原生工具执行、多频道消息适配，以及从零源码编译到 NativeAOT 原生二进制的完整构建路径。

GitHub：https://github.com/clawdotnet/openclaw.net

文档：https://agentqi.dev

协议：MIT | 目标框架：.NET 10 | 语言版本：C# 14

项目概述

OpenClaw.NET 面向需要本地或自托管 AI Agent 网关的 .NET 开发者和运维人员，提供完整的诊断能力、原生 .NET 工具集、OpenAI 兼容的 HTTP 接口，以及从源码到 NativeAOT 发布产物的编译链路。

该项目与原始 OpenClaw 项目无官方关联，是一个独立的 .NET 实现，受 OpenClaw 工作启发而开发。文档与生态站点已迁移至 agentqi.dev。

核心能力

NativeAOT 编译

项目基于 .NET 10（C# 14），在 Directory.Build.props 中配置了 TrimMode=link 裁剪模式，支持将运行时和网关编译为原生可执行文件。该方案具有以下特点：

• 无需额外安装 .NET SDK 或运行时
• 启动时间以毫秒计
• 内存占用低于 JIT 模式
• 部署时仅需分发单个二进制文件

项目为 Windows x64、macOS Apple Silicon、Linux x64 三个平台提供预编译的桌面捆绑包。

Agent 运行时

底层 Agent 运行时引擎提供以下能力：

• 工具执行与流式输出
• 请求取消与重试机制
• 记忆（Memory）与会话管理
• 与 Microsoft Agent Framework 集成（通过 Runtime.Orchestrator=maf 配置）
• 通过工作流后端（如 maf-durable-http）实现持久化委托
• 支持 Agent-to-Agent（A2A）通信协议
• MemPalace.NET 可选记忆提供器（时序知识图谱）

Gateway 网关层

网关层提供面向运维和管理的 HTTP 服务接口：

• 聊天 UI
  
  内置 Web 聊天界面
• 管理 UI
  
  配置、监控与诊断面板
• OpenAI 兼容端点
  
  兼容 OpenAI API 协议的客户端可直接对接
• MCP 协议
  
  支持 Model Context Protocol
• A2A 协议
  
  支持 Agent-to-Agent 通信
• Canvas/A2UI
  
  可视化工作区支持
• WebSocket
  
  实时流式通信
• 健康检查与诊断
  
  生产环境可观测性支持

48 种原生工具

项目内置 48 个原生 .NET 工具，覆盖以下领域：

9 个频道适配器

项目提供 9 种消息渠道的接入能力，每种均具备 DM 策略、白名单与签名验证：

原生 LLM 支持

项目内置以下 LLM 提供器的原生支持：

• OpenAI（GPT-4o 等）
• Claude（Anthropic）
• Gemini（Google）
• Azure OpenAI
• Ollama（本地模型）
• OpenAI 兼容端点（任何遵循 OpenAI 协议的服务）

插件生态

项目通过 PluginKit 模块支持插件扩展，同时兼容 OpenClaw 生态中现有的 TS/JS 插件与 SKILL.md 技能包。

架构概览

项目采用模块化设计，源码目录结构如下：

src/├── OpenClaw.Agent                        # Agent 核心运行时├── OpenClaw.Channels                     # 频道适配器├── OpenClaw.Gateway                      # HTTP 网关（聊天 UI、管理 UI）├── OpenClaw.Core                         # 核心基础设施├── OpenClaw.PluginKit                    # 插件框架├── OpenClaw.Companion                    # 桌面配套工具├── OpenClaw.Cli                          # 命令行工具├── OpenClaw.Tui                          # 终端 UI├── OpenClaw.Client                       # 客户端模块├── OpenClaw.MicrosoftAgentFrameworkAdapter  # MAF 适配器├── OpenClaw.SemanticKernelAdapter        # Semantic Kernel 适配器├── OpenClaw.Providers.MicrosoftExtensionsAI # Microsoft.Extensions.AI 提供器├── OpenClaw.Plugins.Mempalace            # MemPalace 内存插件├── OpenClaw.Plugins.Payment              # 支付插件├── OpenClaw.Payments.*                   # 支付模块（Abstractions、Core、StripeLink）├── OpenClawNet.Sandbox.OpenSandbox       # 沙箱环境├── OpenClaw.WhatsApp.BaileysWorker       # WhatsApp Baileys Worker├── OpenClaw.Testing                      # 测试基础设施└── OpenClaw.Tests / TestPluginFixtures   # 单元测试与插件夹具

项目共包含 26 个子模块（含两个独立的 WhatsApp Worker 实现、测试基础设施与插件模块），每个模块职责明确，可独立引用。

桌面端快速上手

项目为以下三个平台提供桌面捆绑包：

每个捆绑包包含 Companion（配套管理界面）、NativeAOT 网关和 NativeAOT CLI。使用流程为：解压存档 → 从 companion 目录启动 Companion → 在 Setup 选项卡中选择提供器并配置密钥 → 点击启动。

Companion 会生成配置文件并自动启动捆绑的网关。

Docker 部署

项目提供 docker-compose.yml 文件，支持通过 Docker Compose 进行部署：

services:openclaw:image:openclaw.net:localports:-"18789:18789"environment:-MODEL_PROVIDER_KEY=your-key-OPENCLAW_AUTH_TOKEN=your-tokenvolumes:-openclaw-memory:/app/memoryhealthcheck:test: ["CMD", "/app/OpenClaw.Gateway", "--health-check"]

项目同时附带 Caddy 反向代理配置（deploy/Caddyfile），可通过 with-tls profile 启用自动 TLS 证书管理。

适用场景

• 个人开发者
  
  本地运行 AI Agent，对接多个 LLM 提供器
• 团队运维
  
  自托管网关，统一管理 Agent 的工具调用与消息频道
• 企业集成
  
  通过频道适配器将 Agent 接入 Telegram、Teams、Slack 等企业通讯平台
• 智能家居
  
  集成 Home Assistant，通过自然语言控制家居设备
• 支付集成
  
  内置 Stripe 支持，Agent 可处理支付流程
  

注意事项

项目为独立的 .NET 实现，与 OpenClaw 原始项目无官方关联或授权关系。文档站点已迁移至 agentqi.dev，AgentQiX 为可能的未来运行时身份。

NativeAOT 编译使用 TrimMode=link 激进裁剪策略，部分依赖反射的功能可能需要额外配置反射保留策略。

项目默认启用 UrlSafety 策略，阻止出站请求访问本地回环、私有网络、多播和元数据主机，防止 SSRF 攻击。管理员可根据环境需要调整该策略。

总结

OpenClaw.NET 为 .NET 平台提供了一套完整的 AI Agent 网关解决方案，涵盖 Agent 运行时、HTTP 网关层、多频道消息适配、原生工具集与插件扩展。

项目采用 MIT 协议，基于 .NET 10 与 C# 14 构建，支持三平台原生编译部署与 Docker Compose 容器化运行。对于需要在 .NET 生态中实现自托管 AI Agent 网关的团队而言，该项目提供了一个可参考的技术选项。