使用手册 · 系统

基础设施

在统一面板中监控联邦节点、边缘代理和部署健康状况。

/infrastructure

概述#

基础设施页面整合了系统级关注点：联邦节点管理、边缘代理监控和整体部署健康。当你需要确认 ClawButler 实例与远程节点的连接状态，以及所有边缘代理是否正常上报时，这里是首选入口。

联邦功能通过 A2A（Agent 间通信）协议实现跨实例的 Agent 协作。每个节点通过 remote_peer_id 和 outbound_secret 注册，调用可以通过配置的路由规则进行入站或出站传输。

前置条件#

前置条件
  • 已部署并运行的 ClawButler 实例
  • 至少配置了一个联邦节点或边缘代理（以获得完整功能）

使用反馈#

配置完成后，基础设施页面显示：

  • -联邦节点列表，包含连接状态、最近心跳和调用次数
  • -边缘代理状态面板，显示已连接的代理、运行时间和隧道健康状况
  • -服务健康概览，每个组件显示绿色/橙色/红色指示器

Web 端操作#

基础设施页面分为三个区域，通过侧边栏访问：

联邦节点

查看所有已注册节点的 remote_peer_id、连接状态和最近心跳时间。通过提供远程实例 URL 和 outbound_secret 添加新节点。每个节点显示入站和出站 A2A 调用日志。

边缘代理状态

列出所有通过 WSS 隧道连接的边缘代理。每条记录显示代理主机名、运行时间、最近同步时间和隧道健康状况。断开连接的代理以红色高亮显示。

服务健康

统一的健康仪表板，显示 API、数据库、Valkey 缓存和已连接网关的状态。每个组件显示绿色/橙色/红色指示器和响应延迟。

CLI 端操作#

检查整体基础设施状态，包括服务、节点和边缘代理

Terminal
$ ap infrastructure status

列出联邦节点及其连接状态

常见问题#

问：什么是联邦？
答：联邦允许多个 ClawButler 实例通过相互路由 A2A（Agent 间通信）调用来协作。每个实例将对方注册为节点并共享密钥，从而实现跨实例的 Agent 通信。
问：如何添加联邦节点？
答：进入「基础设施」>「联邦节点」，点击「添加节点」。提供远程实例 URL 和 outbound_secret。远程实例也必须将你的实例注册为节点，才能实现双向通信。
问：边缘代理和连接器有什么区别？
答：连接器是一个配置项，告诉 ClawButler 如何连接 OpenClaw 网关（URL、凭据）。边缘代理是一个轻量级进程，运行在网关旁边，通过持久的 WSS 隧道连接到 ClawButler Cloud，实现实时同步和成本数据传输。
基础设施 — ClawButler 用户手册