Claw 节点管理
Claw 节点管理
概述
Claw 节点管理页面实时展示所有连接到工作空间的节点 —— 包括每一台已启动的桌面 APP、每一个在线的 Web 浏览器会话。管理员可以监控节点状态、查看能力声明和筛选节点。
节点是什么？ 在工作空间的分布式架构中，每一个能"做事"的端点都叫节点：桌面 APP 是 Agent 类型节点（可以执行任务），浏览器 Web 会话是 Human 类型节点（可以发起但不能执行）。详见 多节点架构。
实时节点列表
节点列表通过 WebSocket 实时更新，无需手动刷新。页面提供 刷新 按钮（带 loading 状态）和连接状态指示器。
表格列
| 列 | 说明 |
|---|---|
| 节点名称 | 节点的自定义名称（如 Workspace (liujishideMacBook-Air.local)）+ 下方显示 nodeId |
| 账户邮箱 | 节点所属用户的邮箱 |
| 节点类型 | Human / Agent / Action / Monitor（彩色徽章） |
| 节点归属 | 账号（个人） / 企业（enterprise） |
| 平台 | 操作系统标签（macOS / Windows / Linux / Web） |
| 能力 | 节点声明的能力文本（最多 2 行，悬停可展开） |
| 工具 | 节点注册的工具数量（悬停显示完整列表） |
| 接入时间 | 节点连接到 Gateway 的时间戳 |
节点类型
| 类型 | 颜色 | 说明 |
|---|---|---|
| Human | 蓝色 | Web 端用户节点，无 Agent 执行能力，能力包含 SEND_MESSAGE、TAKEOVER、FEEDBACK 等 |
| Agent | 绿色 | APP 端 Agent 节点，完整执行能力，能力包含 OS:xxx、CPU:xxx 等系统信息 |
| Action | 橙色 | 自动化执行节点（无人值守） |
| Monitor | 灰色 | 监控节点 |
节点归属
| 归属 | 可见范围 | 说明 |
|---|---|---|
| 账号（account） | 仅同一 userId 可见 | 个人账户级节点，跨组织可用 |
| 企业（enterprise） | 同一 orgId 所有成员可见 | 企业级节点，组织内共享，可被同组织其他成员远程调用 |
筛选器
| 筛选项 | 说明 |
|---|---|
| 搜索名称或 ID | 按显示名或 nodeId 过滤 |
| 节点类型 | 下拉选择 Human / Agent / Action / Monitor |
| 节点归属 | 下拉选择 账号 / 企业 |
| 平台 | 动态从当前数据提取的平台选项 |
与多节点架构的关系
此页面展示的是 Gateway 已注册的在线节点。当用户在 Claw 中发起对话时，Gateway 会根据智能路由策略从这些节点中选择最合适的执行节点。
路由优先级：
- LLM 语义路由：根据用户消息意图匹配最合适的节点
- BM25 关键词匹配：降级方案，基于节点描述关键词
- 最近连接兜底：选择最近上线的节点
操作指南
查看在线节点
- 打开 Web 端 → 空间管理 → Claw
- 节点列表自动加载（WebSocket 实时连接）
- 使用顶部筛选器过滤节点
- 悬停"工具"列查看节点注册的完整工具列表
如何理解表格信息
| 你看到的信息 | 含义 |
|---|---|
| 类型 = Agent | 这是一个 APP 节点，有完整的 AI Agent 执行能力 |
| 类型 = Human | 这是一个 Web 浏览器节点，只能发起对话不能执行 |
| 归属 = 账号 | 个人节点，只有节点所有者能用 |
| 归属 = 企业 | 企业节点，组织内所有成员可用 |
| 工具 = 20 个工具 | 该节点注册了 20 个工具（通常 19 项内置 + 若干 MCP） |
| 接入时间 | 节点上线的时间，越近说明越活跃 |
提示：如果 Web 端对话提示"无可用节点"，来这里检查是否有 Agent 类型的节点在线。如果只有 Human 节点，说明还没有桌面 APP 在线。
相关文档
- 多节点架构 — 节点发现、路由与远程执行
- 运行时安全 — 节点 — 节点安全配置