文档/Agent
工具系统
Agent 的核心能力不在于回答问题,而在于使用工具。XClaw 内置了一套文件系统和代码操作工具,同时通过 MCP 协议支持无限扩展。
内置工具覆盖了最常见的开发操作:读取和编辑文件、执行 Shell 命令、搜索代码库(Glob 和 Grep)、浏览目录结构。这些工具的设计目标是让 Agent 像一个有终端权限的开发者一样工作。
工具调用是 Agent 推理过程的一部分。当 Agent 决定需要某个工具时,它会生成一个结构化的工具调用请求。在确认模式下,你会看到这个请求的完整内容——要执行什么命令、要写什么文件——然后决定是否允许。
XClaw 对工具的处理做了几个关键优化:工具调用支持批量执行(多个不相关的操作可以并行)、支持错误恢复(一个工具失败不会中断整个流程)、以及自动重试(暂时性错误会自动重试)。
通过 MCP 连接的外部工具在 Agent 看来和内置工具没有区别。Agent 会根据对话上下文自主判断何时使用哪个工具,不需要你手动指定。
操作指引
内置工具开箱即用,不需要任何配置。你在会话中给 Agent 一个任务,它会自动选择合适的工具——比如让它"看看这个文件的内容",它会用读取文件工具;让它"找出所有包含 TODO 的文件",它会用 Grep 搜索。
想看看 Agent 目前有哪些工具可用?在会话界面中,点击输入框附近的工具图标可以展开工具列表,查看所有内置工具和已连接 MCP 服务器暴露的工具。
在确认模式下,Agent 每次调用工具前都会展示详细信息:将执行的命令、将写入的文件内容等。你可以审查后选择批准或拒绝。如果你经常批准某类操作,考虑切换到自动模式来提高效率。
想扩展 Agent 的工具能力?前往设置 > MCP 连接,添加新的 MCP 服务器即可。新增的工具会立即出现在 Agent 的可用工具列表中。