工具(Tools)

工具(Tools)

适用范围

Clawdbot 为智能体提供一组类型化工具(browser/canvas/nodes/exec/web/cron/…)供其调用。工具策略让你能够决定模型被允许做什么,可以全局配置,也可以按智能体/提供商配置。

工具策略(允许/拒绝)

你可以通过配置中的 tools.allowtools.deny 来允许/拒绝工具(拒绝优先):

{
  tools: { deny: ["browser"] }
}

注意事项:

  • 匹配不区分大小写。
  • 支持 * 通配符("*" 表示"所有工具")。

工具配置文件(基础允许列表)

tools.profile 设置一个基线允许列表,然后 allow/deny 进一步细化它。常见模式:

{ tools: { profile: "coding", deny: ["group:runtime"] } }

工具组(简写)

策略条目支持 group:* 名称,可扩展为多个工具:

  • group:runtimeexecprocess、…)
  • group:fsreadwriteeditapply_patch
  • group:webweb_searchweb_fetch
  • group:uibrowsercanvas
  • group:nodesnodes

插件、技能和工具

插件可以添加新工具(有时还有 CLI 命令)。技能主要为模型提示提供使用指导。

  • 插件:/docs/plugin/
  • 技能:/docs/tools/skills/

常用工具文档

  • exec:/docs/tools/exec/
  • Exec 审批:/docs/tools/exec-approvals/
  • apply_patch:/docs/tools/apply-patch/
  • Web 工具:/docs/tools/web/
  • Browser 工具:/docs/tools/browser/
  • 技能配置:/docs/tools/skills-config/
  • 创建技能:/docs/tools/creating-skills/

延伸阅读

  • 源路径:tools/index.md