当 AI Agent 遇到 Nacos：OpenClaw.NET 集成入门 - 张善友
内容提要
OpenClaw.NET 提出一种确定性 Agent 工具调用方案：不调用 LLM，而是通过 Nacos 3.2.4 AI 注册中心与 MCP Router 自动发现并调用 MCP 工具。开发者只需在 skill 中声明 capability_ref 意图，运行时负责解析、缓存、熔断、审计与授权，避免模型编造结果，成本可控、行为可审计。
延伸解读
确定性调用如何避免模型幻觉
文章指出，让大模型自行发现和调用工具时，每轮可能消耗上万个 input token，且结果不稳定。例如注册表描述为“天气”但后端只有时间工具时，模型可能编造气温。OpenClaw.NET 将发现、绑定、调用等动作做成不调用 LLM 的确定性管线，由运行时解析 capability_ref 意图，从而避免模型编造结果，并使成本可控、行为可审计。
Nacos AI Registry 的治理边界
Nacos 3.x 将 AI 资源提升为与配置管理、服务发现并列的核心能力。文章强调，AI 资源不是配置，也不是普通服务：配置管理关注内容发布与监听，服务发现关注实例健康，而 MCP Server 的治理重点是协议类型、端点、版本以及工具开关。管理员可在 Nacos 控制台关闭某个工具，运行时必须遵守，这为工具级治理提供了直接控制点。
缓存与熔断机制的实际影响
动态解析结果会缓存，TTL 300 秒、容量 1024、FIFO 驱逐，缓存键包含世代。Nacos 配置变更时世代加一，旧键失效，在途解析若发现世代变化会返回 capability_stale_binding 让调用方重试，避免静默使用旧绑定。同一目标连续失败 3 次触发熔断 30 秒，成功一次立即复位，被策略阻止的失败不计入。这些机制影响故障恢复和配置变更时的行为。
接入注意事项与验证步骤
文章提醒，Router 的 Console API client 默认连接 127.0.0.1:8080 且不可覆盖，本地验证时需将 Nacos Console 端口固定为 8080。接入时需准备 Nacos 3.2.4 并注册 MCP Server，安装 Router 后，在 skill 中声明 capability_ref 并选择动态或静态绑定。运行后应观察治理链日志，并在控制台关闭工具以验证运行时能否在数秒内失效并拒绝调用。
Q&A
OpenClaw.NET 集成 Nacos 的核心思路是什么？
OpenClaw.NET 提出一种确定性 Agent 工具调用方案：不调用 LLM，而是通过 Nacos 3.2.4 AI 注册中心与 MCP Router 自动发现并调用 MCP 工具。开发者只需在 skill 中声明 capability_ref 意图，运行时负责解析、缓存、熔断、审计与授权，避免模型编造结果，成本可控、行为可审计。
为什么不让大模型自己发现和调用 MCP 工具？
让大模型自己摸索的方式每轮要消耗上万个 input token，而且结果不稳定——如果注册表里的描述写着“天气”、后端实际只有时间工具，模型还可能直接编一个气温出来。OpenClaw.NET 的做法是把这串动作做成一条确定性管线，全程不调用 LLM。
Nacos 3.x 的 AI Registry 管理哪些资源？
Nacos 3.x 把 AI 资源提升为与配置管理、服务发现并列的核心能力，叫 AI Registry。它管的是：Skill、Agent、MCP Server、Prompt、AgentSpec 这些东西怎么注册进平台、怎么治理、怎么按版本发布、怎么被运行时发现。
OpenClaw.NET 中 Registry、Router 和 Runtime 的职责如何划分？
Registry 决定“存在什么、谁可见”，Router 决定“如何被发现和连接”，OpenClaw Runtime 决定“何时、以何身份、经何审批执行”。
开发者如何在 skill 中声明能力引用？
开发者只需在 skill 文件里声明一个能力引用，例如：- id: weather kind: tool_call capability_ref: provider: nacos binding: dynamic intent: task_description: "查询杭州今天天气" keywords: ["天气", "杭州"] tool_args: city: 杭州。解析和调用由 AgentRuntime / MafAgentRuntime 的同一条 capability 路径完成，没有 LLM 发现调用。
OpenClaw.NET 的缓存和熔断机制是怎样的？
动态解析结果会缓存（TTL 300 秒、容量 1024、FIFO 驱逐），缓存键里编入了世代（generation）：key = "{provider.Id}:{generation}:{binding}:{intentKey}"。Nacos 侧配置一变，世代 +1，旧键直接失效。同一目标（安全域 + provider + 世代 + Server + 工具）连续失败 3 次，熔断 30 秒；成功一次立即复位；被策略阻止（Blocked）的失败不计入。熔断器容量满时，冷却中的熔断器不会被驱逐，只淘汰尚未熔断的条目。
如何快速搭建 OpenClaw.NET 与 Nacos 的集成环境？
准备 Nacos 3.2.4，在 AI 管理中心注册你的 MCP Server（元数据、端点、版本、工具开关）；安装 Router（.NET global tool，不需要 Python 环境）：dotnet tool install --global NacosMcpRouter。注意：Router 的 Console API client 默认连 127.0.0.1:8080 且不可覆盖，本地验证时把 Nacos Console 端口固定为 8080；在 skill 文件中声明 capability_ref，按需选择 binding: dynamic（动态发现）或静态绑定（固定目标）；运行 Agent，观察治理链日志：能力解析、策略审批、工具调用、审计记录应一一对应，全程无 LLM 发现调用；验证治理行为：在 Nacos 控制台关闭某个工具，确认运行时在数秒内完成失效并拒绝后续调用。
