Agent Skills
返回列表
Agent Hub 节点接入

Agent Hub 节点接入

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5a1b85c9/agent-hub-join。

技能介绍

要解决什么问题

当你希望本地 OpenClaw Agent 接入 Agent Hub，由中心按能力画像下发任务、汇总结果时，手工拼注册 API、WebSocket identify 时序和心跳重连很容易漏步骤。Hub 靠 identify 才能把积压任务推过来；漏发或顺序不对，节点会「在线却收不到任务」。

技能如何工作

本技能在用户说出「加入 hub」「join hub」等指令后触发，并在每一步向 Hub 发数据或建长连接前先确认 Hub 地址与用户同意。

核心流程大致如下：

  1. 只读本机信息：用 exec 根据 hostname 生成 instanceId（格式 openclaw::<hostname>::default，非字母数字替换为 - 并小写），此阶段不向 Hub 发送数据。
  2. HTTP 注册：POST /api/agents/register，上报 instanceId、platform、已安装 skills、可用 tools；Hub 返回 assignedName 与 capabilities。
  3. WebSocket：连接 ws://<host>:<port>/ws，连接后立即发送 identify（含 instanceId、assignedName、platform、skills、tools）。
  4. 执行任务：收到 assign_task 后按 taskId 防重，执行后 POST /api/tasks/result 上报（默认超时 600 秒）。
  5. 心跳与兜底：session 内每 25 秒 POST /api/agents/heartbeat；404 时自动重新注册并重连。可选每 5 秒 GET /api/tasks/pending?agentId= 作 Poll 兜底。

边界与注意点

Hub 不预设任务类型白名单，路由依赖你注册时声明的能力；能执行什么、安全边界由 Agent 自行把控。心跳绑定当前 shell session，跨 session 持久化需用户明确要求后再用 openclaw cron add，不会改系统 crontab。

使用场景

  • 本地运行 OpenClaw，需要向 Hub 注册后接收 `assign_task` 并通过 `/api/tasks/result` 回传执行结果。
  • 新部署一台 Agent 工作机，要向 Hub 上报 `platform`、`skills`、`tools`，让任务按能力画像路由到本节点。
  • Hub 升级或重启导致心跳 404，需要自动重新 `register`、重连 WS 并再次发送 `identify` 恢复收单。
  • WebSocket 推送偶发不及时，希望在已发 `identify` 的前提下用 `GET /api/tasks/pending` 每 5 秒轮询兜底。

适合人员

  • 负责维护内网 OpenClaw 节点、要求上线即有 `assignedName` 并能稳定接 Hub 派单的运维工程师
  • 在本地 Shell 集成 Agent，想用「join hub」触发分步确认并完成注册与心跳的自动化集成开发者
  • 搭建多 Agent 调度链路，需要各节点如实声明 capabilities、由 Hub 按 strongAreas 路由任务的平台工程师
  • 对向 Hub 外传本机 `instanceId` 与 skills 清单敏感、坚持每步联网操作前必须用户点同意的安全负责人