Clawdbot 工具

Clawdbot 提供强大的代理工具,用于浏览器自动化、画布、节点、定时任务等。了解如何配置和使用 Clawdbot 工具。

Clawdbot 工具概述

Clawdbot 提供一流的代理工具,用于浏览器、画布、节点和定时任务。这些工具是类型化的,不需要 shell,代理可以直接依赖它们。

禁用工具

您可以通过 clawdbot.json 中的 tools.allow / tools.deny 全局允许/拒绝工具(deny 优先):

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

注意:

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

工具配置文件

tools.profiletools.allow / tools.deny 之前设置基本工具白名单。

配置文件包含的工具
minimalsession_status
codinggroup:fsgroup:runtimegroup:sessionsgroup:memoryimage
messaginggroup:messagingsessions_listsessions_historysessions_sendsession_status
full无限制(与未设置相同)

示例(默认仅消息):

{
  "tools": {
    "profile": "messaging",
    "allow": ["slack", "discord"]
  }
}

工具组

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

工具
group:runtimeexecbashprocess
group:fsreadwriteeditapply_patch
group:sessionssessions_listsessions_historysessions_sendsessions_spawnsession_status
group:memorymemory_searchmemory_get
group:webweb_searchweb_fetch
group:uibrowsercanvas
group:automationcrongateway
group:messagingmessage
group:nodesnodes

示例(仅允许文件工具 + 浏览器):

{
  "tools": {
    "allow": ["group:fs", "browser"]
  }
}

工具清单

核心工具

工具描述
apply_patch将统一差异补丁应用到文件
exec执行 shell 命令
process进程管理
web_search搜索网络
web_fetch获取网页
browser浏览器自动化
canvas用于视觉内容的画布
nodes节点设备命令
image图像处理
message发送消息
cron计划任务
gateway网关管理

会话工具

工具描述
sessions_list列出活动会话
sessions_history获取会话历史
sessions_send发送到会话
sessions_spawn生成新会话
session_status获取会话状态

提供商特定工具策略

使用 tools.byProvider 限制特定提供商的工具:

{
  "tools": {
    "profile": "coding",
    "byProvider": {
      "google-antigravity": {
        "profile": "minimal"
      }
    }
  }
}

插件 + 工具

插件可以注册核心集之外的额外工具。详情请参阅插件文档。

安全性

  • 工具以清晰的描述呈现给代理
  • 使用 tools.deny 阻止危险工具
  • 沙箱可用于不受信任的输入

下一步