工具监控
追踪 Agent 使用的每个工具，评估风险等级，在故障蔓延之前发现问题。
/tools概述#
工具监控提供所有 OpenClaw Agent 可用工具的完整清单。每个工具都标注了风险分类、使用统计和失败次数，让你一目了然地掌握 Agent 工具链的全貌。
工具监控不仅是资产清单，更是主动的风险管理手段。工具会根据其能力和潜在影响自动分类风险等级（严重、高、中、低）。文件写入器、Shell 执行器等高风险工具会被重点标记，便于你在问题发生之前审查和管控。
前置条件#
OpenClaw 侧配置#
工具发现使用 tools.catalog RPC，这是一个按 Agent 调用的方法。ClawButler 遍历每个已同步的 Agent，使用其 external_id 调用 tools.catalog 获取该 Agent 的完整工具列表。
工具在 OpenClaw 配置中的各 Agent 工具部分定义。关于工具发现的要点：
- -每个 Agent 有独立的工具集——tools.catalog 需要 agentId 参数，仅返回该 Agent 可用的工具
- -工具从 agents.defaults 继承——如果工具在 defaults 中定义，所有未覆盖该配置的 Agent 都能使用
- -工具元数据包含名称、描述和参数模式——ClawButler 据此推导风险分类
使用反馈#
同步后，工具监控显示：
- -按 Agent 分组的工具列表，包含工具名称、描述和风险分类徽章（严重 / 高 / 中 / 低）
- -使用统计，包括每个工具的总调用次数和失败次数
- -风险分布概览，显示各风险等级的工具数量
- -工具资产台账支持幂等更新——重复同步不会创建重复记录
Web 端操作#
工具监控页面位于侧边栏的「生产力」分组中，展示所有 Agent 工具的统一视图。
工具清单
按 Agent 分组列出所有工具。每个工具显示名称、描述和颜色编码的风险分类徽章。高风险工具（如文件写入器、Shell 执行器、具有写权限的 API 调用器）会被突出显示，只读工具被归类为低风险。
风险评估
每个工具根据其能力被分配风险等级：严重（系统级访问、不可逆操作）、高（文件写入、外部 API 变更）、中（大范围数据读取）、低（只读、限定范围查询）。风险因素包括参数类型、访问范围，以及工具是否能修改外部状态。
工具监控概览
页面顶部的汇总统计：已发现工具总数、风险分布（各等级的工具数量）、所有工具的总失败次数、以及配置了工具的 Agent 数量。
刷新
点击刷新按钮从 OpenClaw 重新同步工具目录。这会对每个 Agent 触发 tools.catalog RPC 调用，并更新本地工具资产台账。刷新操作是幂等的——已有工具就地更新，新工具被添加，已移除的工具被标记为不活跃。
移动端操作#
工具监控位于移动端的「更多」标签页中。功能包括：
- -可滚动的工具列表，带颜色编码的风险等级指示器
- -点击任意工具查看完整详情：描述、风险分类、使用次数和失败历史
- -下拉刷新，从服务器重新同步工具数据